Command reference¶
/greatnpc is the full administration root. /gnpc redirects to the same command tree. Examples below use /gnpc.
<argument> means a required value; [argument] means an optional value. Do not type angle or square brackets. A trainer ID is a preset path such as tutorial/brock; the fully qualified form is cobblemontrainerbattle:tutorial/brock. Command booleans are the literal values true and false.
Configuration and diagnostics¶
| Command | Purpose | Permission |
|---|---|---|
/gnpc reload |
Reload trainer files and resynchronize loaded NPCs following their presets. | greatnpc.reload |
/gnpc reload force |
Reload and force resynchronization, including edited NPCs. | greatnpc.reload |
/gnpc autoreload <true\|false> |
Enable/disable watching trainer configuration files. | greatnpc.reload |
/gnpc list |
List loaded trainer IDs. | greatnpc.list |
/gnpc info |
Describe the trainer NPC you are looking at within 8 blocks, including its entity UUID. | greatnpc.info |
/gnpc info <trainer> |
Describe one trainer preset without requiring a looked-at entity. | greatnpc.info |
/gnpc validate |
Check preset/team configuration and write the full report to config/greatnpc/validate.txt. |
greatnpc.validate |
/gnpc debug <true\|false> |
Toggle the shared debug setting for server and connected mod clients. | greatnpc.debug |
/gnpc config |
Open Main Config. Requires the mod on the player's client. | greatnpc.config |
reload force reapplies configuration to NPCs with per-NPC edits; use it when that is the intended outcome. Unloaded entities are not all forced into memory by reload: their normal load path handles synchronization.
NPC creation and administration¶
| Command | Purpose | Permission |
|---|---|---|
/gnpc spawn <trainer> |
Spawn a trainer from a loaded preset at your position; npc_kind controls its model family. |
greatnpc.spawn |
/gnpc spawn pokemon <species> <trainer> |
Spawn a Pokémon-shaped NPC using the selected trainer preset and appearance species. | greatnpc.spawn |
/gnpc edit |
Open the editor for the trainer NPC you are looking at within 8 blocks. | greatnpc.edit |
/gnpc presets |
Open the preset manager; a looked-at NPC supplies its context when available. | greatnpc.edit |
/gnpc export <folder/name> |
Export the looked-at NPC as preset/team files and make it follow the saved preset. | greatnpc.export |
/gnpc export <folder/name> overwrite |
Allow replacing existing export files. | greatnpc.export |
/gnpc test |
Start a test battle with the looked-at trainer within 8 blocks. | greatnpc.test |
/gnpc where <trainer> |
List matching NPCs in loaded chunks, with locations. | greatnpc.where |
/gnpc tp <trainer> |
Teleport to a matching loaded NPC. | greatnpc.tp |
/gnpc sethome |
Set the looked-at NPC's current position as its home. | greatnpc.sethome |
/gnpc remove |
Remove the looked-at trainer NPC. | greatnpc.remove |
Creation, looked-at operations, editor GUIs, test, and teleport require an in-game player as the command source. Commands such as list, validate, and info <trainer> can also be useful from the server console.
Export names use lowercase letters, digits, underscores, and hyphens, with / separating folders. For example:
A test battle bypasses normal progression restrictions and does not run normal result rewards/history. It is not a substitute for checking a regular player challenge.
Battle history and resets¶
| Command | Purpose | Permission |
|---|---|---|
/gnpc history <player> [trainer] |
Show battle history for an online player, optionally limited to one trainer. | greatnpc.history |
/gnpc reset <player> <trainer\|folder/\|all> |
Remove matching battle-history records, including counters, cooldown, and attempt state. | greatnpc.reset |
/gnpc resetfirst <player> <trainer\|folder/\|all> |
Reset matching victory counters to zero while retaining other history fields. | greatnpc.reset |
/gnpc resetbattle <npc_uuid> <player> |
Re-enable one player's used one-battle attempt for the trainer resolved from that NPC UUID. | greatnpc.reset |
For history, reset, and resetfirst, the target is an online player name or player selector. resetbattle uses a game-profile argument and accepts one profile, including an offline player the server can resolve. It does not require the executing command source to be that player.
Get the actual NPC UUID from /gnpc info. If the entity cannot be found, load its chunk and try again. resetbattle preserves victory count, defeat count, and cooldown: other rematch restrictions may still apply.
/gnpc history Alex tutorial/brock
/gnpc resetbattle 123e4567-e89b-12d3-a456-426614174000 Alex
/gnpc resetfirst Alex gyms/
/gnpc reset Alex all
Progression is indexed by player UUID and trainer ID, so resetting via one entity can affect other NPCs using that same trainer ID. Resets do not remove old battle-log events.
Migration¶
All migration commands below require greatnpc.migrate.
| Command | Purpose |
|---|---|
/gnpc migrate report |
Count GreatNPC and legacy trainer entities in loaded chunks, including missing presets. |
/gnpc migrate entities dry-run |
Preview conversion of legacy trainer entities. |
/gnpc migrate entities |
Convert supported loaded legacy battle-trainer entities. |
/gnpc migrate entities include-static |
Also convert legacy static_trainer entities. This is a real conversion. |
/gnpc migrate history |
Import legacy .dat battle-history records from the current world. |
/gnpc migrate auto <true\|false> |
Toggle automatic legacy trainer conversion on entity load. |
/gnpc migrate easynpc dry-run |
Count supported Easy NPC humanoid/Pokémon entities without converting them. |
/gnpc migrate easynpc dump |
Write Easy NPC diagnostic NBT dumps and perform a dry run. |
/gnpc migrate easynpc |
Convert supported Easy NPC entities in loaded chunks. |
/gnpc migrate easynpc humanoid [dry-run] |
Limit Easy NPC migration to humanoids. |
/gnpc migrate easynpc pokemon [dry-run] |
Limit Easy NPC migration to Pokémon models. |
The current command tree does not expose a combined entities include-static dry-run branch. Read the migration guide before a real conversion.
Player trainer menu¶
| Command | Behavior |
|---|---|
/trainers |
Open the trainer menu when the client supports it; otherwise show the first chat-list page. |
/trainers list |
Show the first chat-list page. |
/trainers <page> |
Show a chat-list page, starting at 1. |
/treinadores |
Compatibility alias for the menu/root behavior. |
/treinadores lista |
Compatibility equivalent of /trainers list. |
/treinadores <page> |
Compatibility equivalent of /trainers <page>. |
These require greatnpc.trainers, granted by default. The chat list shows defeated trainers visible to the player, ten per page. Menu teleport buttons additionally require greatnpc.menu.teleport.
Repair stuck Pokémon mechanics¶
/mecanicdebug inspects the executing player's party and PC for detected stuck Mega/Dynamax/Tera-related transformation state and attempts to remove it. It can clear persistent mechanic feature flags as part of the repair; use it to repair affected Pokémon, not as a normal battle setting. It requires greatnpc.mecanicdebug, currently granted by default, and an in-game player source.
For normal logging, use /gnpc debug true; the similarly named repair command performs a different operation.