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
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 (likejohnny
,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