Equipment - MarkusBordihn/BOs-Easy-NPC GitHub Wiki

Equipment 🛡️

The equipment screen lets you place armor, held items, and head items on an NPC. This is useful both for visual design and for combat-oriented NPC setups.

Equipment screen

Equipment Slots 🎒

Easy NPC supports the normal player-like slots:

  • Head
  • Chest
  • Legs
  • Feet
  • Main Hand
  • Off Hand

Each slot also has a visibility toggle. If visibility is disabled, the item stays equipped but is not rendered on the NPC.

Player Heads 🎭

Head-slot rendering now supports player heads with their stored owner data. That means you can use normal skulls as helmets, decorations, or custom character heads.

Examples:

  • vanilla mob heads
  • player heads
  • player heads with stored custom owner data

If a player head item already contains the correct SkullOwner data, Easy NPC renders that head texture on the NPC.

Player heads in equipment

This is an equipment feature, not a separate skin type. The NPC keeps its normal skin setup, and the head item is rendered on top like normal equipment.

Commands 📜

You can also set or remove equipment with commands:

/easy_npc equipment set <NPC> <slot> <item>
/easy_npc equipment remove <NPC> <slot>

Examples:

/easy_npc equipment set <NPC> armor.head minecraft:dragon_head
/easy_npc equipment set <NPC> weapon.mainhand minecraft:iron_sword

Important Note for Custom Heads

The equipment set command accepts an item id, not a full custom NBT payload. So if you want a player head with specific owner data or a custom head texture, prepare that item through the UI, a preset, or another NBT-aware workflow first.

Good Use Cases 💡

  • guards with helmets and weapons
  • villagers with decorative hats or mob heads
  • custom character statues with player heads
  • quest NPCs with hidden off-hand items or visual-only equipment
⚠️ **GitHub.com Fallback** ⚠️