Files and folders¶
GreatNPC separates server-wide definitions from world-local state. Relative paths below start at the Minecraft instance/server directory unless explicitly marked as world paths.
Configuration root¶
config/greatnpc/
├── settings.json
├── trainer_preset/
├── trainer_team/
├── item_presets/
├── preset_renames.json
├── backups/
└── validate.txt
| Path | Contents |
|---|---|
settings.json |
Global mod settings. Its property names are camelCase; see Settings. |
trainer_preset/ |
JSON trainer presets: identity, battle rules, appearance, interactions and team references. Subfolders organize categories. |
trainer_team/ |
JSON arrays of Pokémon definitions used by trainer presets. |
item_presets/ |
Saved snapshots referenced by the reusable preset items. Keep these files when moving those items to another instance. |
preset_renames.json |
Recorded category/path renames, used to reconcile old trainer IDs with new paths. |
backups/ |
Copies created by supported editor/preset operations. This is not a complete world or database backup. |
validate.txt |
Report produced by the validation command. It is generated output, not a settings file. |
Folders and files are created when the corresponding operation needs them. A fresh installation does not necessarily contain every path listed here. Settings defaults work even before a saved settings.json exists.
The real folder names are trainer_preset and trainer_team, not trainers and teams. A preset and a team are distinct definitions. Keep the referenced team present when moving or renaming preset files.
Trainer IDs use paths relative to their definition folders without .json. For example, trainer_preset/village/guide.json corresponds to the default-namespace ID cobblemontrainerbattle:village/guide. The namespace is retained for compatibility; it does not mean the definition belongs in a different mod's configuration folder.
World state¶
Inside the active world's save directory:
greatnpc/
├── battle_history/
│ └── <player-uuid>.json
├── interaction_state/
│ └── <player-uuid>.json
├── trade_restock.json
└── locations.json
These files hold player battle counters, interaction/button/trade uses, rotating shop stock and known NPC locations. Actual NPC entities and their saved variables also belong to the Minecraft world; copying only config/greatnpc/ does not move placed NPCs.
Storage explains the optional MySQL battle-history backend and what remains world-local.
Logs and language resources¶
Battle result logs are separate from saved gameplay counters:
Normal diagnostics use logs/latest.log.
Translations belong in resource packs under assets/greatnpc/lang/<locale>.json; they do not belong in config/greatnpc/. Old lang.conf, messages.json and data left by removed features can remain on disk but are not automatically converted or deleted by the current build. Keep a backup before cleaning historical files.
Reload behavior¶
With autoReload enabled, GreatNPC watches JSON changes under its configuration root and debounces them before reloading trainer definitions and syncing loaded NPCs. This does not reload client resource packs, and it is not a promise that every global setting is hot-loaded from disk.
Use the server settings GUI for supported live settings changes, or restart after manually editing settings.json. Reload language resources on the client with F3+T and reopen existing screens.