Skip to content

Troubleshooting

Include the exact GreatNPC, Cobblemon, Minecraft and Fabric versions when reporting a problem. The development build has been compiled against Cobblemon 1.8.4 for Minecraft 1.21.1; compilation alone does not certify every visual behavior or compatibility combination.

Text is still in English, Portuguese, or shows a key

  1. Check that the resource pack is enabled on the affected client.
  2. Check the file path: assets/greatnpc/lang/<locale>.json.
  3. Confirm Minecraft is using that locale and that your key exists in the current mod's en_us.json.
  4. Validate JSON syntax, reload resources with F3+T, and reopen the screen.
  5. Preserve %1$s and other positional arguments.

Old lang.conf overrides are not loaded. Administrator-authored NPC pages and labels are custom content, so they are not automatically replaced by translating built-in UI keys. If an untranslatable built-in phrase remains, report its screen/action and exact text.

The shop does not open

Install GreatNPC on the client as well as the server. Check that the NPC's mode is trade and that its offer list is not empty. A shop opened by an action also needs an offer list.

If an offer cannot be purchased, inspect its conditions, both costs, per-player use limit and current rotating stock. Component-based costs can require more than an item ID. Invalid item IDs and malformed reward components prevent payment. The server also rejects purchases made too far from the NPC.

For command rewards, test the command directly. A command error does not roll back already charged payment.

A battle will not start

Check the trainer is enabled, has a valid team, and accepts the player under its permission, tag, prerequisite, one-battle, victory-limit and cooldown settings. Confirm enough party Pokémon can battle in the chosen format. A Pokémon in the party is not necessarily healthy enough to battle.

The trainer may already be fighting or reserved by another player's battle introduction. Introductory screens do not bypass battle requirements: the server rechecks access and party eligibility before creating the battle.

Cooldown starts after a player victory, not after a loss. The one-battle-per-player option is a separate attempt limit and can be consumed by starting a battle. Use the documented reset command when you intend to restore that attempt; do not assume that changing the cooldown clears it.

Inspecting the battle log

Result records are written to:

logs/greatnpc/battles/YYYY-MM-DD.jsonl

The date is UTC. Each line is a JSON object containing the result timestamp, player UUID/name, NPC UUID, trainer ID, result and NPC location. The result is from the player's perspective.

This is a result audit trail, not a complete turn-by-turn battle replay. It does not currently guarantee entries for every abort, disconnect or forced battle termination. MySQL battle history and its counters are separate from these log files.

Skins, Pokémon animation and previews

If an NPC loses its skin/model after moving, record whether you used the Move Wand or position fields, its skin source, body model and whether it recovered later. The build contains a fix for Cobblemon's shared-aspect collection during variable updates; external skin sources can also have their own loading delays.

If a Pokémon keeps walking while stationary, include its species, configured pose and movement mode, especially wander. A locomotion-pose fix has been implemented, but species/model combinations still need in-game verification.

For incorrect shop previews, include a screenshot and the NPC's pose/body-part settings. Do not infer that a successful build proves that posed previews render correctly.

The inventory picker no longer renders the parent screen a second time, which previously reapplied blur. If blur persists over the items, include your GUI scale, shader/render mods and a screenshot.

Features that are not implemented here

The current code does not establish a complete Xaero minimap head integration, or the requested victory smoke/despawn plus cooldown hologram/respawn system. Do not look for a working configuration option for those features in this build.

Coins and gold/silver keys are inventory items, not a built-in wallet or automatic lock system. Their roles are defined by your NPC conditions, trades and commands.

Data and diagnostics

Back up your world and configuration before manual data edits. World-local data includes greatnpc/battle_history/, greatnpc/trade_restock.json and interaction usage state. MySQL-backed battle history has its own persistence path; an empty saved history is marked to avoid reimporting old local counters after an intentional reset.

Use /gnpc debug true only while collecting relevant diagnostics, then /gnpc debug false. Include the applicable part of logs/latest.log, the NPC/preset configuration and exact reproduction steps. Logs may contain player names, UUIDs and configured commands; review them before publishing a report.

Suggestions and bug reports

Have a suggestion or need to report a bug? Join our Discord and share it with us. For bug reports, include your mod versions, what happened, what you expected, and steps to reproduce the issue.