TL;DR

이 저장소는 특정 생태계에 종속된 SDK나 라이브러리가 아니라 LÖVE2D 기반의 독립형 Pokémon Generation I·II 게임 포트입니다. 사용자가 합법적으로 보유한 미국판 ROM을 SHA-1으로 검증하고, Lua로 작성된 엔진과 script VM이 ROM에서 추출한 데이터로 게임을 실행합니다. Gold·Silver의 Generation II 기능과 portable mode, controller, 여러 플랫폼 빌드, mod platform까지 갖춰 실제 플레이와 확장을 함께 고려한 구조입니다. 다만 ROM을 직접 준비해야 하고, README의 metadata 언어 표기인 C와 달리 핵심 런타임은 Lua로 설명되므로 C 프로젝트를 찾는 개발자에게는 맞지 않습니다.

핵심 포인트

• 독립형 LÖVE2D 게임 포트로, Pokémon Gold·Silver와 Red·Blue·Yellow를 데스크톱 앱에서 실행합니다. 엔진과 script VM, 맵 동작은 Lua로 작성됐고 게임 데이터와 그래픽은 사용자가 제공한 ROM에서 가져옵니다. 저장된 ROM 자체가 아니라 생성된 캐시를 이후 실행에 사용하므로 매번 ROM을 다시 입력하지 않아도 됩니다.
• 정식 미국판 ROM만 SHA-1으로 검증한 뒤 데이터를 추출하는 구조입니다. Gold·Silver는 약 2분, Generation I은 수 초 안에 import하며 ROM은 메모리에서 해제되고 캐시에 복사되지 않습니다. ROM이나 사전 추출 데이터는 배포물에 포함되지 않아 합법적으로 보유한 `.gb` 또는 `.gbc` 파일이 필요합니다.
• Generation II 기능을 Generation I 엔진 위에 확장해 Johto·Kanto 월드, day/night, breeding, Day-Care, Pokegear, shinies, held items를 지원합니다. Gen2 script VM과 command table을 별도로 구현하고 Gold·Silver 전용 battle rules를 적용합니다. 아직 카트리지와 다른 동작은 `docs/known-differences.md`에서 확인해야 합니다.
• 게임 실행뿐 아니라 native mod platform도 제공해 content registry, event와 hook, mod별 저장 데이터와 옵션을 연결합니다. Tiled에서 맵을 편집해 mod로 내보낼 수 있고, F10으로 in-game mod manager를 열 수 있습니다. LÖVE 11.x와 Python 3 환경을 준비하면 Windows·Linux에서 source 실행과 regression test를 진행할 수 있습니다.