- Gen1 Recomp is a native Lua/LÖVE2D recreation, not a traditional Game Boy emulator.
- Pokémon Red support requires a legally owned, compatible ROM supplied by the player.
- Official downloads come from the Gen1 Recomp GitHub repository and Releases page.
- Safe updates start with backups of saves, settings, and installed mods.
- Mod support includes a built-in Mod Manager, while voxel graphics come from a separate community project.
gen1 recomp pokemon red version Overview
gen1 recomp pokemon red version refers to using Gen1 Recomp with Pokémon Red on a modern computer or supported device. The project is a native recreation powered by a handwritten Lua and LÖVE2D engine. It does not emulate the Game Boy hardware, translate the original assembly directly, or distribute Nintendo game files.
The project also supports Pokémon Blue and Pokémon Yellow. For Pokémon Red, use a clean and legally obtained ROM dump from your own copy. The application provides the engine and recreation framework, while the player supplies the required game data.
The official project had approximately 1.9K GitHub stars and listed v0.1.69 as the latest release on August 4, 2026. Release availability can vary by operating system, so always read the current notes before choosing an asset.
| Item | Current guidance |
|---|---|
| Project type | Native Lua/LÖVE2D recreation |
| Supported games | Pokémon Red, Blue, and Yellow |
| Pokémon Red requirement | Legally owned compatible ROM |
| Latest listed release | v0.1.69, August 4, 2026 |
| Official source | Gen1 Recomp GitHub repository |
| Release downloads | Official GitHub Releases |
| ROM distribution | Not included by the project |
Native Recreation
Runs through a handwritten Lua and LÖVE2D engine instead of presenting itself as a conventional emulator.
Original Game Data
Import a compatible Pokémon Red, Blue, or Yellow ROM that you legally own.
Mod-Friendly Design
Built-in mod management supports community additions without replacing the core project files manually.
Avoid unrelated download mirrors and unofficial websites. The project identifies the GitHub repository and its published Discord as the trusted project channels; third-party packages may be modified or outdated.
Step-by-Step Pokémon Red Setup
Start with the base application before adding mods, enhanced graphics, or custom settings. A clean first launch makes later troubleshooting much easier.
Open the Official Releases Page
Visit the Gen1 Recomp Releases page and select the newest suitable release. Choose a normal player package rather than a source-code archive, then match the asset to your operating system and processor.
Extract or Install the Build
On Windows, extract the complete archive to a writable folder before launching the executable. On macOS, move the full application bundle to Applications or another accessible location. On Linux, preserve the folder structure and grant executable permission when required. Android users should select the APK intended for the current release.
Import Pokémon Red
Launch Gen1 Recomp and use the first-run game selection or import prompt. Select your clean Pokémon Red ROM and allow the application to process the game data. Do not close the program while the initial import is still running.
Test the Unmodded Game
Confirm that the title screen loads, menus respond, audio behaves normally, and character movement works. Start a new game, reach a safe point, and create an initial save before installing any mod.
Configure Controls and Display
Review movement, confirm, cancel, Start, and Select bindings. Then choose a readable window size, scaling option, fullscreen mode, and audio level. Test a controller separately if you plan to use one.
| Platform | Release asset | Main setup note |
|---|---|---|
| Windows | Windows archive | Extract the entire folder before launching |
| macOS | macOS bundle or archive | Use Finder’s Open option if the first launch is blocked |
| Linux | Linux archive or executable package | Check executable permissions and system libraries |
| Android | Official APK | Grant temporary installation permission and file access |
| Linux handhelds | Linux build | Initial file setup is usually easier in Desktop Mode |
| Windows handhelds | Windows archive | Manual controller mapping may be needed |
Back up the user-data directory before replacing an older installation. Keep saves and configuration files outside the release folder whenever possible. During a major update, install the new build separately, test it without mods, and only then restore compatible user data.
Test the base Pokémon Red experience first, make a normal in-game save, close the application, and copy that save to a separate backup folder. This recovery point is more useful than troubleshooting a modded installation immediately.
Mods and Voxel Graphics
Gen1 Recomp has an integrated Mod Manager for compatible community modifications. Mods designed for another emulator, a traditional ROM hack, or a different recompilation project should not be assumed to work here.
Import one package at a time and check its supported Gen1 Recomp version. Keep gameplay-changing modifications separate from cosmetic or interface additions because data, scripts, maps, moves, and battle rules can create deeper compatibility problems.
| Mod category | What it may change | Safe testing method |
|---|---|---|
| Visual mod | Sprites, colors, effects, or presentation | Test with a new visual profile |
| Interface mod | Menus, controls, or display elements | Confirm every menu remains readable |
| Gameplay mod | Pokémon, moves, items, or battle rules | Use a backed-up test save |
| Script or map mod | Events, maps, NPCs, or progression | Test story triggers separately |
| Framework mod | Shared systems or dependencies | Load before dependent content |
The DramaticShape Voxel Mod is a separate community project, not an automatic built-in feature of the base recreation. It can provide voxelized environments, configurable camera modes, 3D battle presentation, experimental first-person views, and optional model support when the required assets and configuration are available.
Mod Manager
Import, enable, disable, and organize compatible packages through the project’s supported workflow.
Voxel Overworld
Adds a three-dimensional interpretation of Kanto while retaining the underlying Gen I game structure.
3D Battles
Provides an alternate battle presentation that should be tested separately for wild and trainer encounters.
Experimental Views
First-person and close-camera features can be interesting but may be less practical in narrow maps or scripted scenes.
To recover from a broken mod profile, disable the newest package first. If the game still fails, disable all mods and verify that the unmodded Pokémon Red installation launches. Re-enable packages individually until the conflict returns.
Do not describe all 151 Pokémon without trading, female protagonists, Mew changes, or Generation II graphics as automatic Gen1 Recomp features. Label each addition as built-in, an official example, or a community mod only when its project documentation supports that claim.
Saves, Tools, and Link Play
Gen1 Recomp includes tools that make long-term play more manageable, including a Save Editor and direct peer-to-peer Link Play. These features deserve a cautious workflow because save data and network sessions can be affected by version mismatches or incompatible modifications.
The Save Editor can manage areas such as party Pokémon, PC boxes, items, Pokédex records, and event flags. Make small edits, save a backup first, and test the result in-game before discarding the original copy.
| Tool | Best use | Main precaution |
|---|---|---|
| Save Editor | Party, boxes, items, Pokédex, and event data | Back up the complete save before editing |
| Mod Manager | Importing and toggling compatible mods | Change one package at a time |
| Link Play | Direct Pokémon battles and trades | Match versions, game data, and mod sets |
| Portable Mode | Keeping user data with a selected installation | Back up the portable folder before updates |
For Link Play, both players should use the same Gen1 Recomp release and compatible Pokémon Red, Blue, or Yellow data. Gameplay-changing mods should be disabled unless both sides have confirmed identical versions and load order.
| Connection stage | Required action |
|---|---|
| Host preparation | Open Link Play, select a UDP port, and permit the application through the firewall |
| Local network session | Share the host’s local IP address and the selected UDP port |
| Internet session | Configure UDP port forwarding to the host device |
| Joining | Enter the host address and matching port exactly |
| Trade or battle | Use the appropriate Pokémon Center Cable Club option |
| Disconnection | Reload the latest valid saves before reconnecting |
A timeout commonly points to an incorrect address, blocked UDP traffic, a firewall rule, or a mismatched port. Test locally first, then troubleshoot router forwarding for an internet session. Do not share ROM files or unrelated personal data when arranging a connection.
Pokémon Red Safety Checklist:
- Back up the complete save folder before using Save Editor
- Test the unmodded game before installing gameplay modifications
- Match Gen1 Recomp versions before starting Link Play
- Keep separate backups for unmodded and modded saves
- Restore a known-good save after an interrupted trade or battle
Create a dated backup after the first successful save, another before every major update, and another before changing event flags or party data. Keep those backups outside the installation directory.
Troubleshooting and Update Tips
Most problems can be narrowed down by returning to a minimal setup. First confirm that the official build is complete, the ROM is clean and compatible, and the base Pokémon Red experience launches without modifications.
| Problem | Likely cause | Recommended check |
|---|---|---|
| Program will not launch | Incomplete extraction or blocked permissions | Re-extract the full package and review security settings |
| ROM is rejected | Unsupported or modified ROM | Test a clean legally owned Red, Blue, or Yellow ROM |
| Save is missing | Wrong user-data directory | Check the active application-data location |
| Save will not load | Invalid edit or incomplete write | Restore the latest backup and test without mods |
| Mod causes a crash | Version conflict or damaged package | Disable the newest mod and verify the base game |
| Controller fails | Platform-specific mapping | Rebind movement, confirm, cancel, Start, and Select |
| Voxel view stutters | Heavy graphics settings | Lower effects, shadows, render distance, or resolution |
| Link Play times out | UDP or firewall issue | Match the port and test on a local network |
Before updating, read the release notes on the official Releases page. Preserve saves, configuration, and mod archives. A separate installation is usually the safest way to compare a new build with a working setup.
When reporting a bug through GitHub Issues, include the operating system, Gen1 Recomp version, enabled mods, and repeatable steps. Do not upload copyrighted ROM data. Search existing issues first because related reports may already be tracked.
Install the new release separately, launch it without mods, confirm ROM detection and save loading, then restore compatible mods one at a time. This sequence identifies whether a problem belongs to the base build or a mod.
Q: Is gen1 recomp pokemon red version a traditional emulator?
No. Gen1 Recomp is a native recreation built with a handwritten Lua and LÖVE2D engine. It uses game data extracted from a legally owned compatible ROM rather than distributing ROM files.
Q: Where should I download Gen1 Recomp?
Use the official GitHub repository and its Releases page at github.com/bryanthaboi/gen1recomp. Avoid unofficial mirrors, including websites that present themselves as authorized project download portals.
Q: Can I install the DramaticShape Voxel Mod with Pokémon Red?
Yes, when the voxel project and your Gen1 Recomp release are compatible. Install and test the base application first, then import the separate community mod through the Mod Manager.
Q: Why does Link Play fail after I install mods?
Gameplay, map, script, Pokémon, move, and battle-rule mods can affect synchronization. Match the application version and mod profile on both systems, or disable gameplay-changing mods during troubleshooting.
Recommended Starting Path
For most new users, the best route is simple: install the official build, import a clean Pokémon Red ROM, verify a normal save, and learn the controls before exploring mods. Add visual enhancements only after the base setup is stable.
Use the official Gen1 Recomp repository for project information, the GitHub Releases page for packages, the official Wiki for guides, and the DramaticShape Voxel Mod repository for voxel-specific documentation.
Keep one clean profile for standard Pokémon Red and a separate profile for experimental mods. This makes updates, save recovery, and Link Play compatibility easier to manage.