第一部分：核心概念（新手必读）

在开始之前，理解几个关键概念至关重要,这能避免你混淆和犯错。

Mod 是什么？

Mod (Modification) 模组，是玩家或开发者制作的第三方数据包，用于修改或扩展原版游戏的内容,它可以：

• 添加新物品、方块、生物（如科技设备、魔法咒语、新生物）。
• 改变游戏机制（如调整难度、增加新的合成配方）。
• 优化服务器性能。
• 提供便利功能（如小地图、背包整理）。

Forge vs. Fabric

这是目前最主流的两个 Mod 加载器，它们是运行 Mod 的“引擎”。

简单总结：

• 想玩大型、复杂的 Mod 包（比如魔法、科技、冒险），选 Forge。
• 只想加几个简单实用的模组（比如小地图、背包管理），选 Fabric。

第二部分：搭建 Mod 服务器的完整步骤（以 Forge 为例）

Forge 是最主流的选择，我们以它为例进行详细讲解，Fabric 的流程基本类似,只是下载的安装器和启动器不同。

步骤 1：准备工作

1. 一台服务器：

   • 本地服务器：在你的电脑上运行，适合和朋友在局域网内一起玩，免费,但你的电脑需要一直开着。
   • 云服务器/VPS：租用一台云服务器（如阿里云、腾讯云、Vultr、DigitalOcean），优点是 24/7 在线，不占用你的电脑资源，朋友可以随时从任何地方加入，你需要有一定的服务器操作基础（通过 SSH 连接）。

2. Java 环境：

   • Minecraft Java 版 必须 使用 Java 运行。
   • 确保你的服务器安装了 Java 17，目前新版本的 Mod 服务器大多都要求 Java 17。
   • 检查 Java 版本：在服务器终端输入 java -version，如果版本不对或未安装，请先安装 Java 17。
   • 下载地址：Oracle Java 17 或 Eclipse Temurin (推荐)。

步骤 2：下载并安装 Forge 服务器

1. 确定 Minecraft 版本：你想开哪个版本的服务器？（1.20.1, 1.19.2）
2. 访问 Forge 官网：https://files.minecraftforge.net/net/minecraftforge/forge/
3. 选择版本和安装器类型：
   • 在 "Minecraft Version" 下拉菜单中选择你的目标版本。
   • 在 "Installer" 旁边，选择 "Recommended" (推荐) 或 "Latest" (最新)，对于新手，推荐版本 更稳定。
   • 点击 "Download" 下载 forge-<version>-installer.jar 文件。
4. 运行安装器：
   • 将下载的 .jar 文件上传到你的服务器主目录（/home/minecraft）。
   • 通过 SSH 连接到你的服务器,进入该目录。
   • 运行安装命令：

     java -jar forge-<version>-installer.jar --installServer

     （请将 <version> 替换为你下载的实际版本号，如 forge-1.20.1-47.2.0）

5. 完成安装：
   • 安装完成后，你会看到主目录下多了一个 run.bat (Windows) 或 run.sh (Linux/macOS) 文件，以及一个 libraries 文件夹和一个 minecraft_server.<version>.jar 文件。
   • 重要：删除安装器文件 forge-<version>-installer.jar。

步骤 3：安装 Mod 文件

1. 创建 Mod 文件夹：在服务器主目录下，创建一个名为 mods 的文件夹，所有你安装的 Mod 文件（.jar 文件）都要放这里。

   mkdir mods

