For the complete documentation index, see llms.txt. This page is also available as Markdown.

Movement, Players, and Flags

These sections control how fake players behave physically: how they move, what their ping looks like, and what they are allowed to do.

Movement

movement:
  enabled: true
  abilities:
    gravity: true
    movement:
      move: true
      strafe: true
      swim_float: true
      climbing: true
      jump: true
    target_and_look:
      look: true
      follow_target: true
      check_for_same_location: true
    block_destruction:
      enabled: true

movement.enabled is the master switch. Turn it off and fake players stand still.

Setting
What it does

gravity

Fake players are affected by gravity and fall naturally.

movement.move

Basic walking.

movement.strafe

Side-to-side movement.

movement.swim_float

Swimming and floating in water.

movement.climbing

Climbing ladders and vines.

movement.jump

Jumping over obstacles.

target_and_look.look

Turning the head to look around.

target_and_look.follow_target

Walking toward a chosen target.

target_and_look.check_for_same_location

Avoids getting stuck by noticing when they have not moved.

block_destruction.enabled

Breaking blocks as they move, like a real player mining.

See it in action

Gravity and natural falling:

Gravity

Picking up dropped items nearby:

Item pickup

Players

Setting
What it does

skipLoginAllow

Forces the login handshake to be accepted. Enable only if a login or auth plugin kicks your fakes on join.

showAnonPlayers

When someone hovers the player count, fakes show as "Anonymous Player" instead of their name.

ping.min and ping.max

The range of ping values fakes can have. The realistic generator stays inside this range.

Flags

Setting
What it does

whitelist_bypass

Fakes can join even when the server whitelist is on.

tick

Fakes tick like real players internally, so they can push entities, regenerate health, load chunks, take fall damage, and interact with the world. Required for realistic knockback.

push

Fakes can be pushed by other entities, for realistic collision.