Skip to content

Pathfinding behavior Reference

Pathfinding allows to compute an efficient path for objects, avoiding obstacles on the way. Read more explanations about it.

Pathfinding

Move objects to a target while avoiding all objects that are flagged as obstacles.

Behavior actions

Acceleration
Change the acceleration when moving the object

Diagonal movement
Allow or restrict diagonal movement on the path

Rotation offset
Change the rotation offset applied when moving the object

Angular maximum speed
Change the maximum angular speed when moving the object

Height of the cells
Change the height of the cells of the virtual grid.

Width of the cells
Change the width of the cells of the virtual grid.

Extra border
Change the size of the extra border applied to the object when planning a path

Maximum speed
Change the maximum speed when moving the object

Grid X offset
Change X offset of the virtual grid.

Grid Y offset
Change Y offset of the virtual grid.

Rotate the object
Enable or disable rotation of the object on the path

Move to a position
Move the object to a position

Speed
Change the speed of the object on the path

Behavior conditions

Acceleration
Compare the acceleration when moving the object

Rotation offset
Compare the rotation offset when moving the object

Angular maximum speed
Compare the maximum angular speed when moving the object

Height of the virtual grid
Compare the height of the cells of the virtual grid.

Width of the virtual grid
Compare the width of the cells of the virtual grid.

Destination reached
Check if the destination was reached.

Diagonal movement
Check if the object is allowed to move diagonally on the path

Extra border
Compare the size of the extra border applied to the object when planning a path

Maximum speed
Compare the maximum speed when moving the object

Object rotated
Check if the object is rotated when traveling on its path.

Path found
Check if a path has been found.

Grid X offset
Compare X offset of the virtual grid.

Grid Y offset
Compare Y offset of the virtual grid.

Angle of movement on its path
Compare the angle of movement of an object on its path.

Speed on its path
Compare the speed of the object on its path.

Behavior expressions

Expression Description
Object.Pathfinding::Acceleration() Acceleration of the object on the path
Object.Pathfinding::AngleOffset() Rotation offset applied the object on the path
Object.Pathfinding::AngularMaxSpeed() Angular maximum speed of the object on the path
Object.Pathfinding::CellHeight() Height of the virtual grid
Object.Pathfinding::CellWidth() Width of the virtual grid
Object.Pathfinding::DestinationX() Destination X position
Object.Pathfinding::DestinationY() Destination Y position
Object.Pathfinding::ExtraBorder() Extra border applied the object on the path
Object.Pathfinding::GetNodeX(number) Get next waypoint X position
🔢 Number Node index (start at 0!)
Object.Pathfinding::GetNodeY(number) Get next waypoint Y position
🔢 Number Node index (start at 0!)
Object.Pathfinding::GridOffsetX() Return X offset of the virtual grid.
Object.Pathfinding::GridOffsetY() Return Y offset of the virtual grid.
Object.Pathfinding::LastNodeX() Last waypoint X position
Object.Pathfinding::LastNodeY() Last waypoint Y position
Object.Pathfinding::MaxSpeed() Maximum speed of the object on the path
Object.Pathfinding::MovementAngle() Angle of movement on its path
Object.Pathfinding::NextNodeIndex() Get the index of the next waypoint to reach
Object.Pathfinding::NextNodeX() Get next waypoint X position
Object.Pathfinding::NextNodeY() Get next waypoint Y position
Object.Pathfinding::NodeCount() Get the number of waypoints on the path
Object.Pathfinding::Speed() Speed of the object on the path

Obstacle for pathfinding

Flag objects as being obstacles for pathfinding.

Behavior actions

Cost
Change the cost of going through the object.

Should object be impassable
Decide if the object is an impassable obstacle.

Behavior conditions

Cost
Compare the cost of going through the object

Impassable obstacle
Check if the obstacle is impassable.

Behavior expressions

Expression Description
Object.PathfindingObstacle::Cost() Obstacle cost

This page is an auto-generated reference page about the Pathfinding behavior feature of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop features here.