Godot Motion

This add-on animates any property or method using easing and continuous physics-based transition.

Motion \
	.tween(self, "position") \
	.trans_elastic() \
	.to(Vector2(500.0, 500.0))

Important

Godot Task and Godot Easing must be installed before using this add-on.

Objective

It was created for the following purposes:

• Easy to use as Tween.
• When rescheduling, velocity is preserved and curves are smoothly connected (limited to physics-based animations: tween and exponential decay).
• Animation curves can be configured from preset resources, making them easy for designers to maintain.

Usage

There are two types of motion:

• Physics-based motion: An animation where the duration are determined from the initial velocity at the start
• Easing: An animation that interpolates from the start position (or current position) to the end position over a fixed duration

These motions can be started using the Motion class.

Physics-based motion

Type	Method name
Spring	Motion.spring()
Exp. Decay	Motion.decay()

Easing

Type	Method name
Back	Motion.back()
Bezier	Motion.bezier()
Elastic	Motion.elastic()
Linear	Motion.linear()
Power	Motion.power()
Random	Motion.random()
Steps	Motion.steps()

When the addon is enabled, the Motion class and MotionPresetBank node become available.

Each Motion method returns an expression (MotionExpression). The expression has multiple self-returning methods, and calling these methods to configure the motion:

Motion \
	.tween(self, "position:x") \
	.duration(5.0) \
	.trans_cubic() \
	.ease_in() \
	.to(150.0)

As an exception, the wait() method is used to pause until the motion completes.

Using MotionPresetBank

This section explains how to use shared motion configurations via MotionPresetBank.

Place a MotionPresetBank node in the scene tree as shown below:

Open the Inspector, add a MotionPreset, and configure it. (The preset_name property is required!) You can have multiple presets with the same preset_name for each preset type. In that case, you can adjust the selection probability using probability.

At the appropriate timing, call the corresponding Motion method to start the animation.

func _on_button_pressed() -> void:
	Motion \
		.tween($Button, "scale") \
		.preset("QUINT_IN") \
		.to(Vector2.ONE * 2.0)

License

All contents of this project are licensed under the attached 🔗 MIT license.

Attribution

Attribution is not required, but appreciated. If you would like to credit, please attribute to "Ydi".