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 서버 제공.
• 장애 복구 기능: 오류 발생 시 무한 루프를 방지하기 위한 자동 회로 차단기 및 지수 백오프 메커니즘.