ariki-game

Godot 4 renderer for Ariki — a Polynesian tribal chief simulator.

Connects to ariki-sim via WebSocket. The sim IS the game. This is the renderer. Never implement game logic here.

Architecture

ariki-sim (C# headless)  ←── authoritative game server (:4327 WebSocket)
      ↓ ViewerState JSON
ariki-game (Godot 4 C#)   ←── THIS REPO: renderer + UI + input
      ↓ PlayerAction JSON
ariki-sim

Three-piece engine stack: Godot fork (custom engine) + ariki-sim (game logic) + ariki-game (renderer). Full architecture: docs/.cursor/skills/ariki-engine/SKILL.md.

Deployment

Development only — runs locally on dev machines (Forge, Siren). No production/cloud deployment.

Prerequisites

Piece	Check	Install
Godot Fork	`Test-Path ~/tinqs-ltd/godot/bin/godot.windows.editor.x86_64.mono.exe`	Fetch from S3 or build from source (see below)
Ariki Sim	`curl http://localhost:4327/health`	`cd ../ariki-sim/arena && dotnet run -- serve`
.NET SDK	`dotnet --version`	dotnet.microsoft.com

Engine setup

Path A: Fetch from S3 (all machines except Forge)

.\tools\fetch-engine.ps1           # Fetch version from .engine-version
.\tools\fetch-engine.ps1 -Check    # Check if up to date

Path B: Build from source (Forge only)

# Requires: Python 3.12+, SCons, VS 2022 Build Tools (C++), .NET SDK
git clone gitea@git.arikigame.com:tinqs-ltd/godot.git ~/tinqs-godot
cd ~/tinqs-godot && git checkout tinqs-agent-modules
cd ~/tinqs-ltd/ariki-game
.\tools\build-godot.ps1             # Builds + installs to ~/tinqs-ltd/godot/

Run

# 1. Start the sim (in a separate terminal)
cd ../ariki-sim/arena && dotnet run -- serve

# 2. Build + launch the game
dotnet build
.\tools\engine.ps1 run --agent-api   # Game on :4328 (C#) + :4329 (C++)

# Or all-in-one:
./game.sh run

Tool scripts

Script	Purpose
`tools/engine.ps1`	Unified CLI: run, editor, build, test, build-engine, fetch, publish
`tools/fetch-engine.ps1`	Download engine from S3 (`s3://tinqs-cli-releases/godot/`)
`tools/build-godot.ps1`	Build engine from source (~/tinqs-godot) with prerequisite checks

Engine

Custom Godot 4.6.2 fork (tinqs-ltd/godot, branch tinqs-agent-modules) with 9 agentic C++ modules. Dual HTTP servers: :4328 C# (game-level), :4329 C++ (engine-level, with --agent-api). Pre-built binaries on S3 — no one builds from source except Forge.

Full reference: docs/.cursor/skills/godot-fork/SKILL.md

2.7 KiB Raw Permalink Blame History