76 lines
2.9 KiB
Bash
Executable file
76 lines
2.9 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
# Generic external-player JSON-Lines harness for Magic Civilization.
|
|
#
|
|
# Spawns Godot headless with the `player_api_main` scene and pipes
|
|
# stdin/stdout. Any client that speaks the JSON-Lines wire protocol
|
|
# documented in `src/game/engine/docs/PLAYER_API.md` can drive a game
|
|
# slot through this harness — Claude Code via the
|
|
# `tooling/claude-player-mcp/` adapter, an OpenSpiel/RL trainer via a
|
|
# Python `subprocess.Popen`, a smoke-test shell script, etc.
|
|
#
|
|
# Env vars (see PLAYER_API.md for the full schema):
|
|
# CP_SEED, CP_PLAYERS, CP_CLAUDE_SLOT, CP_MAP_SIZE, CP_MAP_TYPE,
|
|
# CP_OMNISCIENT, CP_TIMEOUT_SEC, CP_LOG_FILE.
|
|
#
|
|
# `CP_CLAUDE_SLOT` is the env-var name the harness has used since p2-67;
|
|
# it identifies the externally-controlled player slot — kept as-is for
|
|
# backward compatibility with existing clients. Despite the name it is
|
|
# not Claude-specific.
|
|
#
|
|
# Exit code 0 on clean shutdown (shutdown request received or stdin EOF).
|
|
# Non-zero on protocol error or harness crash.
|
|
|
|
set -uo pipefail
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
|
|
|
|
# Defaults — adapter overrides via env.
|
|
: "${CP_SEED:=42}"
|
|
: "${CP_PLAYERS:=2}"
|
|
: "${CP_CLAUDE_SLOT:=0}"
|
|
: "${CP_MAP_SIZE:=duel}"
|
|
: "${CP_MAP_TYPE:=continents}"
|
|
: "${CP_OMNISCIENT:=0}"
|
|
: "${CP_TIMEOUT_SEC:=60}"
|
|
: "${CP_LOG_FILE:=}"
|
|
|
|
# Pure-headless mode — no Wayland needed. JSON-Lines speaks to stdout.
|
|
#
|
|
# Linux uses flatpak Godot (matches the rest of the apricot pipeline).
|
|
# macOS uses the locally-installed `godot` binary (Homebrew); a parallel
|
|
# flatpak runtime just for this harness is silly when native Godot 4
|
|
# works directly. Env-var passthrough is automatic for the native path.
|
|
export CP_SEED CP_PLAYERS CP_CLAUDE_SLOT CP_MAP_SIZE CP_MAP_TYPE \
|
|
CP_OMNISCIENT CP_TIMEOUT_SEC CP_LOG_FILE
|
|
|
|
case "$(uname -s)" in
|
|
Darwin)
|
|
GODOT_BIN="${GODOT_BIN:-godot}"
|
|
if ! command -v "$GODOT_BIN" >/dev/null 2>&1; then
|
|
echo "ERROR: no godot binary on PATH (set GODOT_BIN or 'brew install godot')." >&2
|
|
exit 1
|
|
fi
|
|
exec "$GODOT_BIN" \
|
|
--path "$PROJECT_DIR/src/game" \
|
|
--headless \
|
|
--rendering-method gl_compatibility \
|
|
res://engine/scenes/headless/player_api_main.tscn
|
|
;;
|
|
*)
|
|
exec flatpak run --user \
|
|
--env=CP_SEED="$CP_SEED" \
|
|
--env=CP_PLAYERS="$CP_PLAYERS" \
|
|
--env=CP_CLAUDE_SLOT="$CP_CLAUDE_SLOT" \
|
|
--env=CP_MAP_SIZE="$CP_MAP_SIZE" \
|
|
--env=CP_MAP_TYPE="$CP_MAP_TYPE" \
|
|
--env=CP_OMNISCIENT="$CP_OMNISCIENT" \
|
|
--env=CP_TIMEOUT_SEC="$CP_TIMEOUT_SEC" \
|
|
--env=CP_LOG_FILE="$CP_LOG_FILE" \
|
|
org.godotengine.Godot \
|
|
--path "$PROJECT_DIR/src/game" \
|
|
--headless \
|
|
--rendering-method gl_compatibility \
|
|
res://engine/scenes/headless/player_api_main.tscn
|
|
;;
|
|
esac
|