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

Introduction

Plugins

Extensions

AI Goals

AI Goals Reference

Usage

Goal Priority

Essential Goals

Attack Goals

Movement Goals

Follow Goals

Flee Goals

Interaction Goals

Goal Parameters

Common Parameters

Introduction

Plugins

Extensions

​AI Goals Reference

​Usage

​Goal Priority

​Essential Goals

​Attack Goals

​Movement Goals

​Follow Goals

​Flee Goals

​Interaction Goals

​Goal Parameters

​Common Parameters

AI Goals Reference

Usage

Goal Priority

Essential Goals

Attack Goals

Movement Goals

Follow Goals

Flee Goals

Interaction Goals

Goal Parameters

Common Parameters