Mob Introduction

The entity section defines the core properties of your mob.

---

Entity Section

Basic entity configuration

entity:
  # Minecraft entity type
  mob-type: ZOMBIE
  
  # Display name shown above mob
  display-name: '&cLevel 5 Zombie &4❤&c%health%'
  
  # Maximum health
  health: 150
  
  # AFK mob flag (for passive spawning)
  afk-mob: false
  
  # Auto-hit configuration
  auto-hit:
    enabled: true
    interval: 10

---

Properties

mob-type (Required)

The Minecraft entity type for this mob.

Common Types

mob-type: ZOMBIE
mob-type: SKELETON
mob-type: CREEPER
mob-type: SPIDER
mob-type: ENDERMAN

Passive Types

Boss Types

Complete list of entity types

---

display-name (Required)

The name displayed above the mob and in the boss bar.

Supports:

• Color codes (&a, &c, #RRGGBB)

• Placeholders (%health%, %max_health%)

• PlaceholderAPI placeholders

Simple

display-name: '&cZombie'

With Level

With Health

Advanced

Available Placeholders:

Placeholder	Description	Example
%health%	Current health (rounded)	150
%max_health%	Maximum health	200

---

health (Required)

The mob's maximum health.

# Low health (easy mob)
health: 50

---

afk-mob (Optional)

Whether this mob is an AFK mob (spawned passively for idle players).

# Normal mob - player must actively attack
afk-mob: false

# AFK mob - auto-attacks for idle players
afk-mob: true

Default: false

---

auto-hit (Required)

Configuration for automatic attacking when the mob is targeted.

Auto-hit configuration

auto-hit:
  # Enable automatic attacking
  enabled: true
  
  # Ticks between attacks (20 ticks = 1 second)
  interval: 10

enabled

Enable or disable auto-hitting for this mob.

# Normal mob - auto-attacks enabled
auto-hit:
  enabled: true

# Passive mob - no auto-attacks
auto-hit:
  enabled: false

interval

Time in ticks between automatic attacks.

# Very fast (0.5 seconds)
interval: 10

# Fast (1 second)
interval: 20

# Medium (2 seconds)
interval: 40

# Slow (5 seconds)
interval: 100

Formula: ticks = seconds × 20

Seconds	Ticks
0.5s	10
1s	20
2s	40
5s	100
10s	200

---

Next Steps

1

Better Configuration Understanding

Mob Configuration

2

Mob Metadata Builder

Mob Metadata

3

Mob Visuals

Mob Visuals

4

Mob Rewards

Mob Rewards