GodotOperations 1.1.5

👁 Preview

👁 NuGet

Operations provides a quick and efficient way to programmatically create animations and complex behavior trees in the Godot game engine. A large collection of built-in operations are provided, with custom operations being very easy to make. It is available in both C# and GDSCript.

For API usage and examples, see either the GDScript README or the C# README. The two APIs are essentially identical - with minor differences due to GDSCript language limitations. The only major difference is that operations are not pooled in GDScript.

Quick Example

Example usage for the death animation of a 2D character may look like this:

C#

using static Operations.Op;

Node character = ...;
Operation op =
 Sequence(
 NodeMove2D(new(0, 32), 2.0f),
 Parallel(
 NodeScale2D(new(2.0f, 2.0f), 1.0f),
 NodeRotate2D(90.0f, 1.0f)),
 NodeModulate(new(1, 0, 0, 0), 1.0f),
 Wait(1.0f),
 Free()
 ).SetTarget(character);

GDScript

var character = ...
var op =
 Op.sequence(
 Op.node_move2D(Vector2(0, 32), 2.0),
 Op.parallel(
 Op.node_scale2D(Vector2(2.0, 2.0), 1.0),
 Op.node_rotate2D(90.0, 1.0)),
 Op.node_modulate(Color(1, 0, 0, 0), 1.0),
 Op.wait(1.0),
 Op.free()
 ).set_target(character)

Installation

Copy either OperationsScript or OperationsSharp from the addons folder into the addons folder of your project. Read more about installing and enabling addons here. The C# version is alternatively available as a Nuget package. Note that to use the demo you will have to git clone the repo, since the artifact is setup for use with the Godot Asset Library.

Licensing

Operations is licensed under MIT - you are free to use it however you wish.

Do note, however, that all classes in Pools.cs are modified from libGDX, which is licensed under the Apache License, Version 2.0. See the pools folder for more information. The demo project uses assets from Kenney's CC0 licensed Shape Characters and Toy Car Kit asset packs.

The banner logo uses the Forced Square font.