기술 문서
게임을 스크립트로 조작하거나 디버그하거나 확장하려는 플레이어와 개발자를 위한 자료입니다.
도구와 디버깅
- AI 에이전트로 게임 조작하기 (MCP)Claude Code 등 MCP 클라이언트를 실행 중인 게임에 연결해 상태를 읽고, 스크린샷을 찍고, 키를 누르고, 메뉴를 조작하고, 메모리를 읽거나 쓸 수 있습니다.
- 미니 스테이지맵, 그 위의 기체, 이벤트 스크립트를 JSON 파일 하나에 적고, 시나리오 대신 곧바로 진입해 전투, 화면, 스크립트 명령을 재현합니다. MCP로만 불러올 수 있습니다.
- 스테이지 스크립트 명령 레퍼런스스테이지 이벤트 스크립트의 모든 명령, 조건, 컨텍스트 마커, 이벤트 타입, 변수, 출격 레코드 필드를 정리했습니다. 미니 스테이지를 만들 때 참고하세요.
모드 가이드
- MOD 패키지: 설치와 제작MOD 패키지가 무엇인지, 설치하고 관리하는 방법, 직접 만들 때 mod.json을 쓰는 방법을 설명합니다. 음악과 전투음성, 능력치, 이름, 초상화, 맵 아이콘, 캠페인, 스토리 이벤트, 언어 패키지가 적용됩니다.
- 음악 MOD게임의 49곡 중 어느 곡이든 직접 준비한 음악으로 바꾸고, 루프, 음량, 곡명을 설정하고, 파일럿이나 기체의 전투곡을 고르고, 전투 대사에 음성을 붙입니다. 웹 도구로 만들거나 직접 작성할 수 있습니다.
- 수치 MOD기체, 파일럿, 무기의 수치(HP, 장갑, 능력치, 지형 적응, 특수능력, 특수기능, 정신기, 무기 공격력과 사거리)를 번호로 지정해 바꿉니다. 전투에서 지형 적응을 합산하는 방법과 변경이 적용되는 시점도 설명합니다.
- 이름·초상화·맵 아이콘 MOD원작 주인공, 파트너, 부대의 이름을 바꾸고, 파일럿·기체·무기의 이름을 바꾸고, 파일럿 초상화와 기체의 맵 아이콘을 교체합니다. 표시되는 것만 바뀌며 세이브에는 아무것도 기록하지 않습니다.
- 스토리 MOD원작 스테이지에 이벤트를 추가합니다. 언제 발생하는지, 무엇이 충족되어야 하는지, 무엇을 하는지, 어떤 새 대사를 말하는지 적습니다. 원작 이벤트 슬롯을 차지하거나 원작 이벤트를 건드리지 않고도 캐릭터를 합류시키거나 남게 하고 스토리 분기를 바꿀 수 있습니다.
- 캠페인 MOD (추가 시나리오)직접 구성한 스테이지를 캠페인으로 엮습니다. 동료 합류, 스테이지 사이의 인터미션, 스토리 선택지와 엔딩을 갖추고, 별도의 세이브를 쓰는 .srw64mod로 묶습니다. 현재는 원작의 맵, 캐릭터, 기체, 대사만 사용할 수 있습니다.
- 언어 패키지 MOD게임에 새 읽기 언어(한국어, 프랑스어…)를 추가하거나, 기존 언어의 UI 텍스트, 이름, 대사를 교체합니다. 번역하지 않은 부분은 직접 고른 대체 언어로 표시됩니다.