> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rollingquest.kramgames.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WorldDirection Enum Reference for RollingQuest Scripts

> WorldDirection for RollingQuest scripts — six global directions: Up, Down, Left, Right, Front, and Back for entity movement, forces, and patrol paths.

The `WorldDirection` enum represents the six cardinal directions available in the RollingQuest 3D world. Unlike the `Face` enum, which describes sides relative to an individual block's local geometry, `WorldDirection` expresses movement or orientation relative to the global world coordinate system. You use it whenever you need to specify the direction an entity should move, the axis along which a force is applied, or the orientation of a path segment — in short, any time the API needs to know "which way in the world" rather than "which face of this block."

## Values

| Value                  | Number | Description                                                               |
| ---------------------- | ------ | ------------------------------------------------------------------------- |
| `WorldDirection.Up`    | `0`    | Points upward along the global vertical (Y) axis.                         |
| `WorldDirection.Down`  | `1`    | Points downward along the global vertical (Y) axis.                       |
| `WorldDirection.Left`  | `2`    | Points in the negative horizontal direction along the X axis.             |
| `WorldDirection.Right` | `3`    | Points in the positive horizontal direction along the X axis.             |
| `WorldDirection.Front` | `4`    | Points toward the camera's default forward direction along the Z axis.    |
| `WorldDirection.Back`  | `5`    | Points away from the camera's default forward direction along the Z axis. |

## Usage Example

The example below moves an entity one step in the `Right` direction, then applies a push force `Up` when a trigger fires:

```lua theme={null}
-- Move an entity one unit to the right in world space
entity:move(WorldDirection.Right)

-- Apply an upward impulse to the ball when entering a vent block
function onVentActivated()
    Ball.applyImpulse(WorldDirection.Up, 5.0)
end
```

You can also use `WorldDirection` to define patrol paths for enemies:

```lua theme={null}
local patrolPath = {
    WorldDirection.Front,
    WorldDirection.Right,
    WorldDirection.Back,
    WorldDirection.Left,
}

local step = 1
function onEnemyStep(enemy)
    enemy:moveInDirection(patrolPath[step])
    step = (step % #patrolPath) + 1
end
```