Gen1Recomp：把《宝可梦》初代 ROM 变成原生 Lua 游戏，但先别急着下载
该项目围绕「bryanthaboi/gen1recomp」构建，面向真实业务场景提供可复用的开源实践方案，支持稳定落地与可扩展的项目实践。
秒懂
- 它是什么？
- Gen1Recomp 用 Lua 和 LÖVE2D 重写了《宝可梦》红、蓝、黄、金、银、水晶的引擎，游戏数据从玩家自备的 ROM 中提取。它不模拟、不反汇编，却要面对合法性、维护成本和一波未平的假冒网站风波。
- 适合谁用？
- 谁适合用？想在不碰模拟器的情况下体验《宝可梦》红、蓝、黄、金、银、水晶原版流程，并且愿意为每个 ROM 支付一份正版拷贝的玩家，以及想研究 Gen 1 战斗规则（包括那些著名 bug）的开发者。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库在最近一天内有新的提交。
- 用什么语言写的？
- 主要是 C（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月15日）和我们的分析，不构成法律意见。
开源项目深度解析
一个不模拟、不反汇编的“重编译”
Gen1Recomp 的定位很反直觉。它叫 recomp，但项目作者在 README 里直接说，recomp 是“Reverse Engineering Causes Obsessive Mental Problems”的缩写，摆明了是自嘲。它的做法是：引擎和地图行为全部用 Lua 手写，游戏数据（地图、文本、音频通道程序）从玩家提供的 ROM 中解码出来。它不包含 ROM，不模拟 Game Boy，不转译汇编，也不下载任何反汇编代码。你给它一个合法的 .gb 或 .gbc 文件，它验证 SHA-1，然后生成一份私有缓存，之后启动就不再需要 ROM。这个设计比传统的静态重编译更彻底，因为它不复制任何原始机器码，而是把 ROM 当作数据源。对想研究游戏内部机制的人，这是一个干净的切入点；但对只想玩游戏的人，它多了一道“必须自己找 ROM”的门槛。
ROM 导入：SHA-1 校验与内存释放的细节
导入流程是 Gen1Recomp 最严谨的部分。它只接受美版红、蓝、黄（1 MiB）和金、银、水晶（2 MiB）的 ROM，并且列出了每个版本的 SHA-1 哈希，比如红版是 ea9bcae617fdf159b045185467ae58b2e4a48b9a。导入时先校验哈希，再创建游戏数据，然后 ROM 从内存中释放，不会复制进缓存。这意味着每次启动不会重复询问 ROM，但如果你换了另一个版本，就得重新导入。一个值得注意的细节：水晶有两个哈希，分别对应 1.0 和 1.1 版本，说明项目对 ROM 版本的敏感度很高。对普通用户来说，这意味着你必须持有精确的原版文件，任何修改过的 ROM（比如汉化版或 hack 版）都会被拒绝。这既是保护，也是限制。
引擎机制：Lua 手写逻辑与 ROM 数据解码
从 README 的描述看，Gen1Recomp 的架构分成两层。第一层是手写的 Lua 引擎，负责地图行为、战斗逻辑、菜单和输入。第二层是数据解码器，从 ROM 中提取图形、文本和音频。音频部分尤其特殊：音乐、音效和宝可梦叫声不是预先录制的，而是在运行时由从 ROM 中提取的“紧凑音频通道程序”合成。这意味着游戏体积可以很小，但 CPU 负担会增加。另一个关键点是，游戏逻辑采用固定步长（fixed-step），所有性能档位下逻辑完全一致，只有呈现层（如 3D 倾斜、缩放、着色器）会变化。这个设计保证了不同设备上的游戏体验一致，但也意味着低端设备只能牺牲视觉效果，不能降低计算精度。
规则集：忠实还原初代 bug，还是修正它们
Gen1Recomp 提供了一个名为“RULESET”的选项，用来切换 Gen 1 战斗行为。默认的 gen1_faithful 规则集完整保留原版卡带的 quirks，包括那个著名的 1/256 概率 miss（表格里明确写了 oneIn256Miss）。另一种规则集应该会修正这些 bug，但 README 被截断了，具体差异没有完全展示。这个设计对玩家和开发者都很有价值。对玩家，它让你在“原汁原味”和“现代体验”之间选择；对开发者，它展示了如何用配置驱动的方式管理游戏规则。但这也是一个维护负担，因为每个规则集都要覆盖所有战斗公式和状态效果，任何新功能（比如新规则集）都需要同步测试。
启动与运行：桌面应用、性能档位和热键
Gen1Recomp 以桌面应用形式分发，首次启动时选择或拖入 ROM 文件即可。导入只需几秒，然后游戏自动开始。控制支持键盘和手柄，按键可以在游戏内 OPTIONS → CONTROLS 里重绑定。热键包括 F1 保存、F2 读取、F10 打开模组管理器，以及用数字键切换游戏速度、颜色、倾斜和缩放。性能选项有 HIGH、BALANCED、LOW 和 AUTO，AUTO 会根据设备自动选择（ARM 手持设备用 LOW，手机用 BALANCED，桌面用 HIGH）。所有设置都持久化在 options.lua 文件中，模组也可以注册自己的选项。这个配置方式对模组生态很友好，但普通用户可能不太习惯直接编辑 Lua 文件。
安全警示：假冒网站与 Windows Defender 误报
README 里有一个醒目的警告，说 gen1recomp[.]com 这个网站不是项目方运营的，是冒充者，而且已经塞满了广告软件。项目方只认 GitHub 仓库、Discord 和 gen1re.com。这个警告本身就是一个重要信号：这个项目已经火到有人抢注域名蹭流量，但这也意味着用户必须警惕钓鱼网站。另一个问题是 Windows Defender 会把 Windows 构建标记为 Trojan:Win32/Wacatac!ml，项目方解释这是误报，因为可执行文件是 LÖVE 运行时加上游戏数据打包而成，Defender 对未签名且带追加数据的 exe 不信任。项目方提供了 SHA-256 校验和，并建议用户在 VirusTotal 上验证。对普通用户来说，这增加了使用门槛，但对技术用户来说，这是一个可以自行验证的问题。
Gen 2 的现状：金、银、水晶只是半成品
README 明确说，金、银、水晶的导入和启动器已经完成，但 Gen 2 引擎仍在建设中，所以启动器里把水晶标注为“Crystal (Beta)”。这意味着如果你导入金、银、水晶，你只能看到启动器，实际游戏内容可能还不完整。这是项目当前最大的功能缺口。对想玩 Gen 2 的玩家，现在不是最佳时机；对想参与开发的贡献者，这反而是切入点。相比之下，红、蓝、黄是完整可玩的。这个状态也影响项目的口碑，因为“支持金、银、水晶”听起来比实际体验更完整。如果你只关心 Gen 1，这个项目已经足够；如果你期待 Gen 2，需要等后续版本。
维护成本与许可证：MIT 下的社区依赖
项目采用 MIT 许可证，这意味着你可以自由使用、修改和分发，但需要保留版权声明。从仓库活动看，最近一次推送在 2026 年 8 月 28 日，版本更新频繁（v0.2.36 紧接着 v0.2.35），说明项目处于活跃开发状态。但活跃也意味着 API 可能变动，比如 options.lua 的格式或规则集名称可能在未来版本中变化。维护成本主要来自三方面：第一，ROM 的 SHA-1 校验需要随新版本更新；第二，Gen 2 引擎的长期开发；第三，防御假冒网站和误报问题。对个人开发者，这是一个可以学习的大型 Lua 项目；对想长期依赖它的玩家，需要关注版本更新日志。
编辑结论
谁适合用？想在不碰模拟器的情况下体验《宝可梦》红、蓝、黄、金、银、水晶原版流程，并且愿意为每个 ROM 支付一份正版拷贝的玩家，以及想研究 Gen 1 战斗规则（包括那些著名 bug）的开发者。谁不适合？期待开箱即玩、不想自己准备 ROM 的人，或者对 Windows Defender 误报零容忍的用户。在下载前，先做三件事：第一，确认你访问的是 GitHub 仓库或 gen1re.com，而不是那个冒充项目的 gen1recomp[.]com 网站；第二，核对下载文件的 SHA-256 校验和；第三，检查最新版本是否已解决 Gen 2 引擎未完成的问题，因为金、银、水晶目前只是导入和启动器阶段，游戏体验并不完整。Gen1Recomp 的核心价值在于它把 ROM 变成了一个可编程的 Lua 项目，但它的合法性边界和长期维护能力，取决于社区是否持续跟进。
社区笔记