《前端群侠传》是一款使用 Godot 4.7 和 GDScript 开发的 2D 俯视角格子角色扮演游戏。游戏把现代前端技术生态变成了一座江湖：编码、思维、架构和灵感是角色的四项根骨，技术流派化作门派，工程知识则成为可以学习、修炼和用于战斗的功法。
在线试玩：game.706x.com
高考落榜、求职碰壁的你，在网吧门口捡到了一张写着“码界招工”的传单。签下名字后，你被传送到陌生的开源镇，从一名什么都不会的异界开发者开始闯荡。
在这里，你会遇见形形色色的江湖人物，探索以前端技术命名的地区与门派，并逐渐决定自己要走哪一条技术之道。
游戏以探索、成长和战斗为核心：
- 在格子地图中探索开源镇及周边区域，与人物、建筑和地图事件互动。
- 完成固定任务、环任务与动态目标，获得金钱、潜能和物品奖励。
- 拜入 NG 神教、香草派、鱿鱼山庄、量子仙宗等门派，向不同师父学习功法。
- 通过学习、练功和冥想提升实力，搭配基础功法与门派高级功法。
- 与江湖人物切磋或进行生死战，根据敌人的下一回合意图选择攻击、防御、恢复和分档门派绝招；不同战斗原型拥有不同决策偏好。
- 击败静态人物会留下可保存的休整时间与交手次数，人物复出后的对白和详情会回应过去战绩。
- 管理饥饿、口渴、体力、精力与伤势，通过交易、装备和消耗品维持冒险。
- 使用赛博传送往返已经发现的区域，并通过游戏内菜单保存进度。
创建角色时可选择姓名、性别，并在编码、思维、架构、灵感四项属性之间分配点数。不同属性会影响战斗表现、生存能力和技能成长。
地图采用 16×16 像素图块，并在运行时直接加载 Tiled 的 TMX 地图与 TSX 图块集。
菜单提供角色查看、背包、技能与系统功能。技能菜单包含冥想、练功、加力和功法，系统菜单则提供赛博传送、摸鱼（以精力换体力）、疗伤、保存与退出。
| 操作 | 键盘 | 移动端 |
|---|---|---|
| 移动或选择 | 方向键 | 屏幕方向键 |
| 确认、互动 | 空格 | 确认按钮 |
| 打开或返回菜单 | Esc | 取消按钮 |
| 战斗选项 | 方向键 + 空格 | 方向键 + 确认按钮 |
移动端会显示虚拟按键，并请求横屏运行。Web 版输入角色姓名后，按回车完成姓名输入。
需要 Godot 4.7。使用 Godot 打开仓库根目录下的 project.godot，然后运行项目即可。
macOS 也可以在仓库根目录执行：
./tools/godot-safe.sh --editor请优先使用该安全入口。Godot 4.7 在部分 macOS 或受限环境中无法写入默认 user://logs 时可能直接崩溃；脚本会为每次运行显式创建位于 /tmp 的独立日志。故障说明见 Godot 稳定启动与崩溃处理。
导出前先运行统一发布闸门：
npm run release:check闸门会验证数据与工作簿、五个平台预设、0.8.2 版本一致性、发布包资源过滤、源码规模和全量 Godot 测试，并实际导出一次 Web 包检查加载页版本。测试存档、设置、日志和检查用导出包均隔离到 /tmp，不会读取或覆盖正式 user:// 数据。
所有平台统一从 Godot 的“项目 → 导出”面板发布，不再运行独立构建脚本。项目已配置 Web、macOS、Windows Desktop、Android 和 iOS 五个预设：
- Web：选择
Web后点“导出项目”，生成dist/web/index.html及配套文件。音频、TMX、 TSX 和图集定义都直接进入主包，不再需要 Node 哈希或地区分包步骤。加载页版本会在导出 完成后自动读取project.godot的config/version，无需修改 HTML。 - macOS：选择
macOS后导出dist/macos/FrontendLegends.app。预设已选择Developer ID Application: Manon Loki (GKVE4TEFQ6)证书；若要面向公网分发，请在 “Notarization”中选择“Xcode notarytool”，并在本机面板填写 Apple ID 专用密码或 App Store Connect API 凭据。凭据属于本机秘密，不应提交到export_presets.cfg。 - iOS：选择
iOS后导出dist/ios/FrontendLegends.ipa。勾选导出窗口中的 “Export With Debug”会使用 Development 签名，适合连接的真机；不勾选则使用 App Store 发布签名。预设已配置 Bundle IDcom.manonloki.frontendlegends、Team IDGKVE4TEFQ6、自动签名、iOS 15 最低版本以及 iPhone/iPad 目标。
iOS 真机首次使用时，仍需在设备上开启开发者模式，并在 Xcode 中完成设备配对和 Apple 开发者账号登录；这些是本机钥匙串与设备信任状态，不能安全写入项目配置。
当前版本：0.8.2（以 project.godot 的 config/version 为准）