# bryanthaboi/gen1recomp

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/bryanthaboi-gen1recomp).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

4,117 stars · 368 forks · Lua · NOASSERTION

## Links

- GitHub: https://github.com/bryanthaboi/gen1recomp
- awesome-repositories: https://awesome-repositories.com/repository/bryanthaboi-gen1recomp.md

## Description

gen1recomp is a native recreation of early-generation Pokémon games, written in Lua on the LÖVE2D framework. The game logic is hand-written rather than run through an emulator. On first launch it decodes data, text, graphics and audio programs from a ROM you supply, then keeps a private cache so later launches skip the ROM. No copyrighted assets ship with the source, and several supported game versions can be kept side by side.

The project is built to be extended and played online. Mods add content through registries, events and hooks without touching base game code, and each mod gets its own saves and options. Mods can add custom rulesets, change game data, and be managed from an in-game mod manager. A customized map editor is also included. Battle mechanics sit behind swappable rulesets, so you can choose between cartridge-accurate behavior with its famous bugs and a modernized, bug-free version. Online play runs through a relay server, with lobbies, link battles, trading (including across generations), tournaments and spectating. Matches advance in lockstep after both players' engine and ruleset profiles are checked, and dropped sessions can resume. LAN link play works without a relay. Online matches disable mods other than verified translations.

Music, sound effects and creature cries are synthesized at runtime from stored audio programs instead of played from recordings. Display options cover Game Boy Color palettes, color modes, screen effects, tilt, zoom and widescreen layouts. Performance settings include frame timing control and visual quality tiers. Save tools cover quick save and load, format conversion, an external save editor, slot duplication, Pokémon migration, a portable mode for USB drives, and pre-launch save sync across devices. Controls support keyboard and gamepad rebinding.

The project ships builds and install paths for many platforms, including Linux AppImage, Windows, iOS sideloading, Flatpak, ARM single-board computers, ARM handhelds through PortMaster, Nintendo Switch and PlayStation 4 homebrew, and Xbox Developer Mode. It can also be run directly from the source folder, which installs missing runtime dependencies on first run. Launch options include command-line flags, URL schemes, home screen shortcuts and direct game boot.

## Tags

### Game Development

