Motion

Turns this object to face up, down, left or right and plays the matching Idle animation.

Plays IdleUp, IdleDown, IdleLeft or IdleRight if the object has it (IdleLeft falls back to a mirrored IdleRight, then to Idle). The facing is shared with Walk on grid; rotation does not change. Any other value stops the game with an error.

Turns this object to face another object (up, down, left or right) and plays that Idle animation.

Compares the centres of both objects and picks the axis with the larger distance. Rotation does not change. Does nothing if the object is not found.

Example An NPC turns to the player before starting a dialogue.

Moves this object to a random grid cell that is not covered by any collider.

The grid starts at left, top and has columns by rows square cells. A cell is free when its centre is outside every other active collider, triggers included. The object is centred in the chosen cell; if none is free, nothing happens.

Example Move the snake's food to a free spot after it is eaten.

Moves this object to an x, y position given as numbers or {templates}.

Both values must turn into numbers, otherwise the game stops with an error. The position is the object's top-left corner in world pixels, with y growing downward.

Example Save the player's spot in globals before changing scene, then use this block to come back to it.

Adds copies of an object to the end of this object's grid trail, like a snake that grows.

Works with Move on grid, which places each segment on the path left behind. New segments stay hidden and without collision until the path is long enough. Copies keep the original's name; up to 2000 segments.

Example When the snake eats food, grow the trail by 1.

Keeps this object's position inside a rectangle.

Limits x and y (the top-left corner, or the centre of the view on a Camera) to the given range. Use it every frame in On Update. If a minimum is greater than its maximum, the game stops with an error.

Example On the Camera, after Follow object smoothly, so the view never goes past the level edges.

Moves this object part of the way toward a target position, easing in as it gets closer.

Each run covers speed times the frame time of the remaining distance (all of it once that reaches 1), so use it in On Update. With a frame time of 0, as in When Game Starts, nothing happens.

Rotates this object so its facing direction points at the mouse pointer.

Measures from the object's x, y (its top-left corner) to the pointer in world coordinates. Rotation 0 faces right and 90 faces down. Use it in On Update to keep aiming.

Example A turret that always aims at the pointer.

Moves this object by an amount in the mode you pick: forward, backward, left, right, along x or y, or at an angle.

forward and backward follow the object's rotation (0 = right, 90 = down); angle uses the angle value instead. left and right move along x, and x and y add the amount to that axis (y grows downward). Moves once per run, not scaled by frame time.

Moves this object backward, opposite to the direction it faces, by a number of pixels.

Uses the current rotation: with rotation 0 it moves left.

Moves this object a number of pixels in a given direction, without changing its rotation.

Example Knock the player back at the angle it was hit from.

Moves this object forward, in the direction it faces, by a number of pixels.

Uses the current rotation: 0 faces right and 90 faces down. Inside On Update it moves that far every frame.

Example Combine with Rotate By for car-style steering.

Moves this object left by a number of pixels.

Subtracts the amount from x and ignores rotation.

Moves this object one grid cell in its steered direction at a steady interval, snake-style.

Use it in On Update with Steer on grid for turns; it starts heading right. The interval shrinks by faster_per_segment per trail segment, down to min_interval. Segments added with Grow trail follow the path.

Moves this object right by a number of pixels.

Adds the amount to x and ignores rotation.

Changes this object's x position by a number of pixels.

Positive values move right, negative values move left. Ignores rotation.

Example Plug Get Axis Horizontal times 5 into it inside On Update for simple left and right movement.

Changes this object's y position by a number of pixels.

y grows downward: positive values move down and negative values move up. Ignores rotation.

Places this object on a circle around another object, driven by the game clock.

The angle comes from the time since play started, so with speed 1 it makes a full turn every 2 seconds, clockwise on screen. It sets the position from the other object's x, y (top-left corner), so run it every frame in On Update. Does nothing if the object is not found.

Moves this object back and forth from its starting position forever, for enemies and moving platforms.

Use it in On Update. The start is where the object was the first time the block ran. With face_direction on, the object is mirrored while it heads toward smaller x, so draw the sprite facing right.

Sets this object's rotation to an angle in degrees.

0 faces right, 90 down, 180 left and 270 up; bigger angles turn clockwise. Same result as Set Rotation.

Rotates this object so it faces another object.

Aims from this object's x, y to the other object's x, y (their top-left corners), so objects of different sizes can end up slightly off-centre. Does nothing if the object is not found.

Turns this object by a number of degrees.

Positive values turn clockwise on screen, negative values counter-clockwise. Inside On Update it turns that much every frame.

Example A small value in On Update makes a spinning coin.

Sets this object's height in pixels.

Values below 1 become 1. The collider keeps its own size.

Moves this object to an exact x, y position.

Coordinates are world pixels for the object's top-left corner; y grows downward.

Example Send the player back to the start of the level after falling.

Sets this object's rotation to an angle in degrees.

0 faces right and 90 faces down. The sprite turns around its centre; the collider does not rotate.

Multiplies this object's current width and height by the given factors.

Despite its name it is relative: running it twice with 2 makes the object four times as wide. Use Set Width and Set Height for exact sizes. Sizes never go below 1 pixel, and the collider keeps its own size.

Sets this object's width in pixels.

Values below 1 become 1. The collider keeps its own size.

Sets this object's x position.

x is the object's left edge in world pixels; it grows to the right.

Sets this object's y position.

y is the object's top edge in world pixels; it grows downward.

Queues a turn when an arrow key or W, A, S, D is pressed, for objects moved by Move on grid.

Use it every frame in On Update, before Move on grid. It remembers up to two turns so quick presses are not lost, and ignores turning straight back.

Walks this object one grid cell at a time with the arrow keys or W, A, S, D, blocked by solid colliders.

Use it in On Update. A quick tap while standing only turns around. Plays WalkUp/WalkDown/WalkLeft/WalkRight and Idle... clips (or Walk/Idle) when present, and pauses while a dialogue box or choice menu is open.

Example The player in a top-down RPG.