🐛 Reporting bugs & ideas

Found a bug, or have an idea? Post it in the Discord — that is the whole process. You do not need a GitHub account. A bot turns your post into a tracked issue, replies in your thread with what it needs from you, and posts back there when it is closed.

One page for all four mods: the process is identical, and the mod-specific detail is in the tabs below.

1. You open a post in the mod's tickets thread and pick a tag.
2. The bot reads it within ~10 minutes and files a tracked issue, labelled from your tag.
3. The bot replies in your thread saying what it still needs from you, if anything.
4. shiero fixes it in a release.
5. The bot posts back in your thread when the issue closes. 🎉

Pick the right tag

The tag you choose decides how the report is handled — and what the bot asks you for. It is the one thing worth getting right.

Tag	Use it when	What the bot does
🚨 Crash	the game closes, freezes or fails to start	jumps the queue; asks for the crash report
🐛 Bug	something works, but wrong	asks for versions, loader and steps
💡 Idea	you want something that does not exist yet	files it as a feature request — no logs needed
💬 Feedback	an impression, a balance opinion, a "this felt off"	recorded; nothing else needed from you

What makes a great report

• What you did, what you expected, and what happened instead.
• The mod version, your loader (Fabric or NeoForge), and whether you are on a modpack.
• If the game crashed: attach crash-reports/crash-*.txt, or logs/latest.log if there is no crash report. The stack trace is what turns a hunt into a fix.
• A screenshot or a short clip, if it is something you can see.

A report that gets fixed fast

Placing a picnic table underwater near coral crashes the client. MC 1.21.1, Cobblemon 1.7.3, Picnic 1.26.0, Fabric. Happens every time; crash report attached.

Extra detail, per mod

RoutesNuzlocke & Soul LinkPicnicDitto HMsRaid IconsChampions Training

• Where it happened: the zone name the mod showed you — a route, an area, a town, or the Wild.
• Whether the world was generated with this version of Routes or an older one, since roads are baked in at worldgen.
• For map problems: which map mod (Xaero's Minimap, World Map, JourneyMap) and its version.

• Which rule misbehaved: one catch per zone, permadeath, nicknames, shiny clause, level caps, or a Soul Link pairing.
• Where you were: the zone name the mod showed you.

• For Soul Link: how many players were linked, and what each was doing at the time.

• Your Routes version as well as the Nuzlocke one — this mod is an add-on and the two move together.

Zone problems are usually Routes problems

"One catch per zone" is defined against Routes' zone model — the routes, areas and towns it generates are the capture zones. If the zone itself looks wrong (missing, badly shaped, oddly named), that is a Routes report, not a Nuzlocke one.

• Whether it was the re-roll, the social side (benches, shiny aura, care) or the trainer battles.
• What was around the table: biome, other spawners, and whether a modpack tuned the spawn rules.
• For furniture or model issues, which other furniture mods are installed.

• Which HM, and whether it was used as an active ability or a toggle.
• Whether you had learned it from a disc or via /dittohm learn_all.

Hunger and cooldowns are configurable

Before reporting "this HM costs too much", check Configuration — every ability's hunger cost, cooldown and power is a server-side slider, so a modpack may have tuned it away from the defaults.

Suggesting a new HM? Those are the most common request, and plenty of the ones that shipped started that way. The ones that get built fastest describe: the Pokémon move it is based on, what it should do in Minecraft, and whether it feels like an active (press to use, costs hunger) or a toggle (passive, blocks part of your hunger bar).

• The output of /raidicons while aiming at the den that is misbehaving. It carries almost everything a report on this mod needs, and it goes to logs/latest.log too.
• Which Xaero mods you have — the minimap, the world map, or both — and their versions.
• Your Cobblemon Raid Dens version. The mod reads that mod's blocks by name, so a den it stops recognising is usually a Raid Dens update.

Icons fill in as you walk

The mod only sees dens in chunks your client has already been sent. A map that is not covered in markers after teleporting somewhere new is working correctly, not failing.

• The output of /champions sp <slot> for the Pokémon involved. It shows whether the Pokémon is in training, its stat points, effort values and IVs, and its final stats.
• What you pressed — Save, Train, Load, Store or Delete — and on which page of the summary.
• Whether the server changed any settings: /champions config lists them all.

Stats look wrong?

A stat point is +1 to the stat at any level, applied before the nature. Compare with the numbers on Stat Points before reporting a formula bug.

What happens next

Your post becomes an issue labelled from its tag, and the bot replies in the thread so you know it landed. When the issue is closed, it posts back there — saying whether it was fixed or closed without a change, because those are not the same thing and you deserve to know which.

Everyone who reports gets thanked on the mod's community credits page: Routes · Nuzlocke · Picnic · Ditto HMs · Raid Icons · Champions Training. 💚