Trainer menu and tracking¶
/trainers opens the custom trainer menu when the GreatNPC client channel is available. Otherwise, it falls back to a chat list of trainers the player has defeated.
Menu and chat commands¶
/trainers list explicitly requests the chat list. A positive number selects a page of that list, with 10 defeated trainers per page. Page 2 is not the second GUI category.
The command checks greatnpc.trainers, available by default through the permission API. Portuguese command aliases remain for compatibility; the English commands above are the documented interface.
Which trainers appear?¶
The custom menu uses loaded trainer presets, not every arbitrary NPC entity. An entry appears when:
- Its trainer is enabled.
menu_visibleis true.- The player meets the entry's menu visibility permission, if configured.
- The player meets any server-wide visibility permission for its menu category.
An egg-created character with local settings may not appear as a reusable trainer entry. Export/configure a preset for trainers you want to publish.
Menu visibility and battle access are separate. A visible trainer can still be locked, restricted, or completed. Hiding it from the menu does not replace actual battle permission/tag checks.
Status and filters¶
| Status | Meaning |
|---|---|
| Available | No menu-level access, prerequisite, attempt-limit, or victory-cooldown block was found |
| Cooldown | The victory-based rematch timer is running |
| Completed/done | An attempt/victory limit blocks another encounter |
| Permission required | A battle permission or player-tag rule blocks the encounter |
| Locked | Prerequisite trainers have not been defeated |
Wins/losses and missing prerequisites are shown where applicable. Available does not guarantee that the current player party is healthy, large enough, or compliant with every species/level rule. The battle service checks those requirements on actual interaction.
Search matches trainer name or ID. Categories group the list; the type filter distinguishes humanoid/Pokémon entries when shown. Availability filtering and ordering help players find repeat encounters. Reopen the menu after changing server configuration or progression rules to request fresh data.
Configure an entry¶
| JSON field | Purpose |
|---|---|
menu_visible |
Publish/hide the trainer |
menu_category |
Custom grouping label |
menu_permission |
Permission needed to see this trainer |
menu_icon |
Item ID for the entry icon |
menu_description |
Description displayed in the menu |
Example property fragment:
{
"menu_visible": true,
"menu_category": "Town Trainers",
"menu_permission": "",
"menu_icon": "minecraft:compass",
"menu_description": "A beginner-friendly trainer in the town square."
}
This fragment does not define a team or enable a trainer by itself. Apply it inside a valid preset, or use the corresponding Menu fields in the editor.
If menu_category is empty, the menu derives a category from the preset's folder path, or uses General for a preset in the root folder. A preset folder and an explicitly chosen menu category are not the same setting.
Track a trainer¶
Use an entry's tracking action to choose its nearest known location. The location lookup prefers your current dimension when possible. The server records the NPC's home when available, so a wandering character is normally tracked to its home rather than followed continuously along its walking route.
Tracking shows an arrow and horizontal distance in the action bar. From another dimension, it reports the target dimension instead. Reaching within about 6 horizontal blocks clears the target and shows an arrival message. Use Stop Tracking in the menu to cancel it manually.
Tracking needs known saved NPC locations. A preset can exist without a placed/recorded NPC, and stale/missing location data can prevent useful guidance. The tracker does not create NPCs, force chunks to remain loaded, or open portals.
Optional teleport¶
The menu teleport action requires greatnpc.menu.teleport, denied by default. Grant it deliberately if menu travel is allowed. Do not assume operator status grants a permission whose fallback is false.
Teleport uses a known trainer location and dimension, placing the player near that destination. It is distinct from ordinary tracking and the administrative /gnpc tp command. No known location means no usable destination.
These location/tracking features do not implement Xaero's minimap skin-head icons. That remains a separate, currently unimplemented integration.