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.

Last updated