Write Godot scripts in Odin. odin_godot is a Godot 4.6 GDExtension that implements the full ScriptLanguageExtension API, so a .odin file is a first-class Godot script — attach one to a Node and its _ready / _process / signals / @export vars run as compiled, AOT native Odin, dispatched through a typed registry (no interpreter, no per-call string marshalling). It is built to replace GDScript for a project: lifecycle, @export of every Variant type, custom methods, signals, extends any class, custom resources, autoloads, @tool/editor plugins, multiplayer RPCs, hot reload, and native + WebAssembly export — all reproducible from a single Nix flake.

Status: working engine. nix develop --command bash tests/run_all.sh is green across a 39-test end-to-end suite (every feature below, plus the showcase, the examples' co-op runs, and the Asset-Library drop-in layout), plus 7 browser-gated web tests that verify the WASM export in a real headless Chrome when one is available. The headline examples are a pure-Odin coin-collector (tests/showcase/), a complete top-down arena shooter (examples/survivors/), and a peer-authoritative co-op arena (examples/coop_arena/) — zero GDScript gameplay code.

//gd:extends Area2D            // base Godot class
//gd:class Coin                // global class_name
package game_scripts

import gd "godot:godot"

Coin :: struct {
	owner:     gd.Area2d,                        // first field = the node, always
	collected: gd.Signal1(int) `gd:"args=value"`, // typed signal field -> collected(value: int)
	value:     gd.Int `gd:"export,range=1:100"`, // @export var with an Inspector slider
	taken:     bool,                             // untagged = private per-instance state
}

coin_ready :: proc(self: ^Coin) {            // lifecycle, matched by name
	if self.value == 0 { self.value = 1 }
}

// Auto-wire body_entered -> this method on _ready (no manual connect call):
@(gd_method, gd_connect = "body_entered")
coin_collect :: proc(self: ^Coin, body: gd.Node2d) {
	if self.taken { return }
	self.taken = true
	coin_emit_collected(self, i64(self.value))   // typed emitter generated from the signal field
	gd.node_queue_free(self.owner)               // gd.* ergonomic helper
}

You get the whole engine API as typed Odin (the generated godot binding), a curated gd.* ergonomic layer for the common one-liners, and GDScript parity for the things that matter:

Because Odin is ahead-of-time compiled there are honest, inherent differences from interpreted GDScript — no eval/REPL, no in-editor breakpoints (use lldb), and @export changes need a recompile (the editor does it for you on save). These are documented up front, not hidden — see Workflow.

nix develop                  # toolchain shell: odin, ols, emcc, llvm/lld, + $GODOT (4.6.2)

# Build the extension + the example's scripts, then play it:
bash build/build_scripts.sh examples/survivors
$GODOT --path examples/survivors          # arrow keys move; auto-fire; survive

# Or verify everything headless (reproducible from one command):
nix develop --command bash tests/run_all.sh

==> phase1  PASS   ==> resources    PASS   ==> editortools  PASS
==> phase2  PASS   ==> crossscript  PASS   ==> debug        PASS
   ...                  ...                    ...
==> survivors PASS ==> web          PASS browser-verified   ALL GREEN

New here? Start with Getting Started — it installs the toolchain, wires the extension into a Godot project, and walks you through your first Odin script from empty file to a moving node.

• examples/survivors/ — a complete top-down arena shooter in pure Odin; each script is commented to teach one slice of the binding (README).
• examples/coop_arena/ — the canonical co-op / multiplayer reference: ONE peer-authoritative codebase that runs single-player, over native ENet, and in the browser over WebRTC (room-code lobby) (README).
• tests/showcase/ — a minimal pure-Odin coin-collector; the smallest "everything wired" scene. Run it: $GODOT --path tests/showcase.
• examples/hello/ — the lowest-level path: a hand-registered GDExtension class (not a script) proving the Odin↔GDExtension ABI.

The distributable is a drop-in addon: addons/odin_godot/ with prebuilt core dlls, the docs, the build scripts, and a starter template. Get it from the release branch (what the Godot Asset Library entry points at) or build it yourself with nix build .#release, then follow Distribution → Install into a Godot project. The one host tool you need is the odin compiler (the addon README names the exact pinned release).

macOS is the development platform and is verified end-to-end by the suite (including the Asset-Library drop-in layout and the web export). Windows ships prebuilt core dlls and builds scripts natively via build_scripts.ps1, with limited runtime verification so far; Linux is build-verified only. Reports from either platform are very welcome — the crash reporter and build scripts are designed to produce actionable output, so please file what you see.

Apache-2.0 — see LICENSE and NOTICE. The binding generator + C-ABI runtime were vendored from dresswithpockets/odin-godot (Apache-2.0); attribution and provenance are kept in bindgen/ATTRIBUTION.md.