Troubleshooting

Symptom	Cause	Fix
/hunt unknown for players	Missing from CommandWhitelist or no hunt.base	Add both
A matching Pokemon does not count	Caught before the hunt, caught by someone else, or one requirement fails	/hunt debug <slot> shows each check
One difficulty button does nothing	Its icon item is banned by BanItem	Change the icon in lang.json
A button shows as white glass	Bad icon id	Check it with /hunt debug item <id>
Paid but labelled wrong in the economy dashboards	The tag command must run before the payout	Keep beforePayout as shown
NoSuchMethodError on the first catch	Built against a different Pixelmon	Rebuild against the server's Pixelmon

Boot lines worth checking: Capture listener registered on Pixelmon.EVENT_BUS, and Indexed <n> Pixelmon spawn entries into <n> obtainable species/form targets.