> For the complete documentation index, see [llms.txt](https://docs.nursultan.fun/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nursultan.fun/actions/movement.md).

# Movement

There are two ways to move the player: a direct command right now, or rewriting the input for this tick.

## Direct commands

```kotlin
control.jump()
control.sprinting(true)
control.sneaking(true)
```

`jump()` jumps immediately if the player is on the ground. `sprinting` and `sneaking` turn the state on and off.

Good for one-off actions: hop on knockback, crouch for a moment.

## Rewriting input

`MoveInputEvent` is what the game is about to do this tick. Every field can be rewritten:

```kotlin
on<MoveInputEvent> { e ->
    e.forward(true)
    e.sprint(true)
    e.jump(false)
}
```

| Field                     | What it means    |
| ------------------------- | ---------------- |
| `forward()`, `backward()` | forward and back |
| `left()`, `right()`       | strafing         |
| `jump()`                  | jump             |
| `sneak()`                 | sneak            |
| `sprint()`                | sprint           |

Good for holding a state: keeping sprint off, walking the player forward, blocking a jump.

## Priority

Client modules and scripts both want the same input. To have the final word, subscribe with `Priority.LAST`:

```kotlin
on<MoveInputEvent>(priority = Priority.LAST) {
    it.sprint(false)
}
```

For example, killing sprint for exactly one tick so the hit lands as a critical:

```kotlin
var blockSprintTicks = 0

on<MoveInputEvent>(priority = Priority.LAST) {
    if (blockSprintTicks > 0) {
        blockSprintTicks--
        it.sprint(false)
    }
}

// somewhere in the combat logic
blockSprintTicks = 1
```

## The mouse

`LookInputEvent` gives you mouse movement for the frame, and it can be rewritten too:

```kotlin
on<LookInputEvent> { e ->
    e.deltaX(e.deltaX() * 0.5)     // half speed horizontally
    e.deltaY(e.deltaY() * 0.5)
}
```

Cancel the event and the mouse stops turning the camera at all.

Turning the head towards a target is not this — that is [Rotations](/actions/rotations.md).

## Slowdown

`SlowdownEvent` fires when the game is about to slow movement down: food, a shield, a drawn bow. The multiplier can be rewritten:

```kotlin
on<SlowdownEvent> { e ->
    e.multiplier(1f)     // do not slow down at all
}
```