Gen2Recomped: a Lua rewrite of Gen 2 that borrows your cartridge
Generation 2 Pokemon Recomp forked from Gen1Recomp and modified
At a glance
- What is it?
- A native LÖVE2D recreation of Pokemon Gold, Silver and Crystal built on the Gen1Recomp engine, with hand-written Lua for the script VM and maps and your own legally obtained ROM as the only game content. It ships twelve platform archives and no ROM in any of them.
- Who is it for?
- Gen2Recomped fits someone who already owns a cartridge and wants a native, moddable Gen 2 build on a device that has no emulator, and it does not fit anyone hoping for a bundled game or a legal shortcut, since every platform asks for your own dump. Before the first launch, confirm your ROM hash is one of the seven accepted values, and on Windows prefer the plain zip over the MSIX unless you are willing to import the certificate once.
- Can I use it commercially?
- Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
- Is it still maintained?
- Yes. The repository last received commits 3 days ago.
- What is it written in?
- Mainly C, according to GitHub's language statistics.
Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.
Star history
- UNDERdecoded/Gen2Recomped473 ★ · +147
| Repository | 2026-09-18 | 2026-11-15 |
|---|---|---|
| UNDERdecoded/Gen2Recomped | 326 | 473 |
147 Stars in the last 58 days, measured from the daily GitHub snapshot. Compare with other projects
Editorial analysis
The ROM is hashed, read, and dropped from memory
Only canonical US cartridges are accepted, and the check happens before any game data exists. Seven SHA-1 values are listed, from Gold at 2 MiB with d8b8a3600a465308c9953dfa04f0081c05bdcb94 through Red at 1 MiB with ea9bcae617fdf159b045185467ae58b2e4a48b9a, plus Silver and two Crystal revisions. A dump whose hash is not on that list is refused rather than half-imported.
What happens to the file afterwards is the interesting part. The ROM is read during import and then released from memory, and it is not copied into the generated cache. Later launches load that private cache and never ask for the cartridge again. Import costs a few seconds for a Gen 1 game and a couple of minutes for Gen 2, and because nothing is shared between imports, every version you own can sit side by side.
On a desktop the app opens a file picker on first boot, or you drop the .gb or .gbc onto the window, and the game starts on its own when the import finishes. On a console or handheld there is no picker at all: the launcher scans a folder instead.
One payload, twelve archives, one checksum file
Every release publishes one archive per platform, all built from the same payload in the same run. Windows gets a zip you unzip and run, and separately an MSIX for a store-style install. macOS gets a zip you drag into Applications. Linux x86-64 and ARM64 get an AppImage, which is also what the Steam Deck uses because the Deck is x86. Then there is an Android APK, a Switch zip, an Xbox dev mode zip, an Anbernic RG34XXSP archive and an iOS ipa.
The twelfth is for people who already have LÖVE 11.5 installed: a bare .love archive, which is what the in-app updater downloads and therefore the smallest thing to fetch when you are updating by hand.
One file covers all of it. sha256sums.txt lists every asset in the release, and no archive contains a ROM or any game data. Assets go missing only when that platform's build job failed, and the release notes say so rather than leaving you to guess.
The MSIX install fails with 0x800B010A for a subtle reason
The store-style Windows build needs two files, the .msix and the .cer, because Windows will not install a package it cannot verify. The certificate goes into the machine store once, in an elevated PowerShell:
Import-Certificate -FilePath .\Gen2Recomped-<ver>-windows.cer `
-CertStoreLocation Cert:\LocalMachine\TrustedPeople
Add-AppxPackage .\Gen2Recomped-<ver>-windows.msixLocalMachine rather than CurrentUser is the line people get wrong. App Installer reads only the machine store, so a certificate imported into the user store produces error 0x800B010A, which reads exactly like having imported nothing at all. Get that right once and later releases install with Add-AppxPackage alone. The signing setup is written up in docs/msix-signing.md, and if certificates are not worth your evening the plain zip is the same game with none of that.
Defender objects because LÖVE appends data to a binary
Windows Defender sometimes flags these builds with a generic machine-learning detection such as Trojan:Win32/Wacatac!ml, and the reason is structural rather than malicious. A LÖVE game ships as the official LÖVE runtime with the game archive appended to it, which is how the format works, and Defender's heuristics distrust unsigned executables with appended data.
The response is verification rather than an exclusion. Releases publish sha256sums.txt so you can confirm the bytes you downloaded, and the project points readers at VirusTotal, where these builds come back clean on every engine except Defender's own heuristic. Worth knowing that Gen2Recomped.exe sits in the repository root as well. A committed executable is not the problem, but it is the sort of file that makes a scanner's job harder for every user who clones the source.
Hand-written Lua runs the game, the ROM only supplies data
Nothing here is an emulator. The engine, the script VM and map behaviour are hand-written Lua, and the project states plainly that it does not include a ROM, emulate the Game Boy, transpile assembly or download a disassembly. Game data and graphics are decoded from the cartridge you supply, which is why a canonical dump is the only content input.
What Gen2Recomped adds on top of the Gen 1 engine it forks is the Generation 2 half: the Gen 2 script VM and its command table, the Johto and Kanto world, day and night, breeding and the Day-Care, the Pokegear, shinies, held items and the Gold and Silver title sequence. Audio is not stored either. Music, sound effects and cries are synthesized while the game runs, from compact audio channel programs copied out of the verified ROM.
One more warning belongs with any evaluation. Neither this project nor Gen1Recomp is affiliated with the site written as gen1recomp[.]com; it is run by neither, was authorized by nobody involved, and anything it hosts should be treated as untrustworthy even when it links back to a real repository.
Build leftovers sit next to the source at the root
The top level tells you how the project is worked on. There is main.lua and conf.lua at the root next to assets/, data/, src/, scripts/, tools/, tests/, docs/, mobile/, ports/ and mods/, with CONTRIBUTING-mods.md beside the mods directory and a .luacheckrc for the Lua lint pass. Play-Mac.command and Play-Windows.bat are there for running without a build step, and build-rg34xxsp.sh with install-rg34xxsp.sh cover the Anbernic handheld target.
Then come the artefacts. Gen2Recomped.exe is committed at the root. A directory called Claude outputs/ sits next to it. release.yml.new sits beside release.split.yml, a leftover from a workflow edit. probe_pipeline_default.lua and probe_spawn_ceiling.lua are debug probes parked at the top rather than under tools/.
Licensing is similarly ambiguous on the surface: two files, LICENSE and LICENSE.MD, with no licence identifier named in the repository metadata. Anyone redistributing a fork should read both before shipping a build. And the visible documentation stops mid-sentence inside the Switch instructions, so the handheld, iOS, Xbox and mod details beyond that point are not written down here.
Three tags on one day, with the version in every filename
The release history is fast and still under 1.0: v0.7.98 and v0.7.99 were both published on 2026-10-01, and v0.8.0 followed the same day. The last push to main carries that date too, and the repository is not archived. For a user this is convenient, because fixes land quickly, and it is a nuisance, because the version number is embedded in every asset name from Gen2Recomped-<ver>-windows.zip to the .love, so a half-finished manual update leaves mismatched files and a stale sha256sums.txt.
The same cadence applies to the Switch layout, where the launcher, the imports folder and the exports folder where battery saves come back out are all created for you. Dumps are matched by SHA-1 there too, so the filename does not matter.
Editorial conclusion
Gen2Recomped fits someone who already owns a cartridge and wants a native, moddable Gen 2 build on a device that has no emulator, and it does not fit anyone hoping for a bundled game or a legal shortcut, since every platform asks for your own dump. Before the first launch, confirm your ROM hash is one of the seven accepted values, and on Windows prefer the plain zip over the MSIX unless you are willing to import the certificate once.
Frequently asked questions
What does Gen2Recomped need from me before it will run?
A legally obtained .gb or .gbc of a canonical US Pokemon Gold, Silver, Red, Blue or Yellow cartridge, and only those. The importer checks the SHA-1 before creating any game data, then releases the ROM from memory instead of copying it into the cache, so later launches never ask again.
Does any Gen2Recomped download include a ROM?
No. No archive contains a ROM or any game data, and the packaged app carries no pre-extracted data either. Music, sound effects and cries are synthesized at run time from compact audio channel programs copied out of the verified cartridge.
Why does Windows Defender flag the Gen2Recomped executable?
The exe is the official LÖVE runtime with the game archive appended, which is how LÖVE games ship, and Defender's heuristics distrust unsigned executables with appended data. The project calls it a known false positive, publishes sha256sums.txt for verification, and notes that VirusTotal returns clean on every engine except Defender's heuristic.
Can I skip the certificate step and still install Gen2Recomped on Windows?
Yes. Take the Gen2Recomped-<ver>-windows.zip instead, which is the same game. The MSIX route needs both the .msix and the .cer, and the certificate has to be imported into the LocalMachine TrustedPeople store once, or the install fails with error 0x800B010A.
Which platforms does Gen2Recomped build for?
Windows zip and MSIX, macOS, Linux x86-64, Linux ARM64 as an AppImage, Android, Nintendo Switch, Xbox in dev mode, the Anbernic RG34XXSP and iOS by sideloading. If you already run LÖVE 11.5, the Gen2Recomped-<ver>.love archive is the smallest option and is what the in-app updater fetches.
Official sources
Add this badge to your README
If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.
[](https://hysenlabs.com/projects/underdecoded-gen2recomped)Star history chart for your README
[](https://hysenlabs.com/projects/underdecoded-gen2recomped)Was this useful?