Minecraft 整合包服务器
搭建带模组的 Minecraft 服务器(CurseForge、Modrinth)。
Skill 元数据
| Source | Optional — 使用 kopi skills install official/gaming/minecraft-modpack-server 安装 |
| Path | optional-skills/gaming/minecraft-modpack-server |
| Platforms | linux, macos |
参考:完整 SKILL.md
信息
以下是触发该 skill 时 Kopi Agent 加载的完整 skill 定义。这就是 skill 激活时 agent 所看到的指令。
Minecraft 整合包服务器搭建
何时使用
- 用户想从服务器包 zip 搭建带模组的 Minecraft 服务器
- 用户需要 NeoForge/Forge 服务器配置方面的帮助
- 用户询问 Minecraft 服务器性能调优或备份相关问题
先收集用户偏好
在开始搭建前,向用户询问:
- 服务器名称 / MOTD — 服务器列表中显示什么?
- 种子 — 指定种子还是随机?
- 难度 — peaceful / easy / normal / hard?
- 游戏模式 — survival / creative / adventure?
- 在线模式 — true(Mojang 认证,正版账号)还是 false(局域网/离线账号可用)?
- 玩家数量 — 预计多少玩家?(影响内存与视距调优)
- 内存分配 — 还是让 agent 根据模组数量和可用内存决定?
- 视距 / 模拟距离 — 还是让 agent 根据玩家数量和硬件选择?
- PvP — 开启还是关闭?
- 白名单 — 开放服务器还是仅限白名单?
- 备份 — 需要自动备份吗?频率如何?
如果用户不在意,就使用合理的默认值,但在生成配置前一定要询问。
步骤
1. 下载并检查整合包
mkdir -p ~/minecraft-server
cd ~/minecraft-server
wget -O serverpack.zip "<URL>"
unzip -o serverpack.zip -d server
ls server/
查找:startserver.sh、安装 jar(neoforge/forge)、user_jvm_args.txt、mods/ 文件夹。
检查脚本以确定:模组加载器类型、版本以及所需的 Java 版本。
2. 安装 Java
- Minecraft 1.21+ → Java 21:
sudo apt install openjdk-21-jre-headless - Minecraft 1.18-1.20 → Java 17:
sudo apt install openjdk-17-jre-headless - Minecraft 1.16 及以下 → Java 8:
sudo apt install openjdk-8-jre-headless - 验证:
java -version
3. 安装模组加载器
大多数服务器包都附带安装脚本。使用 INSTALL_ONLY 环境变量进行安装而不启动服务器:
cd ~/minecraft-server/server
ATM10_INSTALL_ONLY=true bash startserver.sh
# Or for generic Forge packs:
# java -jar forge-*-installer.jar --installServer
该脚本会下载库文件、修补服务器 jar 等。
4. 接受 EULA
echo "eula=true" > ~/minecraft-server/server/eula.txt
5. 配置 server.properties
模组/局域网的关键设置:
motd=\u00a7b\u00a7lServer Name \u00a7r\u00a78| \u00a7aModpack Name
server-port=25565
online-mode=true # false for LAN without Mojang auth
enforce-secure-profile=true # match online-mode
difficulty=hard # most modpacks balance around hard
allow-flight=true # REQUIRED for modded (flying mounts/items)
spawn-protection=0 # let everyone build at spawn
max-tick-time=180000 # modded needs longer tick timeout
enable-command-block=true
性能设置(根据硬件调整):
# 2 players, beefy machine:
view-distance=16
simulation-distance=10
# 4-6 players, moderate machine:
view-distance=10
simulation-distance=6
# 8+ players or weaker hardware:
view-distance=8
simulation-distance=4
6. 调优 JVM 参数(user_jvm_args.txt)
根据玩家数量和模组数量调整内存。模组服的经验法则:
- 100-200 个模组:6-12GB
- 200-350+ 个模组:12-24GB
- 至少为操作系统/其他任务预留 8GB 空闲内存
-Xms12G
-Xmx24G
-XX:+UseG1GC
-XX:+ParallelRefProcEnabled
-XX:MaxGCPauseMillis=200
-XX:+UnlockExperimentalVMOptions
-XX:+DisableExplicitGC
-XX:+AlwaysPreTouch
-XX:G1NewSizePercent=30
-XX:G1MaxNewSizePercent=40
-XX:G1HeapRegionSize=8M
-XX:G1ReservePercent=20
-XX:G1HeapWastePercent=5
-XX:G1MixedGCCountTarget=4
-XX:InitiatingHeapOccupancyPercent=15
-XX:G1MixedGCLiveThresholdPercent=90
-XX:G1RSetUpdatingPauseTimePercent=5
-XX:SurvivorRatio=32
-XX:+PerfDisableSharedMem
-XX:MaxTenuringThreshold=1
7. 开放防火墙
sudo ufw allow 25565/tcp comment "Minecraft Server"
检查方式:sudo ufw status | grep 25565
8. 创建启动脚本
cat > ~/start-minecraft.sh << 'EOF'
#!/bin/bash
cd ~/minecraft-server/server
java @user_jvm_args.txt @libraries/net/neoforged/neoforge/<VERSION>/unix_args.txt nogui
EOF
chmod +x ~/start-minecraft.sh
注意:对于 Forge(非 NeoForge),参数文件路径不同。请查看 startserver.sh 以获取确切路径。
9. 设置自动备份
创建备份脚本:
cat > ~/minecraft-server/backup.sh << 'SCRIPT'
#!/bin/bash
SERVER_DIR="$HOME/minecraft-server/server"
BACKUP_DIR="$HOME/minecraft-server/backups"
WORLD_DIR="$SERVER_DIR/world"
MAX_BACKUPS=24
mkdir -p "$BACKUP_DIR"
[ ! -d "$WORLD_DIR" ] && echo "[BACKUP] No world folder" && exit 0
TIMESTAMP=$(date +%Y-%m-%d_%H-%M-%S)
BACKUP_FILE="$BACKUP_DIR/world_${TIMESTAMP}.tar.gz"
echo "[BACKUP] Starting at $(date)"
tar -czf "$BACKUP_FILE" -C "$SERVER_DIR" world
SIZE=$(du -h "$BACKUP_FILE" | cut -f1)
echo "[BACKUP] Saved: $BACKUP_FILE ($SIZE)"
BACKUP_COUNT=$(ls -1t "$BACKUP_DIR"/world_*.tar.gz 2>/dev/null | wc -l)
if [ "$BACKUP_COUNT" -gt "$MAX_BACKUPS" ]; then
REMOVE=$((BACKUP_COUNT - MAX_BACKUPS))
ls -1t "$BACKUP_DIR"/world_*.tar.gz | tail -n "$REMOVE" | xargs rm -f
echo "[BACKUP] Pruned $REMOVE old backup(s)"
fi
echo "[BACKUP] Done at $(date)"
SCRIPT
chmod +x ~/minecraft-server/backup.sh
添加每小时 cron:
(crontab -l 2>/dev/null | grep -v "minecraft/backup.sh"; echo "0 * * * * $HOME/minecraft-server/backup.sh >> $HOME/minecraft-server/backups/backup.log 2>&1") | crontab -
常见陷阱
- 模组服务必设置
allow-flight=true— 否则带有喷气背包/飞行能力的模组会将玩家踢出 max-tick-time=180000或更高 — 模组服务器在世界生成期间 tick 时间往往很长- 首次启动很慢(大型整合包需要几分钟)— 不用惊慌
- 首次启动时出现 "Can't keep up!" 警告是正常的,初始区块生成后会恢复
- 如果 online-mode=false,也要设置 enforce-secure-profile=false,否则客户端会被拒绝
- 整合包的 startserver.sh 通常带有自动重启循环 — 请编写一个不含该循环的干净启动脚本
- 删除 world/ 文件夹可用新种子重新生成世界
- 部分整合包通过环境变量控制行为(例如 ATM10 使用 ATM10_JAVA、ATM10_RESTART、ATM10_INSTALL_ONLY)
验证
pgrep -fa neoforge或pgrep -fa minecraft检查是否在运行- 查看日志:
tail -f ~/minecraft-server/server/logs/latest.log - 在日志中找到 "Done (Xs)!" = 服务器已就绪
- 测试连接:玩家在多人游戏中添加服务器 IP