Entities

The entities section defines custom spawnable entities (mobs or NPCs) with specific behavior, appearance, and equipment.

Each entry under entities: defines one unique entity configuration.

---

🧾 Example Configuration

entities:
  example_name:
    chance: 60 # Chance to spawn this entity (0–100)
    type: VILLAGER # The base Minecraft entity type
    name: '&9&lJohnny' # Display name of the entity
    gravity: false # Whether affected by gravity
    glowing: true # Glowing effect
    AI: true # Enables/disables AI
    invulnerable: true # Cannot be damaged if true
    silent: true # Makes the entity silent
    villager:
      type: DESERT
    equipments:
      mainhand:
        material: DIAMOND_SWORD
        name: '&bDiamond Sword'
      offhand:
        material: SHIELD
        name: '&bShield'

---

⚙️ General Entity Options

Key	Type	Description
chance	Number(0–100)	Chance for this entity to spawn
type	Text	Bukkit entity type (e.g., ZOMBIE, VILLAGER)
name	Text	Display name (supports colors and placeholders)
gravity	true/false	Whether the entity is affected by gravity
glowing	true/false	Enables glowing outline
AI	true/false	Enables or disables AI logic
invulnerable	true/false	Prevents entity from taking damage
silent	true/false	Disables all sound effects
fire-ticks, fall-distance, portal-cooldown, etc.	Number	Various physical attributes
health, absorption, max-air, etc.	Number	Living entity attributes

---

🧪 Entity-Specific Attributes

Depending on the entity type, additional options may apply:

🧙 Villager

villager:
  type: DESERT
  level: 3
  experience: 100

🧬 Breeding / Ageing (for Ageable, Animals, etc.)

baby: true # Whether the entity is a baby
breed: true # Whether the entity can breed
age: 100 # Age of the entity (in ticks, 20 ticks = 1 second)
age-lock: true # Whether the age of the entity is locked
love-mode: 600 # Love mode duration (in ticks, 20 ticks = 1 second)
tamed: true # Whether the entity is tamed
sitting: true # Whether the entity is sitting

🪖 Equipment (for any LivingEntity)

equipments:
  main-hand:
    material: DIAMOND_SWORD
    name: '&bExcalibur'
    drop-chance: 100
  helmet:
    material: LEATHER_HELMET
    name: '&cCap of Wisdom'
    drop-chance: 0

🔍 You can use any combination of:

• main-hand, off-hand

• helmet, chestplate, leggings, boots

With optional item: nesting for extra item data like name, lore, etc.

Here you can see how to set the item

---

❓ Can I have multiple entities?

✅ Yes, absolutely!

You can define as many entries under entities: as you'd like. Each entity must have a unique ID (like johnny, guard1, merchant_bob, etc.).

entities:
  merchant:
    type: VILLAGER
    name: '&eMerchant'
    AI: false
    gravity: false

  knight:
    type: ZOMBIE
    name: '&7Royal Guard'
    equipments:
      mainhand:
        material: IRON_SWORD

Each one will be interpreted individually.