- gen1 recomp red blue yellow support covers three Generation I game versions.
- Native recreation uses a handwritten Lua and LÖVE2D engine instead of emulating the Game Boy.
- Legal ROM required: Import game data from your personally owned Red, Blue, or Yellow copy.
- Official source: Use the Gen1 Recomp GitHub repository and its Releases page.
- Safe setup: Test the unmodded game and back up saves before adding mods or updating.
What Gen1 Recomp Supports
Gen1 Recomp is a native PC recreation of the first-generation Pokémon experience. The project is commonly described as a Pokémon Gen 1 recomp or PC port, but it is not a traditional emulator and does not transpile the original assembly code. Its handwritten Lua engine uses data extracted from a legally owned game ROM.
The supported versions are Pokémon Red, Pokémon Blue, and Pokémon Yellow. The application does not provide copyrighted ROM files, so you must supply a clean dump from your own copy. Keeping that separation clear helps you avoid unofficial downloads and makes troubleshooting easier.
| Version | Core identity | Best fit |
|---|---|---|
| Pokémon Red | Original Gen I adventure with its version-exclusive content | Players who prefer Red’s exclusive encounters |
| Pokémon Blue | Companion version with different exclusive content | Players who prefer Blue’s trade requirements and lineup |
| Pokémon Yellow | Special Pikachu-focused version with anime-inspired differences | Players who want Yellow’s starter and story presentation |
Only import game data that you are legally entitled to use. Gen1 Recomp does not distribute Pokémon Red, Blue, or Yellow ROM files, and unofficial download pages should not be treated as project sources.
Red
- Version-exclusive encounters
- Traditional starter selection
- Compatible with Gen I trading requirements
Blue
- Different exclusive encounters
- Traditional starter selection
- Useful for comparing version collections
Yellow
- Pikachu-focused opening
- Distinct starter and partner presentation
- Different early-game progression details
The base project also includes systems that are especially useful for long-term players, including a Mod Manager, Save Editor, and direct Link Play features. These should not be confused with optional community projects. For example, the DramaticShape Voxel Mod is a separate mod that adds a voxelized 3D presentation.
| Feature | Base Gen1 Recomp | Separate community content |
|---|---|---|
| Native Lua/LÖVE2D engine | Built in | Not applicable |
| Red, Blue, and Yellow support | Project-supported versions | Mod compatibility may vary |
| Mod Manager | Built-in workflow | Used to install compatible packages |
| Save Editor | Built-in tool | Individual mods may add extra data |
| Voxel 3D presentation | Not part of the standard presentation | DramaticShape Voxel Mod |
| ROM files | Not included | Never obtain them from unofficial reposts |
Red, Blue, and Yellow Setup Guide
The safest installation method is consistent across desktop systems and Android: download the correct official release asset, keep the package structure intact, import your legally owned ROM, and verify the base game before changing settings or installing mods.
Open the Official Releases Page
Visit the official Gen1 Recomp Releases page and select the newest stable build. The project information records v0.1.69 as released on August 4, 2026. Match the asset to your operating system and processor instead of downloading the source-code archive.
Install the Platform Package
Extract the complete Windows, Linux, or macOS package before launching it. Keep the executable, libraries, and data folders together. On Linux, an AppImage may require executable permission. On macOS, the first launch may require using Finder’s Open command after a security prompt.
Import Red, Blue, or Yellow
Start Gen1 Recomp and follow the initial game-data prompt. Select the clean ROM that matches the intended version. Do not rename or move the file while it is being processed, and avoid patched ROM hacks during the first compatibility test.
Verify the First Boot
Confirm that the title screen, audio, menus, movement, and an initial save work correctly. Test the unmodded application first. Once the base game is stable, back up the user-data and save folders before changing the installation.
| Platform | Release package | Input options | Main consideration |
|---|---|---|---|
| Windows | Official release archive | Keyboard and compatible controller | Extract the full archive before launching |
| macOS | Application bundle or archive | Keyboard, USB, or Bluetooth controller | Gatekeeper may require first-launch approval |
| Linux | Archive or executable package | Keyboard and SDL-compatible controller | Permissions and system libraries can vary |
| Android | Official APK | Touch, Bluetooth, or USB controller | Sideloading and file access permissions are required |
| Steam Deck or Linux handheld | Linux build | Built-in controls, Steam Input, touchscreen | Desktop Mode simplifies initial file setup |
Create a separate test folder for a new release. Keep the previous working installation until the new build loads the ROM, recognizes the save, and passes an unmodded test.
For updates, close the application first and copy the complete save and user-data folders to a separate backup location. Do not delete the previous installation until the new release has been tested. On Android, export or copy local saves before replacing or uninstalling the application because app-specific storage may not survive removal.
Version Differences and Link Play
The choice between Red, Blue, and Yellow affects the game data you import and the version-specific content you experience. It does not change the fundamental Gen1 Recomp installation process. Choose the ROM that matches the playthrough you want to preserve, and do not switch versions by simply renaming a file.
| Decision point | Red | Blue | Yellow |
|---|---|---|---|
| Starting experience | Standard Gen I opening | Standard Gen I opening | Pikachu-centered opening |
| Version exclusives | Red-exclusive encounter group | Blue-exclusive encounter group | Yellow-specific differences |
| Starter structure | Select from the traditional opening choices | Select from the traditional opening choices | Distinct partner-focused beginning |
| Link compatibility | Match the other player’s supported version | Match the other player’s supported version | Confirm compatibility before connecting |
| Best reason to choose | Red collection or familiarity | Blue collection or comparison | Yellow’s unique presentation |
Gen1 Recomp includes direct Link Play for battles and trades. Both players should use compatible application versions, matching game data, and compatible mod configurations. Gameplay-changing modifications can cause synchronization problems, so start with an unmodded session when diagnosing connection failures.
| Link Play stage | Host action | Joining player action | Check |
|---|---|---|---|
| Preparation | Save normally and confirm the Cable Club is available | Do the same on the joining device | Match release and game version |
| Session creation | Select hosting and note the UDP port | Wait for the host address and port | Use the same port number |
| Network access | Allow the application through the firewall | Confirm the address is entered correctly | Test locally before internet play |
| Cable Club | Keep the host session active | Join before entering the activity | Select the same trade or battle option |
| Recovery | Close the session after a failure | Reload the latest valid save | Avoid overwriting backups immediately |
For a first connection test, use the same local network, the same Gen1 Recomp release, and no gameplay-changing mods. Add complexity only after a basic trade or battle works.
Internet hosting may require forwarding the selected UDP port to the host device and permitting Gen1 Recomp through the operating-system firewall. A timeout commonly indicates an incorrect address, mismatched port, blocked traffic, or a router rule pointing to the wrong local device.
Mods, Voxel Graphics, and Save Tools
Gen1 Recomp’s built-in Mod Manager is designed for compatible community packages. Import the original package when required, preserve its ZIP structure, and check the supported application version before enabling it. A conventional emulator patch, ROM hack, or mod made for another recompilation project is not automatically compatible.
Mod Manager
Import, enable, disable, and update compatible packages without manually deleting files.
Load Order
Keep dependencies before the content that relies on them, following each mod author’s instructions.
Save Editor
Back up saves before changing party Pokémon, PC boxes, items, Pokédex data, or event flags.
Voxel Mod
Treat DramaticShape Voxel Mod as separate community content with its own compatibility requirements.
The DramaticShape Voxel Mod can add voxelized overworld scenes, camera modes, 3D battles, experimental first-person views, and optional model-based features. Install it only after the standard game launches correctly. Reduce render distance, lighting, shadows, or other expensive effects if performance drops.
| Tool or mod | What it changes | Recommended first test |
|---|---|---|
| Standard application | Native recreation and original presentation | Boot a clean Red, Blue, or Yellow ROM |
| Mod Manager package | Mod-defined graphics, systems, or content | Enable one compatible mod |
| DramaticShape Voxel Mod | Voxel overworld and 3D presentation | Test movement, collisions, and map transitions |
| Save Editor | Structured save data | Edit one small value after creating a backup |
| Link Play | Direct battles and trades | Connect with matching versions and mod sets |
Use the Save Editor conservatively. Small changes are easier to validate than large groups of party, inventory, Pokédex, and event-flag edits. A Pokémon marked as caught should also be marked as seen, and story flags should be changed one at a time because they can control locations, rewards, encounters, and scripted events.
Safe Setup Checklist:
- Download only from the official GitHub repository or Releases page
- Import a clean legally owned Red, Blue, or Yellow ROM
- Confirm the unmodded game reaches the title screen
- Back up saves before updating or editing
- Enable mods individually and record a stable load order
Label every package as built-in, official example content, or community content. Features such as full 151 access, a female protagonist, Mew changes, or Gen II sprites should not be presented as base-project features without a reliable project reference.
Troubleshooting and FAQ
Most setup problems come from incomplete extraction, unsupported ROM modifications, missing permissions, incompatible mods, incorrect save locations, or mismatched Link Play settings. Return to a minimal configuration before attempting advanced fixes.
| Problem | Likely cause | First response |
|---|---|---|
| ROM is rejected | Wrong version, patched file, or unsupported dump | Test a clean legally owned Red, Blue, or Yellow ROM |
| Application will not launch | Incomplete extraction or missing permission | Re-extract the full package and check executable permissions |
| Save is missing | Wrong user-data directory or changed profile | Restore the backed-up save and verify the active data folder |
| Mod causes a crash | Outdated, damaged, or conflicting package | Disable the newest mod and test the base game |
| Link Play times out | Firewall, UDP, address, or port issue | Test locally and confirm the host UDP configuration |
| Android data disappears | App-specific storage or uninstall | Restore the exported save backup before reinstalling |
When reporting a technical issue, include the operating system, Gen1 Recomp release, game version, enabled mods, and repeatable steps. Do not upload copyrighted ROM files. The official GitHub Issues page is the appropriate place to review existing reports or submit a reproducible problem.
Q: Does gen1 recomp red blue yellow include the original ROM files?
No. Gen1 Recomp provides the native engine and requires users to import game data from a legally owned Pokémon Red, Blue, or Yellow copy.
Q: Is Gen1 Recomp a traditional Game Boy emulator?
No. It is a handwritten Lua and LÖVE2D recreation commonly described as a Gen 1 recomp or PC recreation, rather than a conventional emulator.
Q: Can I install the DramaticShape Voxel Mod immediately?
Install and test the base application first. Then import the separate voxel mod, confirm version compatibility, and test it without unrelated visual or gameplay mods.
Q: Why does Link Play fail even when both players connect?
Check the application version, game version, active mod set, selected Cable Club activity, firewall permissions, host address, and UDP port. An unmodded local test is the best diagnostic step.
Back up saves, configuration files, and installed mods before replacing a build. If the new release fails, restore the previous working setup instead of editing the only copy of your data.
The official project hub remains the best starting point for releases, documentation, Discord access, and issue tracking: Gen1 Recomp on GitHub. Use the repository and its published links rather than unofficial sites that present themselves as authorized download pages.