🧍 NPC Integration (Citizens)

When Citizens is installed, CodellaCells offers rich NPC features to enhance cell customization and functionality.

NPC Configuration

Define NPC types in config.yml under the npcs.list section:

npcs:
  enabled: true
  list:
    banker:
      name: banker
      type: PLAYER
      display-name: "&6%cell_owner%'s Banker"
      skin-name: MHF_Banker
    
    guide:
      name: guide
      type: VILLAGER
      display-name: "&a%cell_owner%'s Guide"

Core NPC Features

• Spawn NPCs: Place custom NPCs in your cell

  • Command: /cell npc spawn <name>

  • Each NPC type can have unique appearance and behavior

• Portable NPCs: Unique egg system for NPC management

  • Left-click an NPC to convert it to a special egg item

  • Place the egg elsewhere in your cell to redeploy the NPC

  • NBT data ensures security and prevents duplication

• Interaction: NPCs can serve as cell management access points

  • Right-clicking NPCs opens the cell management GUI

  • Creates convenient, thematic access to cell functions

NPC Egg System

• Custom configured appearance in npcs.npc-egg section

• Stores NPC type and owner UUID in NBT data

• Can only be used by the correct owner within their own cell

• Prevents NPC theft or misuse