AI

Returns the distance in pixels between this object and another object.

Measured between the two objects' positions (their top-left x, y), so it matches the visual gap only for objects of similar size. Returns 0 if no object has that name.

Example Plug it into an If with a comparison to start an attack when the player is closer than 150 pixels.

Moves this object straight toward another object at a fixed speed.

Works exactly like Move Toward Object with Use AI Speed off: it changes the position directly (not the velocity), never overshoots the target and does not rotate the object. Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth. Does nothing if the object is not found.

Example Inside On Update of an enemy with Speed 120 to chase the Player.

Moves this object straight away from another object at a fixed speed.

Works like Move Away From Object with Use AI Speed off: it changes the position directly, has no distance limit and does not rotate the object. Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth. Does nothing if the object is not found or both are at the exact same spot.

Example Inside an If with Object Is Near? so a creature runs away only when the player gets close.

Moves this object toward another object and turns to face it, stopping once it is within a set distance.

While farther than Stop Distance it rotates to face the target and moves toward it; inside that distance it stands still and keeps its last rotation. Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth. Distances are measured between the objects' positions (their top-left x, y).

Example Inside On Update of a pet with Stop Distance 60 so it trails the player without bumping into it.

Keeps this object at a set distance from another object, backing off when too close and approaching when too far.

If closer than Distance minus Tolerance it moves away; if farther than Distance plus Tolerance it moves closer; in between it stays still. It always turns to face the target while moving. Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth.

Example Inside On Update of an archer enemy with Distance 250 so it stays out of melee range.

Rotates this object so it faces another object.

Sets the rotation instantly (no turning speed). Angles use screen space: 0 degrees points right and 90 points down, because y grows downward. The sprite rotates too. Does nothing if the object is not found.

Example Inside On Update of a turret so it always aims at the Player.

Moves this object straight away from another object.

Changes the position directly (not the velocity), with no distance limit, and does not rotate the object. Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth. Does nothing if the object is not found.

Moves this object straight toward a target object at a fixed speed.

Same behaviour as Chase Object: it changes the position directly, stops exactly on the target instead of overshooting and does not rotate the object. Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth.

Example Place an object called Exit and use this block in On Update to walk an NPC there.

Moves this object straight toward another object.

Changes the position directly (not the velocity), stops exactly on the target instead of overshooting, and does not rotate the object (use Look At Object for that). Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth.

True when another object is at least the given distance away from this object.

The check is distance >= Distance. Distances are measured between the objects' positions (their top-left x, y). Returns false if no object has that name, so it is not simply the opposite of Object Is Near?.

Example Use it in an If to stop chasing when the player has escaped.

True when another object is within the given distance of this object.

The check is distance <= Distance. Distances are measured between the objects' positions (their top-left x, y). Returns false if no object has that name.

Example Combine it with Chase Object inside an If so an enemy only chases when the player is nearby.

Moves this object back and forth between two objects used as waypoints, facing where it goes.

It heads to Point A first, switches to the other point when within Arrival Distance, and repeats. Each block remembers its own next waypoint. Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth. Does nothing unless both points exist.

Example Place two empty objects at the ends of a platform and patrol a guard between them inside On Update.

Stores the speed this object's AI blocks use when their Use AI Speed option is true.

Does not move the object by itself. Negative values become 0. Until this block runs, the stored speed is 180 pixels per second (120 for Wander Randomly).

Example Raise it when an enemy gets angry so all its AI movement blocks speed up at once.

Sets this object's velocity to zero.

It only clears the physics velocity. The other AI blocks move the position directly, so they keep moving the object as long as they run; to stop them, stop running those blocks (for example with an If).

Example Use it when an enemy with a Rigidbody is stunned, together with a condition that skips its AI blocks.

Moves this object in a random direction that changes every few seconds, facing the way it moves.

A new random direction is picked every Change Every seconds; the timer is shared by the whole object. It does not steer around walls or other objects. Moves by speed x frame time, so run it every frame (inside On Update or a Forever loop); a single run moves only one frame's worth.

Example Inside On Update of ambient critters, combined with Keep inside area so they stay on screen.