Skip to content

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

  1. Obtain the Humanoid NPC Egg and Edit NPC tool:
/give @s greatnpc:humanoid_egg
/give @s greatnpc:edit_stick
  1. 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.
  2. Right-click the NPC with Edit NPC.
  3. Set Name, then configure a skin under Appearance.
  4. Choose On Interaction under Interaction.
  5. 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:

/gnpc spawn custom/guide

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.