AI Goals Reference

This page lists all available AI Goal Selectors in BTCMobs.

Usage

Goals are added to mobs via the AIGoalSelectors configuration:

MyMob:
  Type: ZOMBIE
  AIGoalSelectors:
    - clear           # Always start with clear
    - float           # Priority 0
    - meleeattack     # Priority 1
    - randomstroll    # Priority 2

Goal Priority

Lower numbers = higher priority. Goals with priority 0 are checked first.

---

Essential Goals

Goal	Aliases	Description
meleeattack	-	Standard melee attack
float	-	Stay on water surface
panic	-	Flee when hurt
randomstroll	randomwalk	Random wandering
lookaround	randomlookaround	Look around randomly
lookatplayers	lookplayers	Look at nearby players

Attack Goals

Goal	Aliases	Description
meleeattack	-	Close-range melee attacks
arrowattack	rangedattack	Ranged projectile attacks
spiderattack	-	Spider-style melee
leapattarget	leap	Jump towards target
creeperswell	swell	Creeper explosion behavior

Movement Goals

Goal	Aliases	Description
randomstroll	randomwalk	Wander randomly
randomswim	swim	Swim randomly
movetowardstarget	approachtarget	Move toward current target
movetolava	-	Move toward lava
movetowater	-	Move toward water
movethroughvillage	-	Navigate through villages
movetoblock	-	Move to specific blocks
movetowardsrestriction	-	Return to restricted area
gotospawn	gotospawnlocation	Return to spawn location

Follow Goals

Goal	Aliases	Description
followowner	gotoowner	Follow owner (tameable)
followparent	gotoparent	Follow parent mob
followmob	followmobs	Follow other mobs
tempt	-	Follow player holding item

Flee Goals

Goal	Aliases	Description
fleeplayers	avoidplayers	Flee from players
fleesun	avoidsun	Avoid sunlight
restrictsun	-	Stay out of sunlight

Interaction Goals

Goal	Aliases	Description
breakdoors	breakdoor	Break through doors
opendoor	opendoors	Open doors
breed	-	Animal breeding behavior
eatgrass	-	Sheep grass eating
lookattarget	-	Look at current target

---

Goal Parameters

Many goals support optional parameters:

AIGoalSelectors:
  - meleeattack{speed=1.5;range=2.0}
  - fleeplayers{range=16;speed=1.2}

Common Parameters

Parameter	Type	Description
speed	Double	Movement speed multiplier
range	Double	Detection/flee range