Skip to main content

~idle

Fires while the entity is not moving.

Parameters

ParameterTypeDefaultDescription
thresholdnumber0.01Speed threshold for idle detection
timenumber0Seconds idle before triggering
maxTimenumber-1Max seconds to stay triggered (-1 = forever)
oncebooleanfalseOnly trigger once per idle period

Examples

Skills:
# Basic idle
- animation{name=idle, mode=loop} ~idle

# Sleep after 5 seconds of idle
- animation{name=sleep, mode=hold} ~idle{time=5}

# Idle for max 5 seconds, then switch
- animation{name=idle, mode=loop} ~idle{maxTime=5}
- animation{name=bored, mode=loop} ~idle{time=5}

Common Patterns

Basic Idle

Skills:
- animation{name=idle, mode=loop} ~idle
- animation{name=walk, mode=loop} ~moving

Idle to Sleep Transition

Skills:
- animation{name=idle, mode=loop} ~idle{maxTime=10}
- animation{name=drowsy, mode=loop} ~idle{time=10, maxTime=15}
- animation{name=sleep, mode=hold} ~idle{time=15}

Bored Animation

Skills:
- animation{name=idle, mode=loop} ~idle{maxTime=8}
- animation{name=yawn} ~idle{time=8, once=true}
- animation{name=look_around, mode=loop} ~idle{time=9}

Pet Sleep

Taming:
item: minecraft:bone

Skills:
- animation{name=idle, mode=loop} ~idle
- animation{name=sit, mode=hold} ~sitting
- animation{name=sleep, mode=hold} ~idle{time=10}