Minecraft 整合包服务端安装指南

📋 概述

本指南详尽介绍如何在各大平台（Windows、Linux、macOS）上部署 Minecraft Java 版模组整合包服务端。无论你使用的是官方发布的整合包、社区分享的版本，还是自己动手制作的整合包，本教程都将为你提供完整的安装路径与常见问题解决方案。

🎯 适用范围

服务端类型：支持 Forge、Fabric、NeoForge 等主流模组加载器
整合包类型：涵盖官方整合包、社区整合包、自制整合包等
操作系统平台：兼容 Windows、Linux、macOS 等主流平台

⚠️ 注意事项

社区发布的整合包可能存在自定义构建方式，请优先阅读原作者提供的安装指引。

📂 整合包类型识别

🔍 如何快速判断整合包类型？

文件特征	整合包类型	安装难度
含有 `server.jar` 或启动脚本	服务端就绪型	⭐⭐
仅包含 `mods/` 和 `config/`	客户端转换型	⭐⭐⭐⭐
`.mrpack`、`.zip`、`.json` 格式	启动器专用型	⭐⭐⭐
提供 `server-files.zip` 等服务端文件	官方分离型	⭐⭐

🚀 类型 1：服务端就绪型整合包

🧩 特征识别

✅ 包含如下内容：

server.jar / forge-xxx.jar
启动脚本（如 start.sh、start.bat）
完整的 mods/ 和 config/ 文件夹
eula.txt 用户协议

🛠 安装流程

第一步：上传与解压

bash

# 上传到服务器并解压
unzip modpack-server.zip -d /server/
cd /server/

> 📁 大于 100MB 的文件建议使用 SFTP 工具上传：
参考：SFTP 工具使用教程



第二步：检查并调整启动脚本

# 查看启动脚本内容
cat start.sh

推荐脚本示例（适配麦块联机环境）：

#!/bin/bash
MEMORY="8G"
JVM_ARGS="-Xms${MEMORY} -Xmx${MEMORY} \
  -XX:+UseG1GC \
  -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 \
  -XX:+UnlockExperimentalVMOptions \
  -XX:+DisableExplicitGC"
java ${JVM_ARGS} -jar server.jar nogui

第三步：接受 EULA 协议

echo "eula=true" > eula.txt

第四步：首次运行

chmod +x start.sh
./start.sh
tail -f logs/latest.log


---

🔄 类型 2：客户端转换型整合包

🧩 特征识别

❌ 不包含服务端核心文件，常见特征包括：

只有 mods/、config/

文件结构接近 .minecraft

模组中包含客户端专用模组（光影、地图等）


🛠 转换流程

1. 提取客户端数据

Windows 路径：

%APPDATA%\.minecraft\versions\整合包名称

Linux 路径：

~/.minecraft/versions/整合包名称

复制以下目录到服务端：

mods/

config/

resourcepacks/（可选）

world/（可选）


2. 清理客户端模组（必须）

示例脚本：

#!/bin/bash
CLIENT_ONLY_MODS=(
  "OptiFine" "IrisShaders" "Sodium" "Rubidium" "Oculus"
  "JourneyMap" "XaerosMinimap" "BetterF3" "TheOneProbe" "AmbientSounds"
)
for mod in "${CLIENT_ONLY_MODS[@]}"; do
  find mods/ -name "*${mod}*" -delete
  echo "已删除客户端模组: ${mod}"
done

3. 安装服务端核心（Forge/Fabric/NeoForge）

加载器	判断依据	安装教程链接

Forge	是否包含 mcmod.info	Forge 安装指南
Fabric	是否存在 fabric.mod.json	Fabric 安装教程
NeoForge	模组名包含 neoforge	访问官网安装说明


Forge 安装示例：

wget https://maven.minecraftforge.net/net/minecraftforge/forge/1.20.1-47.3.0/forge-1.20.1-47.3.0-installer.jar
java -jar forge-1.20.1-47.3.0-installer.jar --installServer

4. 构建完整服务端结构

server-root/
├── mods/
├── config/
├── libraries/
├── server.jar
├── eula.txt
├── server.properties
└── start.sh


---

🎯 类型 3：启动器专用型整合包

🔍 常见格式

.mrpack：Modrinth 专用格式

.zip：CurseForge 整合包

.json：用于 MultiMC、Prism 等


📦 解包与处理方式

CurseForge 格式

