mirror of https://github.com/LHY0125/Gobang-Game.git synced 2026-05-09 18:09:46 +08:00

Files

T

Serendipity 249dc2ab4b build(installer): 精简安装包配置并移除NSIS脚本

- 删除 NSIS 安装脚本 (installer.nsi)，统一使用 Inno Setup
- 简化 Inno Setup 脚本，仅打包核心运行文件 (gobang_gui.exe, iup.dll) 和记录目录
- 移除源码、文档等开发文件，减小安装包体积
- 更新 README.md 以反映 v9.0 版本变更，专注于图形界面和网络功能

2026-03-17 18:10:40 +08:00

6.0 KiB

Raw Permalink Blame History

C语言五子棋系统

🎯 最新版本 v9.0 - 全面集成 ENet 网络联机功能，重构 GUI 代码架构，纯图形化交互体验。

📋 大版本更新

v9.0 (2026-03-17) - 局域网联机与 GUI 架构重构

🌐 局域网对战 - 引入 ENet 库，支持稳定、无粘包的局域网多人对战（创建房间/加入房间）。
🎨 GUI 深度重构 - 拆分臃肿的 GUI 代码，模块化为 gui_core, gui_game, gui_menu, gui_draw, gui_replay，大幅提升可维护性。
📦 精简安装包 - 优化 Inno Setup 打包脚本，实现极简核心依赖打包。
� 全面摒弃控制台 - 专注于基于 IUP 的原生图形化交互体验。

项目简介

这是一个使用纯 C 语言编写的现代化五子棋系统。采用轻量级的 IUP 库构建原生风格的图形化用户界面。系统不仅支持基于 Minimax 算法（带 Alpha-Beta 剪枝）的高级人机对战，还完美支持基于 ENet 的局域网多人实时联机对弈。

功能特性

🎮 游戏模式

人机对战 (PvE) - 挑战 1-5 级难度的智能 AI。
局域网联机 (Network) - 建立主机或作为客机加入，与朋友在局域网内实时对战。
复盘模式 (Replay) - 载入自动保存的对局记录（CSV），逐步回放并分析对局。

⚙️ 核心功能

实时对局控制 - 支持悔棋（PvE）、断线重连检测、胜负判定。
自动游戏记录 - 每局游戏结束后自动保存至 bin/records/ 目录。
模块化构建 - 提供高度配置化的 Makefile，一键源码编译包含 ENet 和主程序的二进制文件。

快速开始

编译项目

项目使用 Makefile 进行构建，依赖 MinGW-w64 工具链。在项目根目录下打开 PowerShell 或 CMD，运行：

# 清理旧文件
mingw32-make clean

# 编译生成 GUI 可执行文件
mingw32-make gui

生成的可执行文件 gobang_gui.exe 和所需的动态链接库 iup.dll 会输出到 bin/ 目录下。

运行游戏：

.\bin\gobang_gui.exe

打包安装程序

如果你需要将游戏打包成 Windows 安装程序，项目提供了 Inno Setup 脚本。确保你已安装 Inno Setup 6，然后运行：

& "D:\Program Files (x86)\Inno Setup 6\iscc.exe" installer\installer.iss

生成的安装包 Gobang_Inno_Setup.exe 将存放在 installer\dist\ 目录下。

游戏玩法

运行 gobang_gui.exe 启动游戏主菜单。
选择你要进行的游戏模式：
- 人机对战：直接进入游戏，玩家执黑先行，点击棋盘空白处落子。
- 局域网联机：
  - 作为房主：点击“局域网联机” -> “创建房间”，等待好友加入（默认端口8888）。
  - 作为玩家：点击“局域网联机” -> 输入房主的 IP 地址和端口 -> “加入房间”。
- 复盘模式：选择历史对局记录，使用“上一步/下一步”按钮进行回放。

技术架构

AI 算法

Minimax 博弈树：遍历所有可能的落子情况。
Alpha-Beta 剪枝：极大提升搜索效率，AI 默认思考深度为 3 层。
启发式评估函数：基于连五、活四、冲四、活三等经典五子棋棋型进行棋局评分。

网络通信

底层库：ENet (基于 UDP 的可靠网络传输协议)。
机制：游戏采用非阻塞轮询机制处理网络事件，完美解决传统 TCP 粘包问题，确保落子坐标、断开连接等指令 100% 可靠送达。

图形界面

底层库：IUP (轻量级、跨平台的 C 语言原生 GUI 库)。
机制：事件驱动架构，通过回调函数响应用户的鼠标点击、按钮触发和窗口切换。

项目结构

Gobang/
├── bin/                    # 编译输出目录 (包含 exe, dll 和 records)
├── include/                # 头文件目录
├── libs/                   # 第三方库源码及预编译库 (ENet, IUP)
├── src/                    # 核心源代码
│   ├── main.c              # 程序入口
│   ├── gobang.c            # 五子棋核心规则与逻辑
│   ├── ai.c                # 智能 AI 算法
│   ├── network.c           # ENet 网络通信封装
│   ├── record.c            # 棋谱记录与解析
│   ├── gui_core.c          # GUI 初始化与核心循环
│   ├── gui_game.c          # 游戏主界面与交互逻辑
│   ├── gui_menu.c          # 游戏主菜单界面
│   ├── gui_draw.c          # 棋盘与棋子渲染
│   └── gui_replay.c        # 复盘模式交互逻辑
├── installer/              # Inno Setup 安装包打包脚本及输出
├── Makefile                # 自动化构建脚本
└── README.md               # 项目说明文档

许可证

本项目采用 MIT 许可证授权。欢迎自由修改和分发！

6.0 KiB Raw Permalink Blame History Unescape Escape