Documentation Index
Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
Use this file to discover all available pages before exploring further.
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 |