Mindustry 多人服务器搭建指南:30 分钟从源码编译到朋友连入

Mindustry 多人服务器搭建指南:30 分钟从源码编译到朋友连入【免费下载链接】MindustryThe automation tower defense RTS项目地址: https://gitcode.com/GitHub_Trending/min/Mindustry这是一篇面向第一次开服的新手的 Mindustry 服务器教程,按步骤操作即可在局域网乃至公网上跑起一个可多人接入的 Mindustry 服务器。全程大约 30 分钟,其中一半是 Gradle 首次构建的等待时间。你只需一台装了 JDK 17 的电脑和一个 Mindustry 客户端,不需要其他依赖。一、一次性准备:JDK 17 与三个关键目录Mindustry 的构建脚本会硬性校验 Java 版本,低于 17 直接抛错退出,所以这一步没有替代方案:java -version # 应显示 17.x,不是就用 JDK 17 覆盖 JAVA_HOME准备清单,逐项核对即可:JDK 17(Adoptium Temurin 17 或任意 17 发行版)Git拉取源码:git clone https://gitcode.com/GitHub_Trending/min/Mindustry cd Mindustry接下来只需要认识三个目录,后文所有操作都围绕它们:目录作用server/服务器模块源码与 启动脚本模板core/assets/游戏资源,含 内置地图core/src/mindustry/net/网络与服务端逻辑,含 Net.java、Administration.java二、本地运行最短路径:编译、启动、连 127.0.0.1目的是先在本机闭环验证,再考虑对外开放。第一步用 Gradle 打包服务端,首次构建需 3~5 分钟:./gradlew server:dist # Windows 用 gradlew server:dist产物是server/build/libs/server-release.jar,一个自带全部依赖的可执行 jar。启动它:java -jar server/build/libs/server-release.jar终端打印出监听信息后,打开客户端,进入多人游戏 → 直接连接,地址填127.0.0.1:6567(端口 6567 是默认值),看到自己的核心出现在地图上,本地闭环就通了。三、让朋友连进来:端口、防火墙与 JVM 参数从本机连到跨网络连,差异只在一个点:6567 端口的可达性。按改什么、为什么拆开看:防火墙放行 6567—— 服务器进程只监听这一个端口,不开则外部数据包直接丢弃。以 firewalld 为例:firewall-cmd --add-port6567/tcp --permanent firewall-cmd --reload路由器端口转发—— 如果你的 Mindustry 服务器在内网(192.168.x.x),需要在路由器把公网 6567 转发到服务器的内网 IP。这一步不改客户端,改的是包能不能进来。客户端直接连接—— 朋友那边填你的公网IP:6567即可,无需额外配置。启动方式也顺手升级一下,给 JVM 更多堆空间并保留 OOM 现场:java -Xmx4G -XX:HeapDumpOnOutOfMemoryError \ -jar server-release.jar玩家多、地图大时堆内存是第一个瓶颈;HeapDump 参数平时不出力,崩溃时能留下 hprof 文件供分析。四、长期稳定运行:systemd、日志与备份服务器要 7×24 挂着,前台java -jar就不够了,交给 systemd 托管。创建一个 unit 文件(关键段):[Service] ExecStart/usr/bin/java -Xmx4G -jar /opt/mindustry/server-release.jar Restarton-failure然后systemctl enable --now mindustry-server开机自启,崩溃自动拉起。日志用journalctl -u mindustry-server -f实时跟踪。几个长期运行必须知道的点:配置位置:服务器会在运行目录下自动生成config/文件夹,config.json里管端口、服务器描述(motd)、访问密码;地图轮换列表放在运行目录的maps.txt,每行一个地图名。备份范围:只需要备份运行目录下的config/和玩家地图存档,几 MB 而已,定期 rsync 到别处即可。性能调优顺序:先加堆(-Xmx),再考虑给服务器一台独立机器——地图大、单位多的局,单核 CPU 比大内存更容易先满。五、排障速查:五个高频问题症状:编译时报错提示必须使用 Java 17先查:java -version输出,构建入口 settings.gradle 第一行就做这个校验修复:安装 JDK 17 并把JAVA_HOME指向它,重跑编译症状:启动时提示端口被占用,监听失败先查:ss -lntp | grep 6567看是谁占着修复:停掉占用进程,或改config/config.json里的 port 后重启,客户端连接地址同步改症状:自己连得上,朋友死活连不上先查:先区分局域网内连不上还是外网连不上,前者八成是防火墙,后者是 NAT修复:防火墙放行 6567;路由器配置 6567 到服务器内网 IP 的端口转发;公网 IP 变了要同步更新连接地址症状:高负载时服务器卡顿甚至直接崩溃先查:journalctl -u mindustry-server尾部,确认是 OOM 还是逻辑异常修复:调大-Xmx;若留有 HeapDump(上文的参数会生成 hprof),用 MAT 或 jhat 看堆里堆了什么症状:Mac/Linux 下执行./gradlew报 Permission denied先查:文件权限,ls -l gradlew修复:chmod x ./gradlew,一次性操作六、进阶入口:Mod、地图与服务器列表Mod 开发:服务端内容扩展基于 core/src/mindustry/mod/ 下的框架,从Mod.java入手即可跑通第一个自定义内容。自定义地图:内置地图是 core/assets/maps/ 下的.msav文件,用游戏内地图编辑器制作后放进运行目录即可被maps.txt轮换引用。提交服务器列表:想让公域玩家发现你的服,格式和流程见 SERVERLIST.md。具体命令与更多选项以仓库自带的 README.md 为准,升级版本时先读它的构建章节再动手。【免费下载链接】MindustryThe automation tower defense RTS项目地址: https://gitcode.com/GitHub_Trending/min/Mindustry创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考