English | 简体中文
一个使用 Java Swing 编写的 15×15 五子棋桌面游戏,支持双人对弈、人机对弈、棋局保存与回放,并提供四档搜索 AI、禁手规则和背景/音乐设置。
- 对弈模式:双人对战 / 人机对战,AI 提供新手、业余、职业、大师四档难度
- 规则完整:黑方禁手(三三、四四、长连)可开关,白方不受限制;五连即胜
- 对局操作:新局、悔棋、暂停/继续、认输、结束,终局后进入复盘逐步回放,支持自动打谱
- 棋局存档:
.save文件保存与导入,内置文件浏览器支持目录跳转和覆盖确认 - 棋谱记录:左侧栏实时列出每一手坐标,可随棋盘坐标、棋子步数一起开关
- 界面与音效:三套中国风背景、背景音乐列表、落子/终局音效、胜负印章与胜利连线动画
- 对局计时:双方独立计时,轮到谁下谁显示"思考中"
| 终局 | 复盘 |
|---|---|
![]() |
![]() |
- JDK 21
- Windows、macOS 或 Linux 桌面环境
在仓库根目录执行:
./gradlew build
./gradlew run
./gradlew testWindows 可使用 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 档位。 - 右侧按钮依次为新局、悔棋、暂停/继续、认输、结束、复盘;下方提供棋局保存与导入。
- 点击标题栏当前曲名可打开音乐列表并切换音乐,旁边的图标分别控制音乐和音效;齿轮图标打开设置侧栏。
- 设置侧栏可开关棋盘坐标、棋子步数、禁手规则和棋谱记录,底部显示版本、作者与许可证信息。
- 窗口没有系统标题栏,按住游戏区域拖动即可移动窗口。
棋盘为 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 相关改动建议附上截图或录屏。
项目自身代码采用 MIT License。仓库中的第三方素材遵循各自许可;音乐素材来源和署名见上文。


