Workstation Setup

July 2, 2026 · View on GitHub

Shared workstation setup for the consolidated Godogen source repo.

.NET 9 SDK

Godot 4.5+ requires .NET 9.

Linux (Ubuntu/Debian)

wget -q https://dot.net/v1/dotnet-install.sh -O /tmp/dotnet-install.sh
chmod +x /tmp/dotnet-install.sh
/tmp/dotnet-install.sh --channel 9.0 --install-dir ~/.dotnet

Add to ~/.bashrc:

export PATH="$HOME/.dotnet:$PATH"
export DOTNET_ROOT="$HOME/.dotnet"

macOS

brew install dotnet@9

Rust

Bevy projects require a current Rust toolchain:

rustup update stable
cargo --version
rustc --version

Node.js And Browser

Babylon.js projects require Node.js 22.12+ and npm:

node --version
npm --version

Browser capture requires Chrome or Chromium with hardware WebGL2. Install one system browser and set CHROME_BIN if it is not on a common path:

command -v google-chrome || command -v chromium || command -v chromium-browser
export CHROME_BIN=/path/to/chrome

Babylon capture prefers hardware WebGL2. A fallback to a software renderer (SwiftShader, llvmpipe, lavapipe, etc.) on a GPU-equipped host means the browser GPU path is misconfigured and worth fixing; on a GPU-less host it still captures, at reduced quality and speed.

System Packages

sudo apt-get install vulkan-tools xvfb ffmpeg imagemagick
  • vulkan-tools — vulkaninfo for GPU validation
  • xvfb — virtual X11 display for headless Godot/Bevy runs and capture
  • ffmpeg — MP4 encoding of proof videos and sprite frame extraction
  • imagemagick — image resize, flip, crop for sprite pipelines

On macOS:

brew install coreutils ffmpeg dotnet@9

Python

Requires Python 3.10+.

python3 --version
pip install -r asset-gen/tools/requirements.txt
pip install google-genai

In a published game repo, the same asset-generation requirements file lives at:

  • .claude/skills/asset-gen/tools/requirements.txt for Claude Code
  • .agents/skills/asset-gen/tools/requirements.txt for Codex

google-genai is required by asset_gen.py for Gemini image generation.

Godot (.NET edition)

The .NET edition is required for Godot projects. The standard Godot build cannot run C# scripts.

Linux

VERSION=$(curl -s https://api.github.com/repos/godotengine/godot/releases/latest | grep -oP '"tag_name": "\K[^"]+' | sed 's/-stable//')
echo "Installing Godot .NET $VERSION"
cd /tmp
wget https://github.com/godotengine/godot/releases/download/${VERSION}-stable/Godot_v${VERSION}-stable_mono_linux_x86_64.zip
unzip Godot_v${VERSION}-stable_mono_linux_x86_64.zip
sudo mv Godot_v${VERSION}-stable_mono_linux_x86_64/Godot_v${VERSION}-stable_mono_linux.x86_64 /usr/local/bin/godot
sudo mv Godot_v${VERSION}-stable_mono_linux_x86_64/GodotSharp /usr/local/bin/GodotSharp

GodotSharp/ must live next to the godot binary. Godot resolves it relative to itself.

macOS

brew install --cask godot-mono
sudo ln -sf /Applications/Godot_mono.app/Contents/MacOS/Godot /usr/local/bin/godot

Verify

dotnet --version                 # 9.0.x
godot --version                  # 4.x.x.stable.mono
godot --headless --quit          # may show harmless RID warnings

If godot --headless --quit crashes with assembly errors, check that GodotSharp/ is next to the binary:

ls "$(dirname "$(which godot)")"/GodotSharp/

API Keys

Set in environment:

  • GOOGLE_API_KEY — Gemini image generation
  • XAI_API_KEY — xAI Grok image/video generation
  • TRIPO3D_API_KEY — image-to-3D conversion

Verify Rendering

VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/nvidia_icd.json vulkaninfo --summary 2>&1 | grep "deviceName"
xvfb-run -a godot --headless --quit