本页目录

五子棋 Web 版(gomoku-web)

gomoku-web · AMTYHHH/gomoku-web

基于 Cocos Creator、TypeScript 与 FairyGUI 构建的五子棋游戏,面向 Web、移动端和微信小游戏,主打离线优先。仓库描述称其为打磨过的离线五子棋,主题涵盖棋盘游戏、五子棋与游戏开发。需注意:仓库 README 摘要内容为另一项目(Nucle...

动作游戏 Roguelike 射击 GameMaker 其他 角色控制 敌人 AI 程序化生成 游戏状态管理 高级
★ Stars 87 Forks 11 License MIT 更新 2026-11-03

国内开发环境适配

Windows
官方声明支持
Linux
官方声明支持
macOS
官方声明支持
引擎 / 框架:GameMaker 暂无中文教程标记 未标记站长实测
构建需安装 GameMaker 与 NodeJS 20+,并从正版游戏提取素材;npm 依赖安装可能受网络影响,建议配置镜像,具体待核验。

中文项目介绍

本项目是经典俯视角射击游戏《Nuclear Throne》(核子王座)的开源重制与 Android 移植尝试。原版由 Vlambeer 开发,而这份重制基于 Update #19 的反编译源码起步,随后作者对工程进行了大范围重写,目标是让内容尽量贴近《Nuclear Throne》最新版本的表现。

需要先明确一点:仓库本身不包含原游戏的任何素材。想要把项目编译出来,必须从自己持有的正版游戏中提取资源,并且要求版本为 Update 100 及以上。换句话说,这是一个「代码开源、素材自备」的工程,适合已经拥有正版游戏、希望研究其实现或想在移动端体验的玩家与开发者。

项目同时提供了一份免费的 Android 移植版本,发布在 itch.io 上,供不便自行构建的用户直接体验。

技术架构分析

构建方式

由于原版同样使用 GameMaker 制作,本项目也基于 GameMaker 引擎,因此构建前需要在本机安装 GameMaker。

资源提取

资源提取依赖一组随仓库提供的脚本,运行前请确认:

  • 本机已安装 NodeJS 20.0 及以上版本(部分平台可能还需单独安装 npm);
  • 已拥有 Update 100 或更高版本的《Nuclear Throne》正版副本。

默认情况下,脚本会在 Steam 库中查找游戏文件,因此只要 Steam 库安装在常规位置,就无需额外配置。若游戏安装在自定义路径,可在执行脚本时通过参数指定:

npm run regen --game-path="/your/path/here/"

一键脚本与手动流程

克隆仓库后,在项目根目录打开终端执行:

  • Windows:.\project-setup-windows.bat
  • Linux:bash ./project-setup-linux.sh

也可以不用批处理脚本,手动执行:

cd node-scripts
npm ci
npm run regen

执行完成后,素材会被自动提取并复制进仓库中的 GameMaker 工程,使其具备可编译状态。

此外,当你引入此前工程中不存在的新基础游戏素材时,需要运行 npm run regen-ignores,它会更新忽略文件,避免这些原始素材被误提交到版本库中。

补充说明

目标平台

项目的核心目标之一是提升可移植性与可访问性:一方面加入触屏操作,另一方面实现键盘鼠标与手柄支持。不过,可支持平台的范围严格受限于 GameMaker 的导出选项,官方列出的可选目标包括:

  • 桌面端:Windows、Ubuntu、macOS
  • 移动端:Android、iOS(含 iPadOS)

理论上也可以面向当前世代主机导出,但这需要专业的商业版 GameMaker 授权,超出本项目范围——尽管技术上「是可能的」。至于 HTML5 导出,由于表现较为古怪,项目明确表示不支持。

第三方库

项目在实现中借助了若干开源库:

  • GML 侧
    • Input 3:输入处理,主要用于手柄按键映射;
    • native_cursor:用于桌面平台的原生光标;
    • execute_shell_simple:用于多人测试,不会随最终可执行文件发布。
  • JavaScript 侧
    • pngjs:读写 PNG 图像数据。

学习与使用建议

这个仓库更适合两类人:一是已经拥有正版《Nuclear Throne》、想研究 GameMaker 工程组织与 GML 代码风格的开发者;二是希望在 Android 设备上体验移植版的玩家。由于素材需要自行提取、构建依赖 GameMaker 与 NodeJS 环境,上手门槛并不低。另外,README 并未说明当前重写的完成度与可玩性,实际效果建议以自行构建或 itch.io 发布版本为准。

开源许可证与版权说明

许可证标识:MIT。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目