Mindustry 服务器搭建指南：3 步从构建服务端到联机验证
【免费下载链接】MindustryThe automation tower defense RTS项目地址: https://gitcode.com/GitHub_Trending/min/Mindustry
本文目标只有一个：在你的机器上跑起一台 Mindustry 服务器，并让游戏客户端成功连入。全程按三个连续任务推进，每个任务都有可观察的完成信号。
前置条件：JDK 与 Git 检查
Mindustry 服务器联机教程的第一步是确认环境。项目用 Java 编写，官方 README 明确只支持 JDK 17，其余版本不可用。
| 依赖 | 版本要求 | 检查方式 |
|---|---|---|
| JDK | 17 | 终端执行java -version，输出应含 17 |
| Git | 较新版本即可 | 终端执行git --version |
任务一：获取并构建 Mindustry 服务器程序
目的：拿到源码并构建出可运行的服务端 jar。
操作：
git clone https://gitcode.com/GitHub_Trending/min/Mindustry cd Mindustry ./gradlew server:distWindows 下把./gradlew换成gradlew即可，其余相同。首次构建会下载依赖，耗时几分钟属正常现象。
验证：构建完成后，server/build/libs/目录下会出现server-release.jar。看到这个文件，任务一结束。
任务二：拉起服务端并开放世界
目的：启动服务进程，并在控制台开放一局游戏。
操作：
java -jar server/build/libs/server-release.jar服务就绪后，在控制台输入host开放世界（缺省为 survival 模式加随机地图）。仓库的 server/server_template/ 目录里放着run_server.sh与run_server.bat两个启动脚本，内容同样是一行java -jar server.jar，可视为同一操作的快捷方式。
验证：终端先输出Server loaded. Type 'help' for help.，随后host命令执行完会输出Map loaded.。两行日志都出现，说明服务器已在本机 6567 端口监听（该默认值定义在 core/src/mindustry/Vars.java）。
常用控制台参数如下：
| 参数 | 作用 | 默认值 |
|---|---|---|
| 6567（端口） | 服务端监听端口，客户端连接时填写 | 6567 |
host [mapname] [mode] | 开放一局游戏并开始托管 | survival、随机地图 |
playerlimit [off/数字] | 设置玩家人数上限，不带参数可查询 | 用不带参数方式查询当前值 |
任务三：客户端直连验证联机
目的：用真实游戏客户端确认服务器可达。
操作：
- 打开 Mindustry 游戏，进入"多人游戏"，选择"直接连接"
- 填写地址与端口：本机测试用
127.0.0.1，局域网使用服务器所在机器的 IP，端口填 6567 - 点击连接，等待进入地图
验证：连接成功后，回到服务器控制台输入status，输出的Players:一列下方应列出刚连入的玩家名称。看到自己的名字，Mindustry 服务器搭建与联机全部完成。
🔧 故障速查
| 现象 | 常见原因 | 处理 |
|---|---|---|
| 构建或启动直接报错 | JDK 不是 17 | 安装 JDK 17 后重新执行./gradlew server:dist |
| 客户端一直连不上 | 防火墙拦截 6567 端口，或服务端尚未开放世界 | 在防火墙放行 6567 端口；确认服务端已执行host且日志出现Map loaded. |
| 控制台中文显示乱码 | 终端编码与 JVM 默认编码不一致 | 启动命令改为java -Dfile.encoding=UTF-8 -jar server/build/libs/server-release.jar |
📚 延伸阅读
如果希望服务器崩溃后自动重启，可以改用仓库自带的 server/run-server 脚本（第一个参数传入构建版本号，它负责构建并循环拉起服务）；连接握手与数据包的实现位于网络模块 core/src/mindustry/net/，构建细节则可对照 README.md 阅读，从这里可以继续深入这台 Mindustry 服务器的内部机制。
【免费下载链接】MindustryThe automation tower defense RTS项目地址: https://gitcode.com/GitHub_Trending/min/Mindustry
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
