Skip to content

Tools, coins and keys

GreatNPC registers its own creative item group. Administrative tools require greatnpc.tools, with operator level 2 as the default permission fallback. Editing screens and their networking checks also apply.

Administrative tools

Item ID Purpose
greatnpc:humanoid_egg Spawn a humanoid NPC by right-clicking a block.
greatnpc:pokemon_egg Spawn a Pokémon NPC by right-clicking a block.
greatnpc:edit_stick Open the NPC editor; sneak to show an NPC summary.
greatnpc:move_wand Select an NPC, then right-click its destination block. Sneak and right-click the air to clear selection.
greatnpc:rotate_wand Turn the NPC toward you; sneak to use your facing direction.
greatnpc:remove_wand Sneak and right-click to remove an NPC.
greatnpc:preset_blank Copy an NPC into a reusable preset item.
greatnpc:preset_used A saved preset item; right-click a block to spawn a copy, or sneak and apply it to a compatible NPC.
greatnpc:preset_area Open the area configuration editor.
greatnpc:multi_config Select multiple NPCs and open their shared editor.
greatnpc:main_config Open server settings.

New NPC eggs create an NPC for further editing; they are not a shortcut for creating a complete trainer team. Configure the team and battle settings before expecting a battle.

Coins

The available item IDs are:

  • greatnpc:coin_copper
  • greatnpc:coin_iron
  • greatnpc:coin_gold
  • greatnpc:coin_amethyst
  • greatnpc:coin_diamond
  • greatnpc:coin_emerald
  • greatnpc:coin_netherite
  • greatnpc:money

These are inventory items. GreatNPC does not automatically assign exchange rates, wallet balances or conversions between denominations. Create shop offers or administrator commands to define your server's economy.

For example, an administrator can give ten gold coins with:

/give @s greatnpc:coin_gold 10

Gold and silver keys

Appearance Item ID
Gold key greatnpc:key
Silver key greatnpc:key_silver

The gold key keeps the original key identifier for compatibility. Both keys are ordinary items; they do not automatically unlock doors or containers. Use a condition to check for a key, or a trade cost to consume it as payment.

A key condition only checks possession:

{"type": "item", "value": "greatnpc:key_silver", "amount": 1}

The localization guide explains translating item names and replacing language resources in a resource pack. Texture overrides use the matching files under assets/greatnpc/textures/item/.