Home

Awesome

๐Ÿค– Setup Godot

Chickensoft Badge Discord Read the docs

Setup Godot for use with (or without) .NET on macOS, Windows, and Linux CI/CD runners.

Godot 3.x and below are not supported.

Usage

Example workflow:

name: ๐Ÿšฅ Status Checks
on: push

jobs:
  tests:
    name: ๐Ÿ‘€ Evaluate on ${{ matrix.os }}
    runs-on: ${{ matrix.os }}
    strategy:
      # Don't cancel other OS runners if one fails.
      fail-fast: false
      matrix:
        # Put the operating systems you want to run on here.
        os: [ubuntu-latest, macos-latest, windows-latest]
    env:
      DOTNET_CLI_TELEMETRY_OPTOUT: true
      DOTNET_NOLOGO: true
    defaults:
      run:
        # Use bash shells on all platforms.
        shell: bash
    steps:
      - uses: actions/checkout@v3
        name: ๐Ÿงพ Checkout

      - uses: actions/setup-dotnet@v3
        name: ๐Ÿ’ฝ Setup .NET SDK
        with:
          # Use the .NET SDK from global.json in the root of the repository.
          global-json-file: global.json

      - name: ๐Ÿ“ฆ Restore Dependencies
        run: dotnet restore

      - uses: chickensoft-games/setup-godot@v1
        name: ๐Ÿค– Setup Godot
        with:
          # Version must include major, minor, and patch, and be >= 4.0.0
          # Pre-release label is optional.
          version: 4.0.0-beta16 # also valid: 4.0.0.rc1 or 4.0.0, etc
          # Use .NET-enabled version of Godot (the default is also true).
          use-dotnet: true
          # Include the Godot Export Templtes (the default is false).
          include-templates: true

      - name: ๐Ÿ”ฌ Verify Setup
        run: |
          dotnet --version
          godot --version

      - name: ๐Ÿง‘โ€๐Ÿ”ฌ Generate .NET Bindings
        run: godot --headless --build-solutions --quit || exit 0

      - name: ๐Ÿฆบ Build Projects
        run: dotnet build

      # Do whatever you want!

Inputs

See action.yml for the complete guide to all of the action's inputs.

Specifying the Godot Version

The Godot version should be specified the same as any GodotSharp version string: e.g., 4.0.0-beta1, 4.0.0-beta.16, 4.0.0, etc.

In place of a version, you can specify global or global.json to use the version of Godot specified by the project's global.json file.

  - uses: chickensoft-games/setup-godot@v1
    name: ๐Ÿค– Setup Godot
    with:
      version: global.json # use Godot version specified by global.json

For that to work, your project must have a global.json file in the root directory with contents similar to the following.

{
  "sdk": {
    "version": "6.0.406",
    "rollForward": "latestMinor"
  },
  "msbuild-sdks": {
    "Godot.NET.Sdk": "4.0.0"
  }
}

Important: If using a global.json file in your project, do not specify the version of the Godot.NET.Sdk in your project's .csproj file. Note that Godot tends to add this back to your .csproj file every time you save the Godot project, so discard those changes before committing to source control.

<Project Sdk="Godot.NET.Sdk"> <!-- GOOD -->
<Project Sdk="Godot.NET.Sdk/4.0.0"> <!-- BAD -->