WHAGO

게임보이 홈브루 디버깅

Matcha

게임보이 홈브루 개발자와 에뮬레이터 학습자가 CPU·메모리·화면을 관찰하고, 저장 상태를 재생하거나 MCP 도구로 같은 실행을 반복합니다.

v0.1.1 다운로드 (새 탭에서 열림)

사용 대상과 범위

자작 게임보이 소프트웨어를 시험하는 개발자·학습자

DMG/CGB의 일부 정밀 타이밍과 CGB의 DMG 호환 모드는 남아 있습니다. MCP 저장 슬롯은 프로세스 종료 시 사라집니다. 실행 권한이 있는 ROM만 사용하세요. 전체 하드웨어나 모든 게임의 호환성을 보장하지 않습니다.

지원 범위와 사용 안내 ↗

현재 제공

버전
v0.1.1 · 2026.10.12
실행
HTML 파일 · Node 18+ MCP
도구
MCP 17개 · 브레이크포인트·메모리 검색
입력
직접 만든 ROM · 포함된 오픈소스 홈브루
CLI
Rust로 소스 빌드

사용 흐름

  1. 01

    v0.1.1의 matcha.html 또는 matcha.plugin과 체크섬을 받습니다.

  2. 02

    HTML을 로컬 브라우저에서 열거나 플러그인 ZIP을 추출해 Node stdio 서버를 MCP 클라이언트에 연결합니다.

  3. 03

    홈브루 예제의 쓰기 명령을 찾아 실행하고, 저장·복원 후 같은 입력이 같은 레지스터·메모리·화면을 만드는지 비교합니다.

다운로드와 디버깅 실습

HTML 플레이어와 MCP 플러그인은 Rust 빌드가 필요하지 않습니다. matcha.plugin은 ZIP이며 전체 추출 후 server/server.mjs를 Node 18 이상으로 실행합니다. npm 패키지 설치는 필요하지 않습니다. MCP 설정에는 실제 절대 경로를 사용하세요. 아래 합성 홈브루 실습은 같은 태그의 소스 아카이브 루트에서 실행합니다.

node mcp/debug-homebrew.mjs

직접 확인하기

실습은 자체 생성한 ROM에서 $C000에 $42를 쓰는 명령을 찾고 저장·복원 후 같은 실행을 재현합니다. v0.1.1은 잘못된 도구 요청을 실행 중 머신·저장 슬롯·중단점을 유지한 채 거부합니다. 이 결과는 디버깅 흐름의 확인이며 하드웨어 정확도 점수가 아닙니다.

홈브루 디버깅 실습 ↗(새 탭에서 열림)

링크