CharTyr/STS2-Agent

何を解決するか

このプロジェクトは、Slay the Spire 2 用のAIパワードコンパニオンおよび自律プレイモッドを提供します。プレイヤーはLLMによってゲームが自動でプレイされるのを、または自然言語による協調を可能にするAIチームメイトと協力プレイする選択ができます。また、ゲーム内チャットインターフェースを通じて戦略的アドバイスも受けられます。

動作方法

モッドはF8キーでアクセス可能なC#ベースのゲーム内オーバーレイを統合し、OpenAI互換のLLMエンドポイント（DeepSeek、OpenAI、Ollamaによるローカルモデルなど）に接続します。コンパクトなステートエンジンを使用して、カード、エネルギー、敵の意図などのゲームデータをAIが理解できる形式に変換します。自律プレイでは、AIがリアルタイムの状態を評価し、アクションを実行します。協力プレイでは、AIのキャラクターとして動作する別々のゲームインスタンスを起動します。また、外部エージェント（CursorやClaude Desktopなど）がゲームと連携できるように、FastMCPサーバーとローカルHTTP APIも含まれています。

対象ユーザー

• デッキビルディングゲームをAIエージェントが自律的にプレイする実験をしたいプレイヤー。
• 自然言語で協調できるAIチームメイトを探している協力プレイプレイヤー。
• AIエージェントやエージェントのツールコール能力をテストする環境としてゲームを利用したい開発者。

特徴

• 自律自動プレイ：テキストのみまたはビジュアル拡張モデルを使用して、戦闘、デッキ選択、経路選択を完全に自動化。
• ローカル協力AIチームメイト：ワンクリックで別インスタンスを起動し、協調可能なAIパートナーを迅速に導入。
• ゲーム内オーバーレイUI：ゲーム内に直接設定・制御可能なウィンドウを提供。
• 予算ガード：予期しないAPIコストを防ぐためのトークンおよびリクエストの会計機能を内蔵。
• 開発者ツール：外部エージェントとの連携を可能にするローカルHTTP APIとFastMCPサーバー。
• 障害回復：障害時の無限ループを防ぐための自動回路ブレーカーと指数バックオフ機構。