Skip to content

Administrative tools

GreatNPC's creative tab contains its editing tools, spawn eggs, preset tools, keys, and coins. The tools require greatnpc.tools; without a permission manager, the fallback is operator level 2. Opening the editor can require additional edit permission. The custom screens require the mod on the client.

Item IDs

Use /give @s <id> to obtain an item:

Item ID
Edit NPC greatnpc:edit_stick
Move Wand greatnpc:move_wand
Rotate Wand greatnpc:rotate_wand
Remove Wand greatnpc:remove_wand
Blank Preset greatnpc:preset_blank
Saved Preset greatnpc:preset_used — normally produced by copying an NPC
Config Area greatnpc:preset_area
Multi Config greatnpc:multi_config
Humanoid NPC Egg greatnpc:humanoid_egg
Pokémon NPC Egg greatnpc:pokemon_egg
Server Settings greatnpc:main_config

For example:

/give @s greatnpc:edit_stick
/give @s greatnpc:move_wand

Edit a character

Right-click an NPC with Edit NPC to open its editor. Sneak and right-click for a summary in chat. Save to apply your edits. Use the source preset controls deliberately when editing multiple NPCs that share a trainer configuration.

The Server Settings item opens the server-wide settings screen. It configures the server, not just the NPC under your cursor.

Move an NPC

  1. Right-click an NPC with Move Wand to select it.
  2. Right-click the destination block. The target position is in the adjacent cell on the block face you clicked.
  3. On success, the NPC moves, its home position updates, and the selection clears.

Sneak and right-click in the air to clear an active selection without moving the NPC. The selection is stored on the wand. The target NPC must still be loaded; an unloaded or removed entity cannot be moved through this selection.

Movement attempts can cross dimensions when the selected entity is still loaded. A failed teleport reports failure. Move Wand preserves the entity's identity when the teleport succeeds and requests a skin resync; it is not intended to reset the character's battle history or equipment.

Rotate an NPC

  • Right-click with Rotate Wand to face the NPC toward you.
  • Sneak and right-click to face it in the direction you are looking.

For a precise permanent facing and independent head behavior, configure Lock Body Rotation, Facing Direction, and Allow Head Movement in the movement editor.

Remove an NPC

Sneak and right-click the NPC with Remove Wand. Right-clicking without sneaking only shows a reminder.

Removal discards the placed entity. It does not delete the reusable trainer preset file. Copy a character before removal if you want a reusable snapshot.

Copy and reuse a preset item

  1. Right-click an NPC with Blank Preset.
  2. The blank item remains available and a saved preset item is added to your inventory or dropped if necessary.
  3. Right-click a block with that saved item to spawn a new copy.
  4. To apply it to an existing character, sneak and right-click the target NPC.
  5. Sneak and use the saved item in the air to turn it back into a blank preset.

A humanoid snapshot can only be applied to a humanoid NPC; a Pokémon snapshot can only be applied to a Pokémon NPC. Copies receive a home at their new placement. The saved snapshot excludes the old home position.

Saved items refer to files in config/greatnpc/item_presets. Back up that folder along with your server data. An item whose snapshot file was deleted cannot recreate the saved NPC. This snapshot system is separate from the trainer presets under trainer_preset.

Edit NPCs in an area

Use Config Area to open a blank editor. Choose the radius and change only the settings you want to apply, then save. The default radius is 5 blocks; the allowed radius is 1–64 blocks. Area selection applies to loaded GreatNPC characters in range and is capped at 300 targets.

Unchanged settings are not intentionally included in the edit request. Check which fields are marked changed before saving: a bulk edit can affect both humanoid and Pokémon characters where a field applies.

To undo the last bulk edit, sneak and right-click twice with Config Area. The second click must occur within the confirmation window (1.8 seconds). The undo snapshot is kept in memory for your player; it is not a permanent history or a substitute for backups. Only still-loaded entities can be restored.

Edit a selected group

  1. Hold Multi Config and right-click each target NPC.
  2. Selected NPCs gain an outline on supported clients. Right-click an already selected NPC to deselect it.
  3. Right-click a block or use the item in the air to open an editor for the selection.
  4. Change the intended fields and save.

The selection supports up to 300 NPCs and lasts until cleared or you disconnect. To clear it while holding Multi Config, hold Shift for 10 seconds, or press Shift five times within the short detection window. The server checks the held item in either hand.

If selected NPCs have unloaded, they are omitted from the actual edit. An empty loaded selection cannot be edited. Use Config Area's sneak-double-click undo for the most recent bulk edit, including one performed through Multi Config.

Select inventory items in editors

Trade/reward object forms can open a Choose from Inventory screen. Select an item from your inventory, hotbar, equipment, or offhand. The editor copies its definition/components; it does not remove the item. Back or Escape cancels. Quantities remain separate editor settings.

For equipment-specific click/drag behavior, see Equipment editor.