2. 下载 Mod：
   • 来源：最知名的 Mod 发布平台是 CurseForge (https://www.curseforge.com/)，它有大量高质量、经过测试的 Mod。
   • 下载：在 CurseForge 上找到你想要的 Mod，确保它支持你选择的 Minecraft 版本和 Forge 加载器，下载其 "File" 中的 .jar 文件。
3. 上传 Mod：将下载好的 .jar Mod 文件，通过 FTP 或 SCP 工具上传到服务器上的 mods 文件夹中。

步骤 4：启动和配置服务器

1. 启动服务器：

   
   （图片来源网络，侵删）
   • 使用 Forge 安装时生成的启动脚本。
   • 在 Linux/macOS 上：

     chmod +x run.sh
     ./run.sh

   • 在 Windows 上：双击 run.bat。
   • 首次启动：第一次启动会生成一些必要的配置文件，并可能花较长时间，请耐心等待，启动成功后，按 Ctrl + C 停止服务器。

2. 编辑服务器配置文件：

   • 打开 server.properties 文件，这里可以设置服务器名称、游戏模式、难度、白名单等基本参数。
   • 最重要的配置：eula.txt
     • 用文本编辑器打开 eula.txt 文件。
     • 里面有一行 eula=false。
     • 你必须将其改为 eula=true，这表示你同意 Mojang 的最终用户许可协议,否则服务器无法启动。

3. （可选）优化服务器性能：

   • 编辑 forge-server.toml 文件（Forge 1.13+ 版本），这里可以调整 JVM 内存分配等高级设置。
   • 对于大多数服务器，一个简单的 server.properties 优化就足够了。

步骤 5：连接服务器

1. 获取服务器 IP：
   • 本地服务器：IP 通常是 localhost 或 0.0.1。
   • 云服务器：IP 是你购买时分配的公网 IP 地址。
2. 启动游戏：
   • 在你的电脑上启动 Minecraft Java 版。
   • 点击“多人游戏” -> “添加服务器”。
   • 服务器名称随便填（如 "My Forge Server"）。
   • 服务器地址填入你的服务器 IP。
   • 点击“完成”,然后双击该服务器即可加入。

第三部分：进阶与常见问题

如何安装 Mod 包？

如果你不想自己一个一个找 Mod，可以直接安装别人打包好的 Mod Pack,这非常方便！

1. 平台：CurseForge 是首选。
2. 步骤：
   • 在 CurseForge 上找到一个你喜欢的 Mod Pack。
   • 下载其 "Server" 版本（不是 "Modpack" 或 "Application"）。
   • 下载的是一个 .zip 压缩包。
   • 将这个压缩包整个解压到你的服务器主目录（覆盖所有文件）。
   • 直接运行解压后得到的 run.sh 或 run.bat 即可。

Mod Pack 已经帮你处理好了 Mod 之间的依赖关系,开箱即用。

常见问题排查

• Q: 启动时出现 OutOfMemoryError 内存溢出错误？

  • A: 这意味着分配给服务器的内存不够，你需要修改启动脚本,增加内存。
  • 编辑 run.sh (Linux) 或 run.bat (Windows)，找到类似 -Xmx2G -Xms1G 的部分。
    • -Xmx 是最大内存，-Xms 是初始内存，建议将 -Xmx 设置为服务器可用内存的一半（4G 内存的服务器，可以设为 -Xmx2G 或 -Xmx3G）。

• Q: 启动后客户端连接提示 Connection Lost: Server Closed 或类似错误？

  • A:
    1. 检查 eula.txt 文件是否已设置为 eula=true。
    2. 检查 server.properties 中的 online-mode 是否为 true，如果设为 false，允许离线模式玩家进入,但安全性较低。
    3. 检查防火墙是否阻止了服务器的端口（默认 25565）。
    4. 某个 Mod 可能与其他 Mod 或服务端不兼容，尝试移除部分 Mod。

• Q: Mod 安装后，客户端连接失败，提示版本不匹配？

  • A: 这是最常见的问题，请确保：
    1. 服务器端的 Minecraft 版本 和 客户端玩的版本 完全一致。
    2. 服务器端的 Forge 加载器版本 和 客户端安装的 Forge 客户端版本 完全一致。
    3. 客户端必须安装与服务器端 Forge 版本匹配的 Forge 客户端，而不是直接把服务端的 mods 文件夹复制到客户端。

第四部分：推荐 Mod（Forge）

这里提供一些不同类型的经典 Mod,可以作为你服务器的起点。

• QOL (生活质量) 类：

  • JourneyMap: 实时小地图，显示玩家位置、洞穴、生物群落等,极其实用。
  • Just Enough Items (JEI): 游戏内物品合成表查询器，告别查 Wiki。
  • Inventory Tweaks: 背包自动整理,管理物品栏的神器。

• 科技类：

  • Mekanism: 功能强大的科技模组，涉及能源、机器、物品处理等。
  • Create: 极具创意和机械感的科技模组，通过齿轮、传送带、动力等构建复杂的自动化工厂。
  • Industrial Foregoing: 科技模组，功能覆盖农业、炼金、采集等多个方面,相对简单易上手。

• 魔法类：

  • Blood Magic: 以生命为代价的强大魔法模组,体系独特。
  • Ars Nouveau: 一款现代化的魔法模组，拥有法杖、符文、咒语等系统,视觉效果华丽。
  • Tinkers' Construct: 虽然不算纯魔法，但它提供了自定义工具和武器的强大系统,是很多服务器的标配。

• 冒险/世界生成类：

  • Biomes O' Plenty: 大幅扩展生物群系,增加无数新的地形和风景。
  • Twilight Forest: 在主世界维度添加一个全新的、充满挑战和宝藏的森林维度。
  • Aether: 在天空之上创造一个漂浮的神话世界。

希望这份详细的指南能帮助你成功搭建属于自己的 Minecraft Mod 服务器！祝你玩得开心！