Curved movement
Move objects on curved paths.
Authors and contributors to this experimental extension: pampogokiraly, D8H.
This extension allows to move objects on Bézier curve paths.
- Paths can be built dynamically or from predetermined paths in SVG format.
- A behavior moves objects in a given duration a bit like the Tween extension does.
- Another behavior moves objects using a speed and an acceleration.
- Expressions give access to the path trajectory values for more complex movements.
This extension can be used to:
- Move enemies that follow a pattern
- Animate decorations
A collection of small examples shows how to use this extension.
2 examples use it:
- a 3D racing game (open the project online)
- a Zuma-like (open the project online)
Tip
Learn how to install new extensions by following a step-by-step guide.
Actions
Append a curve
Append a cubic Bezier curve at the end of the path.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
- Parameter 2 (🔢 Number): First control point X
- Parameter 3 (🔢 Number): First control point Y
- Parameter 4 (🔢 Number): Second Control point X
- Parameter 5 (🔢 Number): Second Control point Y
- Parameter 6 (🔢 Number): Destination point X
- Parameter 7 (🔢 Number): Destination point Y
- Parameter 8 (❓ Yes or No): Relative
Technical note: parameters 0, 9 are internal parameters handled by GDevelop.
Append a line
Append a line at the end of the path.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
- Parameter 2 (🔢 Number): Destination point X
- Parameter 3 (🔢 Number): Destination point Y
- Parameter 4 (❓ Yes or No): Relative
Technical note: parameters 0, 5 are internal parameters handled by GDevelop.
Append a smooth curve
Append a cubic Bezier curve to the end of an object's path. The first control point is symmetrical to the last control point of the path.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
- Parameter 2 (🔢 Number): Second Control point X
- Parameter 3 (🔢 Number): Second Control point Y
- Parameter 4 (🔢 Number): Destination point X
- Parameter 5 (🔢 Number): Destination point Y
- Parameter 6 (❓ Yes or No): Relative
Technical note: parameters 0, 7 are internal parameters handled by GDevelop.
Append a path
Append a path to another path.
See parameters
- Parameter 1 (🔤 Name (String)): Name of the path to modify
- Parameter 2 (🔤 Name (String)): Name of the path to add to the first one
Technical note: parameters 0, 3 are internal parameters handled by GDevelop.
Append a rotated path
Append a path to another path. The appended path is rotated to have a smooth junction.
See parameters
- Parameter 1 (🔤 Name (String)): Name of the path to modify
- Parameter 2 (🔤 Name (String)): Name of the path to add to the first one
- Parameter 3 (❓ Yes or No): Flip the appended path
Technical note: parameters 0, 4 are internal parameters handled by GDevelop.
Close a path
Append a line to close the path.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
Technical note: parameters 0, 2 are internal parameters handled by GDevelop.
Create a path from SVG
Create a path from SVG commands, for instance "M 0,0 C 55,0 100,45 100,100". Commands are: M = Move, C = Curve, S = Smooth, L = Line. Lower case is for relative positions. The preferred way to build the commands is to use an external SVG editor like Inkscape.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
- Parameter 2 (string): SVG commands
Technical note: parameters 0, 3 are internal parameters handled by GDevelop.
Delete a path
Delete a path from the memory.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
Technical note: parameters 0, 2 are internal parameters handled by GDevelop.
Duplicate a path
Duplicate a path.
See parameters
- Parameter 1 (🔤 Name (String)): Name of the path to create
- Parameter 2 (🔤 Name (String)): Name of the source path
Technical note: parameters 0, 3 are internal parameters handled by GDevelop.
Invert a path
Invert a path, the end becomes the beginning.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
Technical note: parameters 0, 2 are internal parameters handled by GDevelop.
Rotate a path
Rotate a path.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
- Parameter 2 (🔢 Number): Rotation angle
Technical note: parameters 0, 3 are internal parameters handled by GDevelop.
Scale a path
Scale a path.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
- Parameter 2 (🔢 Number): Scale on X axis
- Parameter 3 (🔢 Number): Scale on Y axis
Technical note: parameters 0, 4 are internal parameters handled by GDevelop.
Speed scale Y
Change the speed scale on Y axis. This allows to change the view point of a path (top-dwon or isometry).
See parameters
- Parameter 1 (🔤 Name (String)): Path name
- Parameter 2 (🔢 Number): Speed scale on Y axis (0.5 for pixel isometry)
Technical note: parameters 0, 3 are internal parameters handled by GDevelop.
Conditions
Is closed
Check if a path is closed.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
Technical note: parameters 0, 2 are internal parameters handled by GDevelop.
Path exists
Path exists.
See parameters
- Parameter 1 (🔤 Name (String)): Path name
Technical note: parameters 0, 2 are internal parameters handled by GDevelop.
Expressions
| Expression | Description | |
|---|---|---|
CurvedMovement::ElementCount(string) |
Return the number of lines or curves that make the path. | |
| 🔤 Name (String) | Path name | |
CurvedMovement::FirstControlX(string, number) |
Return the first control point position on X axis of a curve. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Curve index | |
CurvedMovement::FirstControlY(string, number) |
Return the first control point position on Y axis of a curve. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Curve index | |
CurvedMovement::OriginX(string, number) |
Return the origin position on X axis of a curve. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Curve index | |
CurvedMovement::OriginY(string, number) |
Return the origin position on Y axis of a curve. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Curve index | |
CurvedMovement::PathAngle(string, number) |
Return the direction angle of the path for a given length (in degree). | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Length on the path | |
CurvedMovement::PathEndX(string) |
Return the displacement on X axis of the path end. | |
| 🔤 Name (String) | Path name | |
CurvedMovement::PathEndY(string) |
Return the displacement on Y axis of the path end. | |
| 🔤 Name (String) | Path name | |
CurvedMovement::PathLength(string) |
Return the length of the path. | |
| 🔤 Name (String) | Path name | |
CurvedMovement::PathX(string, number) |
Return the position on X axis of the path for a given length. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Length on the path | |
CurvedMovement::PathY(string, number) |
Return the position on Y axis of the path for a given length. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Length on the path | |
CurvedMovement::SecondControlX(string, number) |
Return the second control point position on X axis of a curve. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Curve index | |
CurvedMovement::SecondControlY(string, number) |
Return the second control point position on Y axis of a curve. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Curve index | |
CurvedMovement::SpeedScaleY(string) |
Return the speed scale on Y axis. This is used to change the view point of a path (top-dwon or isometry). | |
| 🔤 Name (String) | Path name | |
CurvedMovement::TargetX(string, number) |
Return the target position on X axis of a curve. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Curve index | |
CurvedMovement::TargetY(string, number) |
Return the target position on Y axis of a curve. | |
| 🔤 Name (String) | Path name | |
| 🔢 Number | Curve index | |
CurvedMovement::ToSvg(string) |
Return the SVG commands of a path. | |
| 🔤 Name (String) | Path name |
Movement on a curve (speed-based)
Move objects on curved paths at a given speed.
Behavior actions
Accelerate
Make an object accelerate until it reaches a given speed.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (🔢 Number): Targeted speed (in pixels per second)
- Parameter 3 (🔢 Number): Acceleration (in pixels per second per second)
Technical note: parameter 4 are internal parameters handled by GDevelop.
Accelerate during
Make an object accelerate to reaches a speed in a given amount of time.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (🔢 Number): Targeted speed (in pixels per second)
- Parameter 3 (🔢 Number): Duration (in seconds)
Technical note: parameter 4 are internal parameters handled by GDevelop.
Draw the trajectory
Draw the object trajectory.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (👾 Object): Shape painter
Technical note: parameter 3 are internal parameters handled by GDevelop.
Follow a path
Change the path followed by an object.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (🔤 Name (String)): Path name The path can be define with the "Append curve" action.
- Parameter 3 (🔢 Number): Number of repetitions
- Parameter 4 (❓ Yes or No): Loop
Technical note: parameter 5 are internal parameters handled by GDevelop.
Follow a path to a position
Change the path followed by an object to reach a position.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (🔤 Name (String)): Path name The path can be define with the "Append curve" action.
- Parameter 3 (🔢 Number): Number of repetitions
- Parameter 4 (❓ Yes or No): Loop
- Parameter 5 (🔢 Number): Destination X
- Parameter 6 (🔢 Number): Destination Y
Technical note: parameter 7 are internal parameters handled by GDevelop.
Position on the path
Change the length between the trajectory origin and the current position counting the loops.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2: 🟰 Operator
- Parameter 3 (🔢 Number): Value
Technical note: parameter 4 are internal parameters handled by GDevelop.
Speed
Change the speed of the object.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2: 🟰 Operator
- Parameter 3 (🔢 Number): Value
Technical note: parameter 4 are internal parameters handled by GDevelop.
Behavior conditions
Can move further
Check if the object can still move in the current direction.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
Technical note: parameter 2 are internal parameters handled by GDevelop.
Reach an end
Check if the object has reached one of the 2 ends of the path.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
Technical note: parameter 2 are internal parameters handled by GDevelop.
Reached path origin
Check if the object has reached the origin position of the path.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
Technical note: parameter 2 are internal parameters handled by GDevelop.
Reached path target
Check if the object has reached the target position of the path.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
Technical note: parameter 2 are internal parameters handled by GDevelop.
Current loop
Compare the number time the object loop the trajectory.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2: 🟰 Relational operator
- Parameter 3 (🔢 Number): Value to compare
Technical note: parameter 4 are internal parameters handled by GDevelop.
Position on the loop
Compare the length between the trajectory origin and the current position without counting the loops.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2: 🟰 Relational operator
- Parameter 3 (🔢 Number): Value to compare
Technical note: parameter 4 are internal parameters handled by GDevelop.
Position on the path
Compare the length between the trajectory origin and the current position counting the loops.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2: 🟰 Relational operator
- Parameter 3 (🔢 Number): Value to compare
Technical note: parameter 4 are internal parameters handled by GDevelop.
Speed
Compare the speed of the object.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2: 🟰 Relational operator
- Parameter 3 (🔢 Number): Value to compare
Technical note: parameter 4 are internal parameters handled by GDevelop.
Behavior expressions
| Expression | Description | |
|---|---|---|
Object.SpeedPathMovement::Loop() |
Return the number time the object loop the trajectory. | |
Object.SpeedPathMovement::MovementAngle() |
Return the angle of movement on its path. | |
Object.SpeedPathMovement::PathOriginX() |
Return the path origin on X axis of the object. | |
Object.SpeedPathMovement::PathOriginY() |
Return the path origin on Y axis of the object. | |
Object.SpeedPathMovement::PositionOnLoop() |
Return the length between the trajectory origin and the current position without counting the loops. | |
Object.SpeedPathMovement::PositionOnPath() |
Return the length between the trajectory origin and the current position counting the loops. | |
Object.SpeedPathMovement::Speed() |
Return the speed of the object. |
Movement on a curve (duration-based)
Move objects on curved paths in a given duration and tween easing function.
Behavior actions
Draw the trajectory
Draw the object trajectory.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (👾 Object): Shape painter
Technical note: parameter 3 are internal parameters handled by GDevelop.
Move on path
Move the object by following a path.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (🔤 Name (String)): Path name The path can be define with the "Append curve" action.
- Parameter 3 (🔢 Number): Number of repetitions
- Parameter 4 (🔢 Number): Duration in seconds
- Parameter 5 (🔤 String): Easing (one of: "linear", "easeInQuad", "easeOutQuad", "easeInOutQuad", "easeInCubic", "easeOutCubic", "easeInOutCubic", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInQuint", "easeOutQuint", "easeInOutQuint", "easeInOutSine", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInCirc", "easeOutCirc", "easeInOutCirc", "easeOutBounce", "easeInBack", "easeOutBack", "easeInOutBack", "elastic", "swingFromTo", "swingFrom", "swingTo", "bounce", "bouncePast", "easeFromTo", "easeFrom", "easeTo")
Technical note: parameter 6 are internal parameters handled by GDevelop.
Move back and forth
Move the object by following a path and go back.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (🔤 Name (String)): Path name The path can be define with the "Append curve" action.
- Parameter 3 (🔢 Number): Number of repetitions
- Parameter 4 (🔢 Number): Duration in seconds
- Parameter 5 (🔤 String): Easing (one of: "linear", "easeInQuad", "easeOutQuad", "easeInOutQuad", "easeInCubic", "easeOutCubic", "easeInOutCubic", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInQuint", "easeOutQuint", "easeInOutQuint", "easeInOutSine", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInCirc", "easeOutCirc", "easeInOutCirc", "easeOutBounce", "easeInBack", "easeOutBack", "easeInOutBack", "elastic", "swingFromTo", "swingFrom", "swingTo", "bounce", "bouncePast", "easeFromTo", "easeFrom", "easeTo")
- Parameter 6 (🔢 Number): Duration to wait before going back
- Parameter 7 (❓ Yes or No): Loop
Technical note: parameter 8 are internal parameters handled by GDevelop.
Move on path to a position
Move the object to a position by following a path.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (🔤 Name (String)): Path name The path can be define with the "Append curve" action.
- Parameter 3 (🔢 Number): Number of repetitions
- Parameter 4 (🔢 Number): Duration in seconds
- Parameter 5 (🔤 String): Easing (one of: "linear", "easeInQuad", "easeOutQuad", "easeInOutQuad", "easeInCubic", "easeOutCubic", "easeInOutCubic", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInQuint", "easeOutQuint", "easeInOutQuint", "easeInOutSine", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInCirc", "easeOutCirc", "easeInOutCirc", "easeOutBounce", "easeInBack", "easeOutBack", "easeInOutBack", "elastic", "swingFromTo", "swingFrom", "swingTo", "bounce", "bouncePast", "easeFromTo", "easeFrom", "easeTo")
- Parameter 6 (🔢 Number): Destination X
- Parameter 7 (🔢 Number): Destination Y
Technical note: parameter 8 are internal parameters handled by GDevelop.
Move back and forth to a position
Move the object to a position by following a path and go back.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
- Parameter 2 (🔤 Name (String)): Path name The path can be define with the "Append curve" action.
- Parameter 3 (🔢 Number): Number of repetitions
- Parameter 4 (🔢 Number): Duration in seconds
- Parameter 5 (🔤 String): Easing (one of: "linear", "easeInQuad", "easeOutQuad", "easeInOutQuad", "easeInCubic", "easeOutCubic", "easeInOutCubic", "easeInQuart", "easeOutQuart", "easeInOutQuart", "easeInQuint", "easeOutQuint", "easeInOutQuint", "easeInOutSine", "easeInExpo", "easeOutExpo", "easeInOutExpo", "easeInCirc", "easeOutCirc", "easeInOutCirc", "easeOutBounce", "easeInBack", "easeOutBack", "easeInOutBack", "elastic", "swingFromTo", "swingFrom", "swingTo", "bounce", "bouncePast", "easeFromTo", "easeFrom", "easeTo")
- Parameter 6 (🔢 Number): Destination X
- Parameter 7 (🔢 Number): Destination Y
- Parameter 8 (🔢 Number): Duration to wait before going back
- Parameter 9 (❓ Yes or No): Loop
Technical note: parameter 10 are internal parameters handled by GDevelop.
Behavior conditions
Finished to move
Check if the object has finished to move on the path.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
Technical note: parameter 2 are internal parameters handled by GDevelop.
Reached an end
Check if the object has reached one of the 2 ends of the path.
See parameters
- Parameter 0: 👾 Object
- Parameter 1: 🧩 Behavior
Technical note: parameter 2 are internal parameters handled by GDevelop.
Behavior expressions
| Expression | Description | |
|---|---|---|
Object.TweenPathMovement::MovementAngle() |
Return the angle of movement on its path. |
This page is an auto-generated reference page about the Curved movement extension, made by the community of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop community-made extensions here.