create-kr-patch

레트로 게임의 한글(Hangul) 팬 번역 패치를 처음부터 끝까지 만드는 Claude Code skill. ROM/디스크 분석 → 텍스트 엔진 역공학 → 한글 폰트·인코딩 설계 → PoC → 텍스트 추출·번역·재삽입 → 포인터 재배치·ASM 훅 → 빌드·패치 생성 → 에뮬레이터 검증까지의 전 파이프라인을 다룬다.

A Claude Code skill for building Korean fan-translation patches for retro games, covering the full pipeline from ROM/disc analysis to emulator verification. Methodology only — contains no copyrighted ROM data or game assets.

지원 플랫폼

목록에 없는 플랫폼도 strategy 축의 조사 순서·검증 원칙을 출발점으로 삼아 새 플랫폼 문서를 작성하며 확장한다.

설치 (Claude Code)

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

설치 후 한글화·한글 패치 관련 요청을 하면 skill이 자동으로 발동한다. 트리거 키워드: 한글화, 한글 패치, KR patch, ROM 번역 등.

구조

.claude-plugin/
  plugin.json            # 플러그인 매니페스트
  marketplace.json       # 이 repo를 셀프호스팅 마켓플레이스로
skills/
  create-kr-patch/
    SKILL.md             # 라우팅 + 핵심 불변식 (본문은 얇게)
    references/
      strategy/          # 단계별 공통 전략 12종
      platforms/         # 플랫폼별 하드웨어·사례 노트 8종

SKILL.md는 라우터·불변식만 담고, 실제 판단 기준·절차는 references/ 문서에 있다. Claude는 단계·플랫폼에 따라 필요한 참조문서만 그때그때 읽는다.

핵심 원칙

• 원본 ROM·디스크 이미지·저작 자산은 절대 커밋하지 않는다. 저장소에는 패치 파일·스크립트·번역 데이터만 둔다. (.gitignore로 강제)
• 라운드트립 검증 우선 — 추출→재조립이 바이트 단위로 원본과 동일함을 증명한 뒤에야 수정에 들어간다.
• PoC 통과 전 본 구현 금지 — 한글 1자가 실제 게임 화면에 나오기 전까지 되돌리기 비싼 작업은 시작하지 않는다.

기여

새 플랫폼 문서나 전략 보강은 PR로 환영한다. 플랫폼 문서는 기존 8종의 9~10절 목차(개요 → 메모리 맵 → 비디오·폰트 → 텍스트 엔진 → 한글 인코딩 → 패치 패턴 → 빌드 → 검증 → 사례)를 따른다.

버전

현재 0.3.0. 전체 변경 이력은 CHANGELOG를 본다.

• 0.3.0 — 닌텐도 DS 플랫폼 문서 추가(mirusu400, PR #1). 복수 렌더 타깃의 폰트 설정 외부화 패턴 보강(font-strategy §8).
• 0.2.0 — 문서 톤 정리(실적 과시·빈권위·사적 게임 일화 제거, 사례성 유지)와 보강(실패 교훈, 글리프 예산 측정 절차, 검증 자동화 현실, 번역 검출 게이트, EDC/ECC 카피 프로텍션 경고).
• 0.1.0 — 최초 공개.

설치본 업데이트는 /plugin 으로 마켓플레이스를 갱신한 뒤 재설치하고 /reload-plugins로 적용한다.

라이선스

MIT © 2026 mcpads