unzip modpack.zip -d temp/
cat temp/manifest.json
cp -r temp/overrides/* ./

> 📌 可使用 CurseForge Launcher 或手动下载 manifest 中缺失的模组。



Modrinth 格式

go install github.com/packwiz/packwiz@latest
packwiz modrinth import modpack.mrpack
packwiz modrinth export --server-only


---

⚠️ 常见错误及解决方案

错误信息	原因	解决方案

ClassNotFoundException	加载器版本不匹配	安装正确版本 Forge/Fabric
Invalid jarfile	文件损坏或路径错误	重新下载
EULA not accepted	未接受协议	设置 eula=true
OutOfMemoryError	JVM 内存不足	增加 -Xmx 参数
ModLoadingException	缺少模组依赖	补全依赖模组


🔍 高级排查建议

检查模组版本兼容性

使用日志工具分析 logs/latest.log

逐一禁用/替换可能存在问题的模组



---

🏗️ 高级配置与优化建议

⚡ 推荐 server.properties 配置

allow-flight=true
max-tick-time=60000
view-distance=8
simulation-distance=6
spawn-protection=0
max-world-size=10000

🚀 推荐 JVM 启动参数

适用于模组较多的整合包：

JAVA_ARGS="-server -Xms8G -Xmx8G \
  -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"

🧩 模组性能优化示例

# config/journeymap.cfg
journeymap.core.enabled=false
journeymap.server.enabled=true

# config/jei.cfg
jei.mode=cheat
jei.maxTreeDepth=100


---

🔄 地图预生成与备份机制

🗺️ 使用 Chunky 预生成地图

/chunky world world
/chunky radius 2000
/chunky start

或命令行方式：

java -jar chunky.jar --world world --center 0,0 --radius 2000

💾 自动备份脚本示例

#!/bin/bash
BACKUP_DIR="/backups"
WORLD_DIR="/server/world"
DATE=$(date +%Y%m%d_%H%M%S)

# 保存世界并关闭写入
screen -S minecraft -p 0 -X stuff "save-all$(printf \\r)"
screen -S minecraft -p 0 -X stuff "save-off$(printf \\r)"
sleep 10

# 打包备份
tar -czf "${BACKUP_DIR}/world_backup_${DATE}.tar.gz" "${WORLD_DIR}/"

# 重启写入
screen -S minecraft -p 0 -X stuff "save-on$(printf \\r)"

# 删除 7 天前的旧备份
find "${BACKUP_DIR}" -name "*.tar.gz" -mtime +7 -delete


---

✅ 安装检查清单

🔍 基础安装确认

[ ] 下载文件完整无误

[ ] 服务端核心已安装

[ ] 清理客户端模组

[ ] 启动脚本正确配置

[ ] eula.txt 设置为 true

[ ] 内存配置合理（建议 ≥8G）

[ ] 启动成功，日志无异常


🛠 高级配置确认

[ ] 启用优化型 JVM 参数

[ ] 预生成地图完毕

[ ] 备份策略已启用

[ ] 权限管理系统启用（LuckPerms 等）

[ ] 日志监控工具部署（如 AikarTimings）



---

📚 主流整合包安装建议

整合包	特别说明	推荐配置

All the Mods 9	占用高，需高内存	16GB+ RAM
RLCraft	光影兼容差	建议禁用 OptiFine
SkyFactory 4	自带脚本	使用原版脚本运行
Create: A&B	机械复杂	关闭多余动画提升性能
FTB Academy	教程向整合包	标准配置足够



---

📎 参考链接

Forge 官方文档

Fabric 官方 Wiki

CurseForge Modpack 指南

Modrinth Modpack 规范


---

如需我为你生成更现代化美观的 VitePress 页面（如加上卡片组件、图标美化、自动目录等），也可以告诉我是否希望我提供相应的 `themeConfig` 或 `CSS` 美化代码。是否要我接着处理样式优化？

服务器介绍

服务端常见问题

存档保存及恢复

Minecraft 整合包服务端安装指南

🎯 适用范围

📂 整合包类型识别

🔍 如何快速判断整合包类型？

🚀 类型 1：服务端就绪型整合包

🧩 特征识别

🛠 安装流程

第一步：上传与解压

Minecraft 整合包服务端安装指南 ​

🎯 适用范围 ​

📂 整合包类型识别 ​

🔍 如何快速判断整合包类型？ ​

🚀 类型 1：服务端就绪型整合包 ​

🧩 特征识别 ​

🛠 安装流程 ​

第一步：上传与解压 ​

Minecraft 整合包服务端安装指南

🎯 适用范围

📂 整合包类型识别

🔍 如何快速判断整合包类型？

🚀 类型 1：服务端就绪型整合包

🧩 特征识别

🛠 安装流程

第一步：上传与解压