海盗 3D 点击式冒险游戏模板仓（Three.js + Capacitor / iOS）

OpenEnroth 是一个用 C++ 编写的开源项目，目标是以现代代码重建《魔法门》第六、第七、第八代所使用的游戏引擎，让玩家能够在 Windows、Linux、macOS 以及实验性的 Android 设备上运行原版游戏。它不附带游戏本体或美术、音乐等资源，运行时读取玩家自备的原版游戏数据，因此更像一套兼容原版数据格式的现代运行环境，而非重新制作关卡与剧情的独立游戏。根据 README，目前只有《魔法门7：血与荣耀》达到可玩状态，MM6 与 MM8 的支持仍在计划中，具体进度可通过仓库的 milestones 查看。

玩法上，OpenEnroth 承接的是《魔法门7》的角色扮演体验，玩家仍需通过原版游戏数据体验完整的探索、战斗、成长与剧情推进流程。项目的重点在于重建引擎行为并让原作在现代平台上运行，而不是修改原版规则或重新设计内容。对于希望在现代系统上重温旧作的玩家，它提供了一条依赖原版资源的运行路径；对于开发者，它则是一个观察老游戏如何被现代代码承接的样本。

核心特性

从工程角度看，项目以 C++ 为主，仓库通过 GitHub Actions 配置了 build_release 与 lint 工作流，说明其同时关注多平台构建产物的生成和代码规范检查。README 明确列出 Windows、Linux、macOS 与 Android（实验性）作为支持平台，发布页提供 nightly 构建；稳定版仍在推进，并以 v0.1 milestone 作为阶段性目标。这意味着当前版本更适合愿意尝鲜、能够接受 bug 并提供反馈的玩家，而不是期待开箱即用稳定版的用户。开发文档集中在 HACKING.md，包含构建说明、代码风格和贡献指南，便于开发者从源码编译或参与改进。

要运行 OpenEnroth，玩家需要准备原版《魔法门7》的游戏数据。README 建议从 GOG.com 购买，也说明原始零售光盘等其他来源理论上也可用。游戏数据至少需要包含 ANIMS、DATA、MUSIC 和 SOUNDS 四个目录。若使用 GOG 安装包，Windows 上可直接运行安装器解压；Linux 和 macOS 上则可用 innoextract 提取安装包内容，README 给出了 Homebrew、apt、dnf 等安装方式以及 innoextract 的通用命令。项目还支持通过 OPENENROTH_MM7_PATH 环境变量覆盖资源路径，让引擎只在指定目录查找游戏资源，方便把数据放在非默认位置。

技术要点

各平台的安装方式差异较大。Windows 用户下载对应的 zip 压缩包，将 OpenEnroth.exe 与符号文件解压到游戏数据目录后运行即可，32 位系统可选择 x86 构建。macOS 用户需要把游戏数据放到 ~/Library/Application Support/OpenEnroth，下载 dmg 后把 OpenEnroth.app 拖入 Applications，并执行 xattr -rc 清除隔离标记，否则未签名程序可能无法启动。Linux 版以 Flatpak 形式发布，安装后需在 ~/.var/app/io.github.openenroth.openenroth/data/mm7/data/ 放置游戏数据，再通过应用菜单或 flatpak run 启动。Android 版本被明确标注为实验性，开发团队并未积极测试，需要手动安装 APK 并把 ANIMS、DATA、MUSIC、SOUNDS 复制到应用外部数据目录，遇到问题需自行排查。

OpenEnroth 适合作为研究老游戏引擎现代化重实现的案例：它展示了如何用现代 C++ 组织跨平台游戏运行环境、如何读取原版资源目录、如何通过环境变量和平台特定目录管理资源路径，以及如何用 CI 生成 Windows、Linux、macOS、Android 多平台构建。对学习跨平台打包（zip、dmg、Flatpak、APK）、发布 nightly 版本和管理大型开源协作流程也有参考价值。不过需要注意，项目当前只有 nightly 构建，README 明确提示可能存在 bug；稳定版仍在开发中，MM6 与 MM8 尚未可玩，Android 支持也不保证稳定。此外，玩家必须自行合法取得原版游戏数据，项目本身不提供游戏内容。国内用户从 GitHub Releases 下载、访问 Discord 或购买 GOG 版本时可能遇到网络与商店可访问性问题，具体以实际网络环境为准，相关依赖与构建步骤需按 HACKING.md 核对。