进服自动下载教程

[西柚木吉]

模组自动下载服务器部署指南​

本文介绍如何为游戏服务器搭建模组自动下载功能，让玩家加入服务器时能自动下载并安装所需模组。

---

​

重要提醒（操作前必读）​

1. 修改任何配置文件前，请先关闭游戏服务端，否则服务端重新启动之后，配置文件会被还原成上次启动时的样子。
2. 本文假设你已有可运行的游戏服务端，并了解基本的文件操作。
3. 文中的"模组"即指游戏模组（Mod），有时也称为资源包。

---

​

一、模组自动下载的原理​

当你进入一个需要模组的服务器时，整个过程分为三步：

1. 请求信息
   游戏向服务器询问："我需要下载哪些模组？"
2. 获取信息
   服务器回复一个"模组清单"（JSON文件），里面包含模组名称、大小、下载地址等。
3. 下载安装
   游戏根据清单中的地址下载模组，安装后自动重启并进入游戏。

为了完成这个流程，我们需要准备以下内容：

• 游戏服务器：玩家实际游玩的服务器。
• 信息服务器（可合并）：提供"模组清单"（JSON文件）的服务器。
• 下载服务器（可合并）：存放模组文件的服务器，供玩家下载。

通常信息服务器和下载服务器可以部署在同一台机器上。

---

​

二、方法一：使用游戏自带功能（简单快捷）​

适合场景：有公网IP、玩家不多（10人以下）、能接受较慢下载速度的服务器。
优点：配置最简单，无需额外服务器。
缺点：下载速度慢（单线程），占用游戏服务器带宽。​

操作步骤​

1. 关闭游戏服务端。
2. 找到服务端根目录下的 settings.xml文件，用文本编辑器打开。
3. 找到以下两行设置：
   

   <Setting Name="StartModServer" Value="True" />
   <Setting Name="ModServerAddress" Value="" />

4. 确保第一行是 True（开启模组服务器功能）。
5. 重要：在第二行的 Value中填写你的公网IP和端口，格式如下：
   <Setting Name="ModServerAddress" Value="http://你的公网IP:端口/" />
   

   示例：http://123.123.123.123:8090/
   注意：端口不能与游戏服务器端口相同，且必须确保该端口未被占用、已在防火墙中开放。

6. 保存文件，启动游戏服务端，并进入一个世界。
   • 如果能看到一串JSON格式的文字，说明配置成功。
   • 如果无法访问，请检查端口、防火墙和服务器网络设置。
7. 让朋友用游戏客户端连接你的服务器，测试模组是否能自动下载。

提示：如果只有少数几个朋友一起玩，这个方法完全够用，只是下载时可能需要多等一会儿。

---

​

三、方法二：自行部署独立的模组服务器（稳定推荐）​

适合场景：玩家较多（10人以上）、希望下载速度快、不占用游戏服务器资源的正式服。
优点：下载速度快，稳定可控，不干扰游戏服务器。
缺点：需要额外的网站空间和配置步骤。​

第1步：获取"模组清单"（JSON）​

1. 关闭游戏服务端。
2. 编辑 settings.xml，修改以下两行：
   

   <Setting Name="StartModServer" Value="False" />
   <Setting Name="ModServerAddress" Value="http://localhost:8090/" />

3. 保存文件，启动服务端并进入一个世界。
4. 打开浏览器，访问 http://localhost:8090，你会看到类似下面的内容：
   

   [{
     "modName": "[2.4]鍙樿縼.netmod",
     "modMd5": "140d20676e14f5a738b3741bd215f190",
     "modSize": 30422151,
     "modUrl": "",
     "downloadThread": 0
   }]

   这就是"模组清单"。
   将其全选、复制，并保存到一个新建的文本文件中（例如 modlist.json）。

第2步：理解清单内容​

以下是每个字段的含义：

字段	说明	注意事项
modName	模组文件名（可能乱码）	可改为简单名称，建议用英文或数字
modMd5	模组的MD5校验值	绝对不能修改，否则无法通过校验
modSize	模组文件大小（字节）	需与真实文件大小一致
modUrl	模组下载地址	留空则默认从当前地址下载
downloadThread	下载线程数	建议5~15，太多可能导致下载失败

​

第3步：配置清单文件​

1. 打开刚才保存的 modlist.json。
   • 将 modName改为简单名称（如 1.netmod），避免中文乱码。
   • 将 downloadThread改为 10（推荐值）。
   • 在 modUrl中填入模组的完整下载地址（稍后配置）。
