Skip to content
draphPublic

About

a gobang game developed in Java

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

五子连珠(Gobang)

English | 简体中文

Java Gradle License

一个使用 Java Swing 编写的 15×15 五子棋桌面游戏,支持双人对弈、人机对弈、棋局保存与回放,并提供四档搜索 AI、禁手规则和背景/音乐设置。

主界面

功能特性

  • 对弈模式:双人对战 / 人机对战,AI 提供新手、业余、职业、大师四档难度
  • 规则完整:黑方禁手(三三、四四、长连)可开关,白方不受限制;五连即胜
  • 对局操作:新局、悔棋、暂停/继续、认输、结束,终局后进入复盘逐步回放,支持自动打谱
  • 棋局存档:.save 文件保存与导入,内置文件浏览器支持目录跳转和覆盖确认
  • 棋谱记录:左侧栏实时列出每一手坐标,可随棋盘坐标、棋子步数一起开关
  • 界面与音效:三套中国风背景、背景音乐列表、落子/终局音效、胜负印章与胜利连线动画
  • 对局计时:双方独立计时,轮到谁下谁显示"思考中"

界面截图

终局 复盘
终局 复盘

环境要求

  • JDK 21
  • Windows、macOS 或 Linux 桌面环境

构建、运行和测试

在仓库根目录执行:

./gradlew build
./gradlew run
./gradlew test

Windows 可使用 gradlew.bat。首次运行 Gradle Wrapper 时需要网络下载 Gradle。运行游戏时请从仓库根目录启动,以便应用找到本地音乐和运行数据目录。

如需可分发版本,可使用:

./gradlew installDist   # 产物:build/install/gobang/bin/gobang
./gradlew distZip       # 产物:build/distributions/gobang-1.0.0.zip

应用按启动时的工作目录读取音乐、配置和存档,发行版脚本在哪个目录启动,就会在该目录使用或创建 music/、config/、save/、logs/。

玩法与操作

  • 标题栏可点击 AI / 1v1 切换对战模式,点击难度名称切换 AI 档位。
  • 右侧按钮依次为新局、悔棋、暂停/继续、认输、结束、复盘;下方提供棋局保存与导入。
  • 点击标题栏当前曲名可打开音乐列表并切换音乐,旁边的图标分别控制音乐和音效;齿轮图标打开设置侧栏。
  • 设置侧栏可开关棋盘坐标、棋子步数、禁手规则和棋谱记录,底部显示版本、作者与许可证信息。
  • 窗口没有系统标题栏,按住游戏区域拖动即可移动窗口。

规则与 AI

棋盘为 15×15。双方轮流落子,先连成五子者获胜;开启禁手时,黑方不能落出长连、三三或四四,白方不受这些禁手限制。游戏还支持人机难度选择、悔棋/回放及棋局记录。

AI 提供新手、业余、职业和大师四档。搜索会检查直接胜负与强制防守,使用棋形评估、VCF 威胁搜索和开局知识;各难度使用不同的搜索深度、候选数和预算。开局知识能力已接入,当前生产开局书谱资源尚无理论局面数据。

数据与配置目录

目录 / 文件 用途
config/application.properties 用户设置(难度、禁手、背景、音乐等);首次运行自动生成,删除后恢复默认
save/ 棋局存档默认目录,存放 .save 文件
logs/gobang.log 运行日志,历史日志归档在 logs/archive/
music/ 背景音乐目录,启动时扫描其中的 MP3

以上路径都相对启动游戏时的工作目录,因此请从想要使用数据的目录启动,通常就是仓库根目录。config/、save/、logs/ 已在 .gitignore 中忽略,不会提交到仓库。

添加背景音乐

将本地 MP3 文件放入项目根目录的 music/ 文件夹。游戏启动时会自动读取并加入音乐列表;启动后新添加的文件需重启游戏才能识别。点击标题栏当前曲名可打开列表并切换音乐。

音乐素材来源

  • 中国风:作者崔辉,许可 CC-BY,来源:耳聆网

常见问题

  • 启动后没有背景音乐:确认 music/ 目录中存在可读的 MP3 文件;游戏只在启动时扫描一次,运行中添加的文件需要重启。
  • 提示无法加载配置信息:请从仓库根目录(或希望使用数据的目录)启动游戏,首次运行会自动生成默认配置。
  • Linux 下字体与截图不同:界面优先使用"华文行楷 / 华文楷体",系统缺少这些字体时会回退到默认字体,不影响运行。
  • 旧存档无法导入:存档会进行结构与棋谱一致性校验,不保证所有历史版本文件可读,建议使用当前版本保存的棋局。
  • AI 落子失败导致对局暂停:AI 搜索异常时对局会暂停并提示,可查看 logs/gobang.log 中的详情。

项目结构

src/main/java/com/efun/gobang/
├── ai/        AI 搜索、评估与开局知识
├── control/   对局与复盘控制
├── record/    棋局状态与存档读写
├── ui/        Swing 界面组件
└── app/ config/ params/ media/ util/ constant/   启动装配与公共服务
src/main/resources/   图片、音效、默认配置与开局书

贡献与反馈

欢迎通过 Issue 反馈问题或提出建议;提交 PR 时请说明变更目的,并列出验证命令与结果。UI 相关改动建议附上截图或录屏。

License

项目自身代码采用 MIT License。仓库中的第三方素材遵循各自许可;音乐素材来源和署名见上文。

About

a gobang game developed in Java

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages