sts2-agent

English | 简体中文

sts2-agent is an Agent/Mod prototype for Slay the Spire 2. It combines an in-game C# bridge mod, Python-side policies and orchestrator code, and local debugging tools for future LLM-driven autoplay.

What This Repo Includes

• src/sts2_agent/: Python bridge client, policies, orchestrator, traces
• mod/Sts2Mod.StateBridge/: in-game STS2 bridge mod
• mod/Sts2Mod.StateBridge.Host/: local host for fixture/runtime-host validation
• tests/: Python tests
• tools/: build, install, validate, and live-debug scripts
• docs/: detailed setup, validation, compatibility, and upgrade notes

Requirements

• Python 3.11+
• .NET SDK 9
• Godot 4.5.1
• Windows install of Slay the Spire 2

Quick Start

Build the mod against a real STS2 install:

dotnet build mod/Sts2Mod.StateBridge.sln \
  -p:Sts2ManagedDir="F:\\SteamLibrary\\steamapps\\common\\Slay the Spire 2\\data_sts2_windows_x86_64" \
  -p:Sts2ModLoaderDir="F:\\SteamLibrary\\steamapps\\common\\Slay the Spire 2\\data_sts2_windows_x86_64"

Install and launch the bridge mod:

python tools/debug_sts2_mod.py install --game-dir "F:\\SteamLibrary\\steamapps\\common\\Slay the Spire 2"
python tools/debug_sts2_mod.py debug --game-dir "F:\\SteamLibrary\\steamapps\\common\\Slay the Spire 2"

Run Python tests:

$env:PYTHONPATH='src'; python -m unittest discover -s tests -v

Bridge API

Once loaded in-game, the bridge exposes:

• GET /health
• GET /snapshot
• GET /actions
• POST /apply
• GET/POST/DELETE /agent-status

Writes are disabled by default. Enable them explicitly before live action testing.

Key Docs

• docs/sts2-mod-local-development.md: build, install, live debugging, and validation
• docs/sts2-mod-upgrade-notes.md: mod migration notes after game updates
• docs/sts2-mod-agent-compatibility.md: current bridge/runtime compatibility notes
• docs/local-development.md: local Python-side workflow notes
• docs/prototype-validation.md: fixture/prototype validation details

Encoding Note

• Chinese docs and OpenSpec artifacts use UTF-8 without BOM.
• Avoid writing Chinese files through PowerShell text pipes; that may produce ???.