2. 修改后示例：
   

   [{
     "modName": "1.netmod",
     "modMd5": "140d20676e14f5a738b3741bd215f190",
     "modSize": 30422151,
     "modUrl": "http://你的网站地址/1.netmod",
     "downloadThread": 10
   }]

3. 保存文件。

第4步：搭建网站服务器​

你需要一个支持HTTP访问的网站空间，用于存放清单和模组文件。
这里以 phpStudy 为例（适用于Windows/Linux）：

1. 访问 phpStudy官网下载并安装。
2. 启动 nginx 服务（选择较新版本）。
3. 创建一个新网站，或使用默认网站，记住网站端口（如80）。
4. 将你的公网IP或域名指向该服务器（可用内网穿透工具，如frp、ngrok）。
5. 在浏览器中访问你的网站地址（如 http://你的域名:端口），看到"Welcome"页面说明网站运行正常。

第5步：上传文件​

1. 找到网站的根目录（在phpStudy的网站设置中查看）。
2. 将修改好的 modlist.json改名为 index.html，覆盖网站根目录下的原文件。
   

   这样访问网站时就会直接显示JSON内容。

3. 将你的模组文件（如 1.netmod）上传到网站根目录。
   

   文件名需与JSON中 modName一致，且不要使用中文或特殊符号。

第6步：测试下载链接​

在浏览器中访问你在JSON中填写的模组地址（如 http://你的网站地址/1.netmod），如果浏览器开始下载文件，说明配置正确。​

第7步：修改游戏服务器配置​

1. 关闭游戏服务端。
2. 编辑 settings.xml，修改以下行：
   

   <Setting Name="StartModServer" Value="False" />
   <Setting Name="ModServerAddress" Value="http://你的网站地址/" />

   将 你的网站地址替换为能访问到 index.html（即JSON文件）的完整地址，如 http://example.com/。

3. 保存文件，启动游戏服务端。

---

​

四、方法三：使用Gitee平台（免费但有限制）​

适合场景：3-5人小型私服、测试服、学生党零成本方案。
优点：完全免费，无需自备服务器。
缺点：有流量和频率限制，玩家稍多就可能被临时封禁（通常几小时到一天后恢复）。​

重要注意事项​

1. 单文件限制：Gitee网页端上传单个文件不能超过10MB，大模组需要用其他方法上传。
2. 流量限制：公开仓库有流量限制，频繁下载会被临时封禁。
3. 必须使用桌面版：手机访问时，一定要先点击右下角的"桌面版"按钮，否则很多功能看不到。

操作步骤​

1. 注册并切换到桌面版
   • 访问 gitee.com注册账号。
   • 登录后，点击页面右下角的"桌面版"按钮，切换到桌面版界面。
   • 点击右上角"+"号，选择"新建仓库"。
   • 仓库名称随意（如my-mods），点击"创建"。

---

​

五、方法对比与选择建议​

方法	适合人数	优点	缺点	推荐度
方法一	1-10人	配置最简单，5分钟搞定	下载速度慢，占用服务器资源
方法二	不限	最稳定，速度快，不干扰游戏	需要额外服务器/空间
方法三	3-5人	完全免费，适合零成本	有限制，人多会被封禁

选择建议：

• 几个人随便玩玩：用方法一，简单够用。
• 正式开服，玩家较多：一定用方法二，稳定第一。
• 学生党、零成本测试：用方法三，但做好被临时封禁的心理准备。

---

​

六、常见问题​

模组服务器必须和游戏服务器在同一台机器上吗？​

答：不必。你可以在任何支持HTTP访问的服务器上部署模组清单和文件，只需在 settings.xml中填写正确的地址即可。​

游戏下载模组时提示"校验失败"或"下载错误"怎么办？​

答：请按顺序检查：

1. 模组文件的MD5值与JSON中的 modMd5是否完全一致。
2. 模组文件大小是否与JSON中的 modSize一致。
3. 下载链接能否在浏览器中直接访问并下载。

使用内网穿透/反向代理时要注意什么？​

答：确保穿透后的地址能通过公网直接访问，并且端口与配置一致。某些穿透服务可能会修改HTTP头，导致下载失败，请选择稳定的穿透工具。​

多个模组如何配置？​

答：在JSON文件中用英文逗号分隔多个模组对象，例如：

[
  { "modName": "1.netmod", ... },
  { "modName": "2.netmod", ... }
]

确保每个模组的 modUrl指向正确的文件地址。

---

​