Improve monster whitelist & blacklist docs

[xuvatilavv]

Summary

None

Purpose of change

Addresses the documentation tag on #30851. Related to #55189.
MONSTER_WHITELIST is currently undocumented.

Describe the solution

Add documentation. Also cleans up a couple related areas.

Describe alternatives you've considered

None

Testing

• A healthy amount of reading the code
• For each of the mods in testing whitelists & blacklists.zip
  1. Create a world and join with a random character
  2. Teleport to a memorable intersection in a city, observe the monster types present
  3. Teleport away
  4. Debug time forward by adding a zero to the end
  5. Teleport back to the same intersection, observe the monster types present

Additional context

Whitelist/blacklist precedence is in MonsterGroupManager::monster_is_blacklisted()

Swapped out the No Ants examples since it's no longer a core mod.

The linked issues suggest that the evolution code doesn't check whether a monster is blacklisted. I was not able to reproduce that but this doc at least represents what the feature is supposed to do.

[Night-Pryanik]

Could you please add info on what will happen if you define MONSTER_WHITELIST without MONSTER_BLACKLIST and without "mode": "EXCLUSIVE"?

[xuvatilavv]

Could you please add info on what will happen if you define MONSTER_WHITELIST without MONSTER_BLACKLIST and without "mode": "EXCLUSIVE"?

You got it. I've tested it a bunch and made some changes, and I'll have another PR coming up in a bit to make the code match the docs. Turns out species wasn't properly accounted for in exclusive whitelists.

Also made some revisions because the GROUP_* IDs from data/json/monstergroups/ that No Fungal Monsters is using aren't what blacklists & whitelists check, they only use the categories tag from monster definitions. I'll have an issue up for that too.

In my testing I haven't been able to reproduce the evolution problem from the two issues I linked, but I expect it's a combination of the species issue I'm patching and category inheritance for evolutions being unintuitive/incomplete.