discord

11 games, no emulator.

g1r deluxe aka gen1recomp. a native LÖVE2D recreation of poke red, blue, yellow, gold, silver, crystal, firered, leafgreen, ruby, sapphire and emerald. hand-written lua, bring ur own rom. mods, online play and a save editor.

get it at gen1re.com source on github

freeopen source9 platformsno rom included

g1r deluxe running the overworld, zoomed all the way out

make the game ur own

the engine and map behavior are hand-written lua, ported from the pret disassemblies + C. game data, graphics and audio are decoded on first launch from a rom u supply.

it does not include a rom, emulate the game boy, transpile assembly or download a disassembly.

and before u say "thats not a recomp", ur wrong. recomp is an acronym.

Reverse Engineering Causes Obsessive Mental Problems

  • 11games importable
  • 1.4M+downloads
  • 4k+github stars

bring ur own rom

ur rom is verified, used during import and released from memory. its never copied into the cache, and later launches load the private generated cache without asking for it again.

we do not condone or support piracy. roms are only legally attainable by dumping ur own physical cartridge. google gb cartridge dumper and buy the first one u see. or buy em all idc.

which roms work

quick start

  1. download the build for ur platform
  2. launch it. theres no rom and no game data inside, so the launcher asks for one
  3. pick ur legally obtained .gb / .gbc / .gba file, or drop it onto the window
  4. import takes a few seconds and the game starts on its own

repeat for any other game u own. each one gets its own tab in the launcher.

11 games, one launcher

all eleven can be imported side by side. gen 2 support is still under construction, and the gen 3 games are in beta.

gen 1game boy

  • the red cartridge label in the g1r deluxe launcherred
  • the blue cartridge label in the g1r deluxe launcherblue
  • the yellow cartridge label in the g1r deluxe launcheryellow

gen 2still under construction

  • the gold cartridge label in the g1r deluxe launchergold
  • the silver cartridge label in the g1r deluxe launchersilver
  • the crystal cartridge label in the g1r deluxe launchercrystal

gen 3beta

  • the firered cartridge label in the g1r deluxe launcherfirered
  • the leafgreen cartridge label in the g1r deluxe launcherleafgreen
  • the ruby cartridge label in the g1r deluxe launcherruby
  • the sapphire cartridge label in the g1r deluxe launchersapphire
  • the emerald cartridge label in the g1r deluxe launcheremerald

runs on almost anything

every release ships desktop builds, raw appimages + a flatpak, an ipa, an apk, an sd-ready switch zip, an xbox dev mode package, a ps4 pkg and a portmaster style handheld port.

  • windows

    unzip it, run the exe

  • macos

    the .app, zipped

  • linux

    raw appimages (x86_64 + arm64), or a flatpak

  • android

    the apk

  • ios

    sideload the ipa

  • switch

    homebrew, sd-ready zip

  • xbox

    dev mode uwp, one + series

  • ps4

    homebrew pkg, goldhen

  • handhelds

    rg34xxsp + arm linux handhelds

every download is on gen1re.com

modding

a built in mod platform

content registries, events and hooks, per-mod saves and options, and an in-game manager. maps can be edited in our own build of tiled and exported back out as a mod.

theres also a ton of community made tools to help w maps or mods in general. the full modding guide lives on the wiki, and the mods + custom carts live on the mod index.

main.lualua
return function(mod)
  mod.content.text:override("_PalletTownSignText", "HELLO FROM MY MOD!")
end

thats a whole main.lua. put a manifest.json next to it and its a mod.

the potato voxel mod rendering kanto in 3d
the wilds of kanto mod

online + link play

the launcher has an ONLINE tab. connect once and u get a lobby of who else is around, w what game and what rules.

  • host a battle or join one
  • watch any live match or tournament as a spectator
  • run a bracket where everyone not playing watches the match thats on
  • trade between save files, urs or someone else's
  • the in-game LINK menu is still there for local network play
40

players in one union room

gen 1, 2 and 3 players share the same room, each shown w their own game's sprite. cross-gen battles + trades included.

stuff the carts never had

all optional.

  • rulesets

    gen1_faithful keeps the cart's famous bugs. modern_clean keeps the formulas and drops the quirks.

  • color modes

    original, sgb, advanced gbc, monochrome and classic green.

  • tilt mode

    a perspective tilt for an hd-2d style overworld.

  • game speed

    fast-forward when u want it, plus performance presets + fps limits for weaker hardware.

  • rebind everything

    button remapping on every game and full controller support.

  • save editor

    edit party, boxes, items, events and pokedex flags outside the game.

  • box migration

    bank style migration from gen 1 + 2 into gen 3.

  • portable mode

    keep saves + cache next to the game and run it off a usb drive.

as seen on

watch the latest update video

g1r deluxe running on a handheld console
heads up

gen1re.com is the only official site

we are NOT affiliated w gen1recomp[.]com

that website is not run by this project, was not authorized by us, and we have no idea who operates it. its impersonating this project, and as i assumed would eventually happen, its now pumped full of adware. dont download anything from it.

the github repo, the discord and gen1re.com are the only official sources.

we are ALSO not affiliated w "Gen2Recomp[ed]"

that is a fork of this project. its allowed to exist, but just for clarity it is not and was never affiliated w this project nor boi's club games in any way.

questions ppl ask

found a bug? open a bug report.

is g1r deluxe the same thing as gen1recomp?

yes. g1r deluxe aka gen1recomp. same project, same repo, same discord. it went by gen1recomp++ for a while too.

is it an emulator?

no. the engine and map behavior are hand-written lua, ported from the pret disassemblies. it doesnt emulate the game boy, transpile assembly or download a disassembly.

so is it actually a recomp?

and before u say "thats not a recomp", ur wrong. recomp is an acronym. Reverse Engineering Causes Obsessive Mental Problems.

does it come w a rom?

no. the app ships w no rom and no game data. u supply ur own, it gets verified, used during import and released from memory. its never copied into the cache.

which roms work?

only the canonical us english roms. the importer checks the sha-1 before it creates any game data. the full list is on gen1re.com.

what does it run on?

windows, macos, linux (x86_64, arm64 and flatpak), ios, android, nintendo switch homebrew, xbox in dev mode, ps4 homebrew, the anbernic rg34xxsp and other arm linux handhelds.

are all 11 games finished?

all eleven can be imported side by side. gen 2 support is still under construction, and firered, leafgreen, ruby, sapphire and emerald are in beta.

is gen1recomp.com the official site?

no. gen1recomp[.]com is not run by this project, was not authorized by us, and we have no idea who operates it. the github repo, the discord and gen1re.com are the only official sources.

is it free?

yes. its a free download and the source is on github under GPLv3 w additional terms.

where do i get help or mods?

the discord at bois.icu. support, announcements and mods are all found there.

go play it

free, open source, and u bring the rom.

gen1re.comthe discord