create-kr-patch

레트로 게임의 한글(Korean) 팬 번역 패치를 처음부터 끝까지 만드는 Agent Skill이다. ROM·디스크 분석부터 텍스트 엔진 역공학, 한글 폰트·인코딩 설계, PoC, 번역·재삽입, 포인터·ASM 훅, 빌드·에뮬레이터 검증까지 한글 패치 전 과정에서 내려야 할 판단을 다룬다.

An Agent Skill for building Korean fan-translation patches for retro games, with guidance for decisions across ROM/disc analysis, patch development, and emulator verification. Methodology only — contains no copyrighted ROM data or game assets.

지원 플랫폼

Game Boy·Game Boy Color, NES·Famicom, SNES, 메가드라이브, 세가 새턴, PlayStation, Dreamcast, PC Engine, PC-98, Game Gear, Nintendo DS에는 플랫폼별 문서가 따로 있다. 목록에 없는 플랫폼에도 적용할 수 있다.

프로젝트 템플릿

새 한글 패치 저장소를 시작할 때는 create-kr-patch-template을 선택적으로 쓸 수 있다. 이 스킬은 조사부터 빌드·검증·배포 판정까지 필요한 기준을 제시한다. 템플릿은 그 기준을 새 저장소의 기본 구조와 실행 진입점에 반영한 뼈대다. 플랫폼과 구현 언어는 고정하지 않는다.

설치 — Claude Code 세션

/plugin marketplace add mcpads/create-retro-game-kr-patch@main
/plugin install create-kr-patch@kr-patch

설치 — Codex 세션

codex plugin marketplace add mcpads/create-retro-game-kr-patch --ref main
codex plugin add create-kr-patch@kr-patch

릴리스 채널과 채널 전환

• main: 최신 안정 릴리스 채널이다. 검증을 마치고 정식 버전으로 확정한 변경만 반영한다.
• next: 다음 안정 릴리스를 준비하는 프리릴리스 채널이다. alpha·beta·rc를 먼저 사용해 보고 의견을 남기려는 사용자를 위한 채널이며, 정식 릴리스 전에는 호환성과 문서 구조가 바뀔 수 있다.

next는 최신 개발 상태를 계속 따라간다. 특정 프리릴리스 상태가 필요하면 버전 태그를 사용한다. 두 채널은 같은 플러그인 ID를 쓰므로 동시에 설치하지 말고, 기존 marketplace가 가리키는 Git ref를 원하는 채널로 바꾼다.

Claude Code에서 next로 바꾸려면:

/plugin marketplace remove kr-patch
/plugin marketplace add mcpads/create-retro-game-kr-patch@next
/plugin install create-kr-patch@kr-patch
/reload-plugins

Codex에서 next로 바꾸려면:

codex plugin remove create-kr-patch@kr-patch
codex plugin marketplace remove kr-patch
codex plugin marketplace add mcpads/create-retro-game-kr-patch --ref next
codex plugin add create-kr-patch@kr-patch

안정판으로 돌아가려면 같은 순서에서 next를 main으로 바꾼다. 같은 채널의 최신 내용을 받을 때도 marketplace를 갱신한 뒤 플러그인을 업데이트하거나 다시 설치한다. Claude Code는 reload 이후, Codex는 새 스레드부터 선택한 버전을 적용한다.

설치한 뒤 레트로 게임을 한글화해 달라고 요청하면 Agent Skill이 발동한다. 한글화, 한글패치, ROM 번역 어느 표현을 써도 된다. 새 조사를 시작할 때와 기존 프로젝트를 이어 갈 때 모두 적용된다.

구조

plugin metadata           # 플러그인 매니페스트와 셀프호스팅 마켓플레이스 설정
skills/
  create-kr-patch/
    SKILL.md             # 최상위 원칙 + 작업 원칙 + 영역별 라우팅
    references/
      strategy/          # 판단 영역별 기준과 검증 방법
      conventions/       # 저장소 역할·데이터·기록 시행 규약
      platforms/         # 플랫폼별 분기를 바꾸는 사실·제약 11종
      tips/
        general/         # 플랫폼 규칙 없이 적용되는 사례별 파일
        platforms/       # 플랫폼 규칙이 있어야 성립하는 사례별 파일

SKILL.md가 진입점이다. 먼저 플레이어 경험을 지키는 최상위 원칙과 긴 작업의 방향을 잡는 세 가지 작업 원칙을 제시한다. 여기서 지금 하려는 일에 맞는 세부 지침과 검증 기준으로 이어진다.

기여

새 플랫폼 문서나 전략 보강은 PR로 환영한다. 이 스킬의 기여 철학과 문서 작성 기준은 CONTRIBUTING.md를 따른다.

버전

현재 버전과 버전별 변경 내용은 CHANGELOG를 본다.

라이선스

MIT © 2026 mcpads