Files
d1kt/MINESWEEPER_QUICKSTART.md

4.6 KiB
Raw Blame History

扫雷游戏快速启动指南

🎮 立即开始

扫雷游戏已成功集成到项目中!按照以下步骤即可开始使用:

📋 前置要求

确保项目环境已正确配置:

  1. MongoDB: 确保MongoDB服务正在运行
  2. 环境变量: 确保.env文件包含必要的配置
  3. 依赖安装: 运行npm install安装所有依赖

🚀 启动应用

# 启动开发服务器
npm run start

服务器将在以下端口启动:

🎯 访问游戏

方式1: 通过导航菜单

  1. 打开浏览器访问 http://localhost:3001
  2. 在顶部导航栏找到"扫雷游戏"菜单
  3. 点击"开始游戏"进入游戏界面

方式2: 直接访问

🎲 游戏操作

基本操作

  • 左键点击: 揭开格子
  • 右键点击: 插旗/取消插旗
  • 选择难度: 使用顶部下拉菜单切换难度
  • 重新开始: 点击"重新开始"按钮

难度选择

难度 大小 地雷数 说明
初级 9×9 10 适合新手
中级 16×16 40 适合有经验玩家
高级 16×30 99 适合专家

📊 查看排行榜

  1. 点击导航栏"扫雷游戏" → "排行榜"
  2. 选择想查看的难度级别
  3. 查看各难度的最佳成绩

排行榜说明

  • 只显示获胜记录
  • 按完成时间从短到长排序
  • 前三名有特殊标记 🥇🥈🥉
  • 支持分页浏览

👤 登录与记录保存

游客模式

  • 可以玩游戏
  • 不会保存记录
  • 看不到个人最佳成绩

登录模式

  • 游戏记录自动保存
  • 显示个人最佳成绩
  • 计入排行榜

登录方法

  1. 点击导航栏"登录"
  2. 输入用户名和密码
  3. 登录成功后即可保存记录

🏆 个人最佳成绩

登录后,在游戏界面会显示您的个人最佳成绩:

  • 显示在控制面板中
  • 打破记录时会有提示 🎉

🔧 故障排查

问题1: 游戏无法访问

解决方案:

  • 确保服务器正在运行
  • 检查控制台是否有错误信息
  • 清除浏览器缓存重试

问题2: 记录无法保存

解决方案:

  • 确保已登录
  • 检查MongoDB是否正在运行
  • 查看浏览器控制台网络请求

问题3: 排行榜为空

解决方案:

  • 这是正常现象,需要有用户完成游戏后才会有数据
  • 登录后玩一局并获胜,即可看到记录

问题4: 右键菜单无法使用

说明:

  • 游戏区域的右键被用于插旗功能
  • 在游戏区域外可以正常使用浏览器右键菜单

📱 浏览器兼容性

推荐使用以下浏览器:

  • Chrome (推荐)
  • Firefox
  • Safari
  • Edge

🎨 界面说明

控制面板

  • 难度选择: 下拉菜单,可随时切换难度
  • 旗帜计数: 显示剩余可用旗帜数
  • 计时器: 显示游戏进行时间
  • 重新开始: 重置当前难度的游戏
  • 个人最佳: 显示当前难度的最佳成绩(需登录)

游戏区域

  • 未揭开格子: 灰色方块
  • 已插旗格子: 显示🚩标记
  • 已揭开格子: 浅灰色,显示周围地雷数
  • 地雷: 游戏结束后显示💣

结果对话框

  • 游戏结束时自动弹出
  • 显示难度、用时等信息
  • 提供"关闭"和"再来一局"选项

📈 数据统计

登录用户可以查看:

  • 各难度最佳时间
  • 总游戏次数
  • 获胜次数
  • 胜率

🎯 游戏技巧

  1. 首次点击: 选择靠近中间的位置,有更大概率展开大片区域
  2. 标记地雷: 确定是地雷的位置及时插旗,避免误点
  3. 数字推理: 利用数字推断周围地雷位置
  4. 角落优先: 角落和边缘的格子相对安全
  5. 概率思维: 在不确定时选择概率较低的位置

🔗 相关链接

常见问题

Q: 为什么首次点击不会触发地雷? A: 这是保护机制,确保游戏有良好的开局,避免首次点击即失败。

Q: 可以自定义难度吗? A: 当前版本不支持自定义,因为需要统一标准才能进行排名。

Q: 排行榜多久更新一次? A: 实时更新,每次游戏结束后立即保存并更新排行榜。

Q: 可以查看历史记录吗? A: 当前版本只显示最佳成绩,未来可能会添加详细历史记录功能。

💡 下一步

尝试以下操作:

  1. 完成一局初级游戏
  2. 挑战中级难度
  3. 查看排行榜,与其他玩家比较
  4. 尝试打破自己的最佳记录

祝您游戏愉快! 🎮