Skip to main content
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

ValueNumberDescription
WorldDirection.Up0Points upward along the global vertical (Y) axis.
WorldDirection.Down1Points downward along the global vertical (Y) axis.
WorldDirection.Left2Points in the negative horizontal direction along the X axis.
WorldDirection.Right3Points in the positive horizontal direction along the X axis.
WorldDirection.Front4Points toward the camera’s default forward direction along the Z axis.
WorldDirection.Back5Points 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: 
-- 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: 
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