2026-01-28 16:18:08 +01:00
2026-01-28 15:59:13 +01:00
2026-01-28 16:18:08 +01:00

Setup Godot Action

This GitHub Action automates the setting up of Godot Mono.

Requirements

Godot Compatibility

  • Godot 4.x (4.0.0 and above)
  • .NET versions supported

System Requirements

  • GitHub Actions runner (Ubuntu latest recommended)
  • Git with LFS support for larger projects

Usage

The action can be configured using various inputs to suit your testing needs. Here's a basic usage pattern:

- name: Setup Godot
  id: setup-godot
  uses: https://git.game-dev.space/minimata/setup-godot.git@main
  with:
      godot-version: '4.6'       # Required: Godot version to use
      dotnet-version: 'net9.0'   # Optional: Dotnet framework version

Ouputs

The action outputs the location of the Godot bin under the name godot_bin

- name: Setup Godot
  id: setup-godot
  uses: https://git.game-dev.space/minimata/setup-godot.git@main
  with:
      godot-version: '4.5.1'
          
- name: Import resources and build solution
  run: |
    ${{ steps.setup-godot.outputs.godot_bin }} --headless --editor --build-solutions --quit --import --path $PWD

Configuration

Godot Configuration

Parameter Required Default Description
godot-version Yes Godot version (e.g., "4.2.1")
godot-status No stable Godot status (stable/rc1/dev1)
project_dir No ./ The project directory in which the action is to be executed. The specified directory must end with a path separator. e.g. ./MyProject/

.NET Configuration

Parameter Required Default Description
dotnet-version No net8.0 .NET version (net7.0/net8.0)

Performance Optimization

Caching

The action automatically caches:

  • Godot binaries
  • .NET packages
  • Project cache
Description
No description provided
Readme 31 KiB