本页目录

Godot 扫雷复刻版(Minehunter)

Minehunter · genete/Minehunter

Minehunter 是用 Godot 引擎(GDScript 编写)实现的扫雷游戏复刻版。玩法与原版扫雷基本一致:左键翻开未插旗的格子,右键在空白、插旗和问号三种标记之间切换;如果翻开的格子周围没有雷,就会自动连锁翻开相邻格子;在已翻开的数字格...

动作游戏 Roguelike 休闲 Godot Cocos Creator GDScript JavaScript 角色控制 敌人 AI 存档系统 游戏状态管理 入门
★ Stars 19 Forks 3 License MIT 更新 2026-11-07

国内开发环境适配

Windows
未知
Linux
未知
macOS
未知
引擎 / 框架:Godot 暂无中文教程标记 未标记站长实测
仓库未列出第三方依赖与 Godot 版本要求,需自行核验;国内获取 Godot 编辑器可通过官网或镜像,工程本身为纯脚本项目,无包管理器拉取步骤。

中文项目介绍

Minehunter 是一个用 Godot 引擎写成的开源扫雷复刻项目,仓库自述非常简单:"A Minesweeper clone made with Godotengine"。它的目标并不是重新设计扫雷规则,而是把这套已经被验证过无数次的经典玩法,原样搬进 Godot 的节点与 UI 体系里,因此整个工程更像一次「把熟悉的小游戏翻译成引擎语言」的练习,而不是一次玩法创新。

从代码组织上看,项目使用 GDScript 编写,没有引入额外的脚本语言或第三方库;README 的篇幅也很短,只保留了用法说明、一份待办清单和两张运行截图。这种极简的仓库形态,正好适合拿来当作阅读成本很低的 Godot 实例:你可以很快看完规则描述,然后把注意力放在「扫雷的格子、旗子、数字提示这些东西,在 Godot 里是怎么被搭起来的」。

玩法指南

README 的 Usage 一节把交互规则列得很清楚,和原版扫雷基本对齐:

  • 左键翻开:在未插旗的、处于关闭状态的格子上按下左键,就把这一格打开。
  • 右键循环标记:在关闭状态的格子上右键单击,标记会在「空白 → 旗子 → 问号」三种状态之间轮换,其中问号只是一个备忘提示,并不参与自动判定。
  • 空白区域连锁展开:如果翻开的格子周围一颗雷都没有,就会递归地把相邻格也一起翻开,也就是常见的「一片空白瞬间铺开」的效果。
  • 数字格快速清区:在已经翻开的数字格上左键单击,程序会检查这一格周围插了多少面旗;如果旗子数量与该数字相等,就把周围剩下的关闭格全部翻开。需要留意的是,这个操作并不会校验旗子插得对不对——一旦有插错的旗,就可能顺手翻开真正的地雷并引发爆炸。

这套规则意味着项目至少要处理三件事:格子状态的切换、周围雷数的统计、以及基于相邻关系的递归展开。它们都不复杂,但组合起来足以覆盖 Godot 中「网格化 UI + 输入事件 + 局部状态机」的典型写法。

技术架构分析

技术要点

  • 引擎与语言:Godot 引擎,逻辑用 GDScript 编写,属于引擎原生脚本方案,不需要额外的绑定层。
  • 输入映射:左键与右键各自承担不同语义,右键还要在三种标记状态间循环,这需要在单个格子节点上区分按键并维护自身的标记状态。
  • 递归展开:空白格的连锁翻开天然是一个递归过程,实现时要处理「已经翻开过的格子不再重复进入」的问题,否则容易重复遍历。
  • 基于数字的批量判定:在数字格上点击时,先统计周围旗数再决定是否批量翻开,这是一次典型的「先检查后动作」流程。
  • 胜负反馈:通过顶部栏的表情图标切换来表现输赢状态,是该项目已完成的交互细节。

构建与运行

README 没有提供构建、导出或依赖安装的说明,也没有给出所需的 Godot 版本号,因此这些信息需要打开仓库自行确认。按 Godot 项目的通用做法,通常是使用 Godot 编辑器导入工程目录后直接运行主场景;具体版本兼容性待核验。项目未声明对 Windows、Linux 或 macOS 的支持情况,README 也没有提供在线试玩地址或发布包链接。

补充说明

界面现状与待办清单

README 的 TODO 部分很坦率地列出了项目当前还不满意的地方,这部分信息比截图更能说明工程处在什么阶段:

  • 失败或胜利时切换笑脸表情 —— 这一项已被划掉,表示已经完成,也就是说游戏具备胜负判定,并能通过顶部栏的表情图标反馈结果。
  • 修正顶部栏(header)的对齐方式:目前它是以窗口尺寸为基准居中的,作者希望改成始终与格子区域对齐。
  • 调整宽、高和雷数三个文本输入框的尺寸,让它们不要占那么大地方。
  • 改进文本标签与输入框的外观样式。

这三条未完成项集中在界面布局与控件样式上,属于 Godot 的 Control 布局范畴,而不是玩法逻辑的缺口。换句话说,核心规则已经跑通,剩下的主要是打磨。

仓库还附带了两张截图,文件名分别对应 10x10 与 10x20 两种棋盘尺寸,从命名看还带有雷数参数(15 与 25)。这说明程序接受自定义的宽度、高度与雷数这三个参数来生成对局,而不是把棋盘写死成某一个规格。

学习建议

Minehunter 的体量很小,适合作为 Godot 的入门级阅读材料,尤其是想练习「用 Control 节点拼一个网格界面」的读者。建议按三条线索去读:先看棋盘是如何根据宽、高、雷数三个参数生成的;再看单个格子的左键/右键分流与三态标记;最后看空白格递归展开与数字格批量翻开的判定顺序。把这三块理清之后,再回头看 TODO 里那几条布局问题,就能理解作者为什么会被「顶部栏跟随窗口居中而不是跟随格子居中」这种事卡住——这恰好是 Godot UI 布局里最常见的一类对齐陷阱。

开源许可证与版权说明

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

相似项目