NPCs¶
GreatNPC uses Cobblemon NPC entities for two visual types: humanoid characters and Pokémon characters. Both can use the interaction, dialogue, trading, trainer battle, movement, and preset systems. Choosing a Pokémon appearance does not turn the NPC into a catchable wild Pokémon.
Choose a creation workflow¶
| Workflow | Best use | What you need |
|---|---|---|
| Spawn egg | Build a new character in the editor | Humanoid NPC Egg or Pokémon NPC Egg |
| Spawn command | Place a character from an existing trainer preset | A successfully loaded preset |
| Saved preset item | Duplicate an existing character | Blank Preset and the saved item preset file |
Start with a humanoid NPC or a Pokémon NPC. The tools guide explains duplication, moving, removal, area edits, and multi-selection.
Open the editor¶
Give yourself the editing tool:
Right-click a GreatNPC with it. Sneak and right-click to receive an NPC summary in chat instead. The custom editor requires GreatNPC on the client and permission to edit on the server. Administrative tools use greatnpc.tools, with operator level 2 as the fallback; opening the editor also checks editing access.
The editor groups settings into appearance, body, equipment, battle, team, interaction, portrait, animations, movement, access, rematches, rewards, messages, menu, and optional gimmick sections. Only relevant fields are shown for the selected NPC type.
Hover over a field name to read its description. Use the search field to find settings across sections. Save the editor after changing settings. Unsaved changes remain local until saved; the close prompt lets you save, discard, or continue editing.
Preset settings and local settings¶
Source Preset identifies a file under config/greatnpc/trainer_preset. Follow Preset controls whether that NPC takes settings from the preset when it is loaded or reloaded. Editing an individual setting turns Follow Preset off, so a local edit is not silently replaced by the source preset.
World placement and home position belong to the placed NPC. A preset describes a reusable character; it is not the same thing as that character's entity UUID.
There are two different preset systems:
- Trainer presets under
trainer_presetare reusable server configurations, referenced by commands and by Source Preset. - Preset items reference snapshots under
config/greatnpc/item_presets. Keep those files when transferring the world/server or the item cannot restore its saved character.
Current limits¶
The following requested features are not implemented in the documented build:
- A dedicated integration that displays the humanoid skin's head on Xaero's minimap.
- A completed fix for all posed-NPC previews in the trade screen.
- A rematch option that despawns the defeated NPC with smoke and replaces it with a respawn-countdown hologram.
Do not look for settings for these features in the current editor. The NPC visual type, dialogue portrait, and trader preview are distinct rendering paths; changing a portrait does not configure a minimap icon.