https://github.com/netcan/slay-the-spire2-agent
面向《Slay the Spire 2》的 Agent/Mod 原型仓库，目标是把游戏内状态抽取、动作接口、自动决策和调试工具串起来，为后续接入大模型自动打牌提供稳定基础。
https://github.com/netcan/slay-the-spire2-agent
Last synced: 20 days ago
JSON representation
面向《Slay the Spire 2》的 Agent/Mod 原型仓库，目标是把游戏内状态抽取、动作接口、自动决策和调试工具串起来，为后续接入大模型自动打牌提供稳定基础。
- Host: GitHub
- URL: https://github.com/netcan/slay-the-spire2-agent
- Owner: netcan
- Created: 2026-03-13T15:55:21.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-14T00:54:18.000Z (3 months ago)
- Last Synced: 2026-03-14T04:55:50.675Z (3 months ago)
- Language: C#
- Size: 198 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# sts2-agent
English | [简体中文](README.zh.md)
`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:
```bash
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:
```bash
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:
```bash
$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 `???`.