Create a humanoid NPC¶
A humanoid NPC is suitable for shopkeepers, trainers, guides, guards, and decorative characters. Appearance and interaction are independent: a human character can open a shop, start a battle, display dialogue, or perform no action.
Create an NPC with the egg¶
- Obtain the Humanoid NPC Egg and Edit NPC tool:
- Right-click a block with the egg. The NPC appears in the adjacent space on the face you clicked and initially faces the opposite direction to you.
- Right-click the NPC with Edit NPC.
- Set Name, then configure a skin under Appearance.
- Choose On Interaction under Interaction.
- Save the editor and test the interaction without an administrative tool in your hand.
Egg-created humanoids start with the name NPC, battle enabled set to false, and interaction mode set to dialog. The egg does not create a battle team. In survival, successful creation consumes one egg; creative mode does not consume it.
Use an existing trainer preset¶
If a trainer preset already exists and loads successfully, spawn it at your current position:
Here, custom/guide means config/greatnpc/trainer_preset/custom/guide.json. Replace it with an existing preset ID; this command does not create the preset file. A preset's configured visual kind determines whether the general spawn command creates a humanoid or Pokémon NPC.
Configure what the character does¶
| On Interaction | Behavior |
|---|---|
none |
No main interaction screen/action |
actions |
Runs configured interaction actions |
battle |
Starts the configured trainer battle if requirements pass |
dialog |
Opens dialogue |
trade |
Opens the shop |
heal |
Heals the interacting player's party |
A name or skin alone does not enable battles. For a trainer, configure the team, battle settings, interaction mode, and access/rematch rules before testing.
Finish the character¶
- Appearance and poses: skins, scale, equipment, hitbox, portrait, and body adjustments.
- Movement: fixed facing, gaze targets, wandering, and home position.
- Tools: move, rotate, duplicate, or remove the placed character.
For a stationary shopkeeper, start with Wander off, Can Be Pushed off, and Look at Players on. This keeps the character in place while allowing it to acknowledge nearby visitors.