Cli Anything Slay The Spire Ii

作者 hkuds34f519533bc1无许可证51K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库2周前更新

Command-line interface for Slay the Spire 2 - Control the real game through a local bridge mod HTTP API. Reads normalized game state and sends action commands for combat, navigation, rewards, and menu management.

仅含说明Other
AI 生成的概览

通过本地桥接模组 HTTP API 控制《杀戮尖塔 2》,读取游戏状态并发送操作指令。

功能
提供一个有状态的命令行界面,通过本地 HTTP API 从 STS2_Bridge 模组读取规范化游戏状态,并回传操作指令。覆盖战斗、地图与房间移动、奖励、事件、休息点、商店以及卡牌或遗物选择界面。state 命令返回带 decision 字段的 JSON,用于指示当前界面并提示下一步可用命令。
适用场景
适合以程序方式驱动《杀戮尖塔 2》的实时对局,例如自动执行战斗回合、选择地图节点或领取奖励。也适合需要先检查游戏状态、再针对当前界面发出对应操作的智能体工作流。
运行要求
需要 Python 3.10+、Steam 版《杀戮尖塔 2》并启用 STS2_Bridge 模组,以及位于 localhost:15526 的本地 HTTP 桥接服务。构建桥接模组需要 .NET 9 SDK 和游戏数据目录。该技能仅包含说明文档,不附带脚本。

cli-anything-slay-the-spire-ii

A stateful command-line interface for controlling the real Slay the Spire 2 game through the local STS2_Bridge mod. The CLI reads normalized game state and sends action commands via a local HTTP API at localhost:15526.

Installation

This CLI requires a bridge mod that runs inside the game process. Both the CLI and the bridge are distributed from the same repository:

https://github.com/HKUDS/CLI-Anything

1. Install the CLI

bash
git clone https://github.com/HKUDS/CLI-Anything.gitcd CLI-Anything/slay_the_spire_ii/agent-harnesspip install -e .

2. Build and install the bridge mod

The bridge mod is a .NET 9 plugin that must be compiled and installed into the game directory. Full instructions are in the repository README, but the short version is:

bash
cd CLI-Anything/slay_the_spire_ii/agent-harness/bridge/plugin./build.shcd ../install./install_bridge.sh

If the build script cannot auto-detect the game data directory, set STS2_GAME_DATA_DIR explicitly:

bash
STS2_GAME_DATA_DIR="/path/to/data_sts2" ./build.sh

3. Enable the mod and verify

Launch Slay the Spire 2 via Steam, enable the STS2_Bridge mod in the mod manager, then verify the connection:

bash
cli-anything-sts2 state

If this returns JSON, the CLI and bridge are connected.

Prerequisites:

  • Python 3.10+
  • Slay the Spire 2 (Steam) with STS2_Bridge mod enabled
  • .NET 9 SDK (only needed to build the bridge mod)

Usage

Basic Commands

bash
# Read normalized game state (always start here)cli-anything-sts2 state
# Start interactive REPL mode (default)cli-anything-sts2
# Show all available commandscli-anything-sts2 --help

Command Groups

State Inspection

CommandDescription
stateNormalized state with decision field
raw-stateRaw bridge JSON

Main Menu

CommandDescription
continue-gameContinue a saved run
start-game --character IRONCLAD --ascension 0Start a new run
abandon-gameAbandon the current save
return-to-main-menuReturn to menu from any screen

Characters: IRONCLAD, SILENT, DEFECT, NECROBINDER, REGENT

Combat

CommandDescription
play-card <index> [--target <enemy_id>]Play a card from hand
use-potion <slot> [--target <enemy_id>]Use a potion
end-turnEnd the current turn

Map & Room Flow

CommandDescription
choose-map <index>Select a map node
proceedLeave the current room

Rewards

CommandDescription
claim-reward <index>Claim a combat reward
pick-card-reward <index>Pick a card reward
skip-card-rewardSkip the card reward
claim-treasure-relic <index>Claim a treasure relic
select-relic <index>Select a relic
skip-relic-selectionSkip relic selection

Events & Rest Sites

CommandDescription
event <index>Choose an event option
advance-dialogueAdvance dialogue-only events
rest <index>Choose a campfire action

Shop

CommandDescription
shop-buy <index>Buy from the shop

Card/Relic Selection Overlays

CommandDescription
select-card <index>Select a card in overlay
confirm-selectionConfirm the current selection
cancel-selectionCancel the current selection
combat-select-card <index>Select a card during combat overlay
combat-confirm-selectionConfirm combat card selection

Raw Action

CommandDescription
action <name> --kv key=valueSend a raw bridge action

Decision States

The state command returns JSON with a decision field indicating the current game screen. Route your next command based on this value:

DecisionMeaningTypical Next Commands
menuMain menucontinue-game, start-game
combat_playIn combat, your turnplay-card, use-potion, end-turn
hand_selectCard selection overlaycombat-select-card, combat-confirm-selection
map_selectMap node selectionchoose-map
game_overRun endedreturn-to-main-menu
combat_rewardsPost-combat rewardsclaim-reward, proceed
card_rewardCard reward pickpick-card-reward, skip-card-reward
event_choiceEvent screenevent, advance-dialogue
rest_siteCampfirerest
shopShop screenshop-buy, proceed
card_selectCard selection screenselect-card, confirm-selection
relic_selectRelic selectionselect-relic, skip-relic-selection
treasureTreasure roomclaim-treasure-relic, proceed

Configuration

OptionDefaultDescription
--base-urlhttp://localhost:15526Bridge API URL
--timeout10.0HTTP timeout in seconds

For AI Agents

  1. Always read state first to get the decision field
  2. Re-read state after each action - indices and energy change during combat
  3. Check return codes - 0 for success, non-zero for errors
  4. Parse stdout for JSON output

来源与署名

来源:hkuds/cli-anything位于skills/cli-anything-slay-the-spire-ii提交34f5195

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架