> For the complete documentation index, see [llms.txt](https://docs.spoof.dev/asteroid/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spoof.dev/asteroid/configuration/movement-players-and-flags.md).

# 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

```yaml
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](https://4195567042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpRR1OEuNyGq1PGnHucUc%2Fuploads%2FdELKt1hDkCh3UnRIXJCv%2Fgravity.gif?alt=media\&token=3393ecf8-2615-4969-a821-e54217026e44)

Picking up dropped items nearby:

![Item pickup](https://4195567042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpRR1OEuNyGq1PGnHucUc%2Fuploads%2FsqAQiIjbqhTyOk7fP2dH%2Fpickup.gif?alt=media\&token=2454ca42-5a16-4b0b-baac-d8ca9196b1d6)

## Players

```yaml
players:
  skipLoginAllow: false
  showAnonPlayers: false
  ping:
    min: 6
    max: 350
```

| 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

```yaml
flags:
  whitelist_bypass: true
  tick: true
  push: true
```

| 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.                                                                                                                      |