Constants Generator Plugin for Godot

The Godot plugin automatically extracts input actions, collision layers, and group names from project.godot and generates strongly-typed C# constants.

Features

• Parses project.godot to extract:
  • Input actions
  • Collision layers
  • Group names
• Automatically generates files on project settings change
• Generates static StringName constants or uint for collision layers
• Automatically infers root namespace from .csproj
• Customizable class names and location
• Optional disabling of specific categories (actions, groups, layers)
• Only updates changed files to avoid unnecessary recompilation

Installation

1. Install plugin in addons folder
2. Enable the plugin:

• Project > Project Settings > Plugins
• Build the C# project if necessary
• Enable Constants-Generator in Project > Project Settings > Plugins

Requirements

• Godot Mono 4.x
• C#/.NET project enabled

Editor Settings

You can configure the plugin under:

Editor > Editor Settings > Constants-Generator

Enable Advanced Settings in the top right and scroll down to the bottom to find the plugin settings.

Files are only written when content has changed to avoid unnecessary reimports and build noise.

Example

Each file will contain a static class like the following:

using Godot;

namespace MyGame.Constants;

public static class Actions {
    public static readonly StringName Jump = "Jump";
    public static readonly StringName Shoot = "Shoot";
}

And you can use these constants in your scripts like this:

public override void _Input(InputEvent @event) {
    if (@event.IsActionPressed(Actions.Attack)) {
        // attack
    }
    if (@event.IsActionPressed(Actions.Jump)) {
        // jump
    }
}

License

MIT License