Gen2Recomped

# gen2recomp

<p align="center"><img src="./assets/logo/gen2logo.png"></p>

<p align="center"><img src="./assets/logo/UD.png" width="220"></p>
<a href="https://discord.gg/gb8TuPKJv">Gen2Recomp Discord!</a>  
<p align="center"><b>by UNDERdecodedHD</b><br>
a fork of <a href="https://github.com/bryanthaboi/gen1recomp">Gen1Recomp</a> by
<a href="https://github.com/bryanthaboi">bryanthaboi</a> and
<a href="https://boisclub.games">BOIS CLUB GAMES</a></p>

A native LÖVE2D recreation of Poke Gold, Silver and Crystal, built on Gen1Recomp's
Red/Blue/Yellow engine. The engine, script VM, and map behavior are
hand-written Lua; game data and graphics are decoded from a ROM supplied by the
player.

gen2recomp keeps everything the upstream project does for Generation I and adds
the Generation II half: the Gen2 script VM and its command table, the Johto and
Kanto world, day/night, breeding and the Day-Care, the Pokegear, shinies, held
items, and the Gold/Silver title sequence.

It has since grown well past Generation II. The same launcher now imports and
runs **FireRed** and **Emerald** (Gen 3), **Platinum**, **HeartGold** and
**SoulSilver** (Gen 4), and **Black** and **White** (Gen 5), plus the
**Polished Crystal** and **Prism** romhacks — all side by side, all from your
own cartridge dumps. Around the games sit the **Monster Walker** (a
next-gen Pokéwalker with minigames and a Watt Shop), a **Map Editor**, a
**Save Editor**, machine **translation** into 25 languages, **cloud saves**,
dual-screen support for the DS games, and touch controls. See
[What's New](#whats-new) for the tour.

> [!CAUTION]
> **Neither this project nor Gen1Recomp is affiliated with the website
> `gen1recomp[.]com`.** That site is not run by either project and was not
> authorized by anyone involved. Do not download anything from it, and treat
> anything it hosts or claims as untrustworthy. Even if it links back to a real
> repository, the people behind it can change its content at any time. This
> GitHub repository is the only official source for gen2recomp.

This project does not include a ROM, emulate the Game Boy, GBA or DS,
transpile assembly, or download a disassembly. A canonical cartridge dump of
one of the [supported games](#supported-games) is the only game content input.

The ROM is verified, used during import, and then released from memory. It is
not copied into the cache. Later launches load the private generated cache and
do not ask for the ROM again. Every version can be imported and played side by
side.

## Quick Start

Open the desktop app. On first boot, choose your legally obtained `.gb` /
`.gbc` / `.gba` / `.nds` file or drop it onto the window. Import takes a few
seconds for Gen 1, a couple of minutes for Gen 2, and longer for the GBA and DS
games, then the game starts automatically. Have a whole folder of dumps?
**Tools → Import ROMs** takes several files at once and imports every one it
recognises.

On a console or handheld there is no file picker to open: you copy