- [Engine Recreations](https://awesome-repositories.com/f/game-development/engine-recreations.md) — Implements a native Lua engine on LÖVE2D that recreates first-, second-, and third-generation Pokémon titles without an emulator layer.
- [Native Game Recreation Engines](https://awesome-repositories.com/f/game-development/native-game-recreation-engines.md) — Runs hand-written engine and map logic for early-generation Pokémon titles natively in Lua on LÖVE2D with no emulator layer. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/README.md))
- [ROM Data Extraction Recreations](https://awesome-repositories.com/f/game-development/game-boy-rom-hacking/rom-data-extraction-recreations.md) — Decodes data, graphics, and audio programs from a player-supplied ROM on first launch, verifies it, and builds a private cache. ([source](https://github.com/bryanthaboi/gen1recomp#readme))
- [Game Modding Interfaces](https://awesome-repositories.com/f/game-development/game-modding-interfaces.md) — Loads author-made and community mods that add or change content through registries, events and hooks without editing base game code. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/modding-overview.md))
- [Game Modding Toolkits](https://awesome-repositories.com/f/game-development/game-modding-toolkits.md) — Lets mods add registry entries and subscribe to events and hooks, extending content without editing base game code and keeping per-mod saved state.
- [Lockstep Online Battles](https://awesome-repositories.com/f/game-development/lockstep-online-battles.md) — Connects to a persistent relay server and runs lockstep online battles, then returns to the launcher with the room selected. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/architecture.md))
- [Online & Multiplayer](https://awesome-repositories.com/f/game-development/online-multiplayer.md) — Connects players through a relay server for lobbies, link battles, trading, tournaments and spectating, with encrypted connections and resumable sessions.
- [Native Recompilations](https://awesome-repositories.com/f/game-development/retro-game-emulation/native-recompilations.md) — Runs early-generation Pokémon games natively with hand-written Lua logic and data decoded from a user ROM, with no emulator.
- [ROM Asset Importers](https://awesome-repositories.com/f/game-development/rom-asset-importers.md) — Decodes tables, text, graphics and audio from a user-supplied ROM on first launch, then caches them so later launches skip the ROM.
- [Control Rebinding](https://awesome-repositories.com/f/game-development/control-rebinding.md) — Lets players rebind keyboard keys and gamepad buttons, sticks, and triggers, with full controller navigation of menus and movement. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/new-features.md))
- [Creature Trading](https://awesome-repositories.com/f/game-development/creature-trading.md) — Exchanges Pokémon between players, converting Gen 1 and Gen 2 formats and refusing trades that Time Capsule rules forbid. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/architecture.md))
- [Cross-Generation Play](https://awesome-repositories.com/f/game-development/cross-generation-play.md) — Lets players on different game generations share a room, then battle and trade under one ruleset with a journaled, resumable trade flow. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/new-features.md))
- [Game Client Mod Managers](https://awesome-repositories.com/f/game-development/game-client-mod-managers.md) — Opens a built-in mod manager from the running game so players can view, enable and configure installed mods. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/modding-overview.md))
- [Modular Rulesets](https://awesome-repositories.com/f/game-development/game-engines-frameworks/game-engines/modular-rulesets.md) — Lets mods register their own battle rulesets that appear alongside the built-in ones for players to select. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/guides/rulesets.md))
- [Pokémon Battle Simulators](https://awesome-repositories.com/f/game-development/historical-battle-simulations/pokemon-battle-simulators.md) — Offers a bug-free battle ruleset that keeps original damage formulas but fixes accuracy misses, critical rates and unlimited enemy PP. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/guides/rulesets.md))
- [Online Battle Rooms](https://awesome-repositories.com/f/game-development/online-battle-rooms.md) — Lets players host or join online battle rooms, launching straight into a match and returning to the lobby afterward. ([source](https://github.com/bryanthaboi/gen1recomp/blob/dev/docs/guides/online-play.md))
- [Lobby & Matchmaking Services](https://awesome-repositories.com/f/game-development/online-multiplayer/game-servers/lobby-matchmaking-services.md) — Connects players through a lobby for link battles, tournaments, and trading over the network. ([source](https://github.com/bryanthaboi/gen1recomp#readme))
- [Pokémon Battle Simulators](https://awesome-repositories.com/f/game-development/pokemon-battle-simulators.md) — Offers swappable battle rulesets that reproduce cartridge quirks and famous bugs or apply modernized bug-free mechanics.
- [Retro Game Modding](https://awesome-repositories.com/f/game-development/retro-game-modding.md) — Supports community mods, custom rulesets, translations, and map editing that extend the game without changing base game code.

### Part of an Awesome List

- [Moddable Engines](https://awesome-repositories.com/f/awesome-lists/devtools/strategy-game-engines/moddable-engines.md) — Loads author-made mods through registries, events, and hooks to add species, moves, rulesets, and maps without editing base code.
- [Game Save Managers](https://awesome-repositories.com/f/awesome-lists/data/file-storage-and-sync/game-save-managers.md) — Edits, converts, syncs, and carries save files between games, generations, and devices so progress follows the player.
- [Lockstep Synchronizations](https://awesome-repositories.com/f/awesome-lists/devops/networking-and-synchronization/lockstep-synchronizations.md) — Advances online matches in lockstep through a persistent relay server after both players' engine and ruleset profiles are verified to match.
- [Multiplayer Online Games](https://awesome-repositories.com/f/awesome-lists/more/multiplayer-online-games.md) — Connects players through a relay lobby for battles, cross-generation trades, live spectating, and tournament brackets.

### Data & Databases

- [Per-Title Data Extractors](https://awesome-repositories.com/f/data-databases/game-rom-organization/per-title-data-extractors.md) — Decodes a supplied ROM into the data tables, text, and sprite catalogs the engine needs, driven by per-game manifests. ([source](https://github.com/bryanthaboi/gen1recomp/tree/dev/tools))

### Programming Languages & Runtimes

- [Lua Game](https://awesome-repositories.com/f/programming-languages-runtimes/scripting-runtimes/lua-game.md) — Runs all game logic as hand-written Lua on the LÖVE engine, so classic titles execute natively without any emulator layer.
- [Audio Synthesis Runtimes](https://awesome-repositories.com/f/programming-languages-runtimes/audio-synthesis-runtimes.md) — Generates music, sound effects and creature cries at runtime by decoding stored audio programs instead of playing prerecorded files.

### DevOps & Infrastructure

- [Multi-Platform Artifact Packaging](https://awesome-repositories.com/f/devops-infrastructure/multi-platform-installation-systems/multi-platform-artifact-packaging.md) — Provides packaged builds for desktop, mobile, handheld, and console platforms including Linux, iOS, Switch, PlayStation 4, and Xbox Dev Mode. ([source](https://github.com/bryanthaboi/gen1recomp/tree/dev/docs))

### Graphics & Multimedia

- [Game Audio Synthesis](https://awesome-repositories.com/f/graphics-multimedia/game-audio-synthesis.md) — Synthesizes music, sound effects and creature cries at runtime from decoded audio programs instead of playing recordings. ([source](https://github.com/bryanthaboi/gen1recomp#readme))

### Mobile Development

- [Cross-Platform Desktop and Mobile Apps](https://awesome-repositories.com/f/mobile-development/cross-platform-desktop-and-mobile-apps.md) — Packages and installs one game across desktop, mobile, handheld, and console devices, including sideloading, SD card installs, and portable USB play.
