# gen2recomp: recreating Pokémon games from cartridge data

> gen2recomp recreates Pokémon Gold, Silver and Crystal in LÖVE2D with a handwritten Lua engine and Generation II script VM. Its importer checks a player-supplied ROM and decodes game tables, text and graphics into a private cache. The same launcher also offers early support for selected Generation III through V games.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/UNDERdecoded/Gen2Recomped>
- Primary source: <https://github.com/UNDERdecoded/Gen2Recomped/blob/afb1e3cdca2da6fd7f3e8e904d39c87be14000d6/README.md>
- Catalog page: <https://awesomerea.org/resources/gen2recomp-case/>
- Record JSON: <https://awesomerea.org/resources/gen2recomp-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/gen2recomp-case/index.md)

## Requirements & limits

- **Prerequisites:** A supported, SHA-1-matched cartridge dump supplied by the player is required for import.
- **Limits:** Generation III games are alpha; the listed DS games are pre-alpha and may contain gaps and bugs.
- **License:** Gen2Recomped Source-Available License v1.2 permits reading, building and personal modification, but prohibits redistribution and commercial use.

## Primary sources

1. <https://github.com/UNDERdecoded/Gen2Recomped/blob/afb1e3cdca2da6fd7f3e8e904d39c87be14000d6/README.md>
2. <https://github.com/UNDERdecoded/Gen2Recomped/blob/afb1e3cdca2da6fd7f3e8e904d39c87be14000d6/docs/architecture.md>
3. <https://github.com/UNDERdecoded/Gen2Recomped/blob/afb1e3cdca2da6fd7f3e8e904d39c87be14000d6/LICENSE>

## More in Games

- [GLKeeper: reimplementing Dungeon Keeper 2](https://awesomerea.org/resources/glkeeper/index.md) · Case study
- [GLSMAC: reimplementing Alpha Centauri and Alien Crossfire](https://awesomerea.org/resources/glsmac/index.md) · Case study
- [Gorc: rebuilding the Dark Forces II engine](https://awesomerea.org/resources/gorc-dark-forces-ii-case/index.md) · Case study
- [GT3 Revisited: reimplementing the Gran Turismo 3 A-Spec engine](https://awesomerea.org/resources/gt3-revisited/index.md) · Case study
- [GTA4Unity: reconstructing the GTA IV world in Unity](https://awesomerea.org/resources/gta4unity-case/index.md) · Case study
- [GunZRs: a Rust reimplementation of GunZ: The Duel](https://awesomerea.org/resources/gunzrs-rea-rust-reimplementation-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.