GodotConstantsGenerator 1.0.1

Godot Constants Generator

A .NET CLI tool that extracts input actions, collision layers, and group names from your project.godot and generates strongly-typed C# constants.

Features

• Parses project.godot to extract:
  • Input actions
  • Collision layers
  • Group names
• Generates static StringName constants or uint for collision layers
• Automatically infers namespace from .csproj or accepts manual override
• Customizable output filenames and locations
• Optional disabling of specific categories (actions, groups, layers)

Installation

dotnet tool install --global GodotConstantsGenerator

Usage

To run the tool, use the following command in your terminal or command prompt:

godot-constants [options]

It works without any parameters, all options are optional.
If no parameters are provided, it will infer the project name from the .csproj file and generate all files in the scripts/generated directory.

Options

Example

dotnet run --project GodotConstantsGenerator \
  --project MyGame \
  --output ./src/Generated \
  --namespace MyGame.Constants

This will generate:

• src/Generated/Actions.cs
• src/Generated/Groups.cs
• src/Generated/CollisionLayers.cs

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";
}

Requirements

• Godot 4.x - (tested on 4.4.1)
• .NET 8.0 or later
• Must be run from the root of your Godot project (where project.godot and .csproj are located)

Building

dotnet pack --output ./nupkg
dotnet tool install --global GodotConstantsGenerator --add-source ./nupkg

License

MIT License