Unturned 模组和插件安装

Unturned 模组和插件安装 - 知識庫

本指南介绍了如何在您的 Unturned 服务器上安装 Steam Workshop 模组和 RocketMod/LDM 插件。有关初始服务器配置，请参阅 Unturned 服务器设置指南。

Workshop 模组安装

Unturned 使用 Steam Workshop 来管理模组，包括自定义地图、物品、皮肤和玩法修改。您的服务器会在启动时使用配置文件自动下载 Workshop 内容。

Workshop 配置文件

Workshop 配置文件位于：

Servers/default/WorkshopDownloadConfig.json

您可以通过 GPanel 文件管理器或 SFTP 编辑此文件。

需要首次启动： 在编辑此文件之前，请先从 GPanel 启动服务器至少一次，以生成所有默认配置文件。

添加 Workshop 模组

要查找模组的 Workshop ID，请打开其 Steam Workshop 页面并查看 URL — ?id= 后面的数字即为 Workshop ID。

编辑 WorkshopDownloadConfig.json 并将 Workshop ID 添加到 File_IDs 数组中：

{
  "File_IDs": [
    1234567890,
    9876543210
  ],
  "Ignore_Children_File_IDs": [],
  "Query_Cache_Max_Age_Seconds": 600,
  "Max_Query_Retries": 2,
  "Use_Temporary_Token": false,
  "Steam_Token": ""
}

JSON 格式： Workshop ID 必须是整数 — 不要用引号包裹。每个 ID 后面添加逗号，最后一个除外。无效的 JSON 将导致服务器无法加载任何 Workshop 内容。

移除 Workshop 模组

要移除模组，请从 File_IDs 数组中删除其 Workshop ID 并重启服务器。已下载的模组文件将保留在磁盘上，但不再被加载。

Workshop 地图

Workshop 地图的安装方式相同 — 将 Workshop ID 添加到 WorkshopDownloadConfig.json。服务器下载地图后，将地图文件夹名称设置为 Commands.dat 中的 Map 值。地图文件夹名称通常在启动期间的服务器控制台输出中可见。

Workshop 模组提示

玩家也需要在 Steam 上订阅相同的 Workshop 物品才能看到自定义内容（皮肤、地图、物体）。
官方精选地图（PEI、Washington、Russia 等）已包含在 Unturned 中，不需要 Workshop ID。
如果模组下载失败，请在 GPanel 中检查服务器控制台日志以查看 Steam 下载错误。
某些模组依赖于其他 Workshop 物品 — 请查看模组的 Workshop 页面了解所需物品，并同时添加这些 ID。

需要重启： 服务器在启动时下载和加载 Workshop 内容。编辑 WorkshopDownloadConfig.json 后，请从 GPanel 重启服务器以应用更改。

RocketMod / LDM 插件框架

RocketMod（及其社区维护的分支 LDM — Legally Distinct Mod）是 Unturned 最广泛使用的插件框架。它提供服务器端 API，支持包括经济系统、装备包、家园命令、权限、传送等众多插件。

检查安装状态： 许多 Legion Hosting 的 Unturned 套餐已预装 RocketMod。请使用 GPanel 文件管理器检查服务器文件中是否存在 Rocket/ 目录。如果存在，说明 RocketMod 已激活。

插件目录

Rocket 插件是放置在以下位置的 .dll 文件：

Rocket/Plugins/

安装插件

从插件作者的发布页面或仓库下载插件 .dll 文件。
使用 GPanel 文件管理器或 SFTP 将 .dll 文件上传到 Rocket/Plugins/。
从 GPanel 重启服务器。
首次运行时，RocketMod 会为插件生成配置文件（例如 Rocket/Plugins/PluginName/PluginName.configuration.xml）。
根据需要编辑生成的配置，然后再次重启服务器以应用更改。

重要： 将 .dll 文件直接放在 Rocket/Plugins/ 中，不要放在子文件夹中。某些插件以 ZIP 压缩包形式提供 — 请先解压 .dll 再上传。如果插件有依赖 DLL，这些文件也必须放在 Plugins 文件夹中。

Rocket 权限

Rocket 插件命令的玩家权限在以下文件中管理：

Rocket/Permissions.config.xml

此文件定义权限组、其成员以及每个组可以使用的命令。示例：

<Group Id="vip" DisplayName="VIP" Color="yellow" Prefix="" Suffix="" Priority="1">
  <Members>
    <Member>76561198000000001</Member>
  </Members>
  <Permissions>
    <Permission Cooldown="0">home</Permission>
    <Permission Cooldown="120">kit vip</Permission>
  </Permissions>
</Group>

关键字段：

字段	描述
`Id`	内部组标识符（必须唯一）。
`DisplayName`	在聊天前缀或插件输出中显示的名称。
`Members`	属于此组的 64 位 SteamID 列表。
`Permissions`	此组可以使用的命令。`Cooldown` 以秒为单位。
`Priority`	当玩家属于多个组时，优先级较高的组会覆盖较低的组。

插件	描述
Uconomy	游戏内经济和货币系统。
AviRockets / RocketKits	可配置的玩家和 VIP 物品装备包。
HomeCommand	允许玩家设置并传送到家园位置。
TeleportRequest (TPA)	玩家间传送请求系统。
Vehicles / VehicleShop	使用游戏内货币购买和生成载具。

需要帮助？

如果您在模组或插件方面需要帮助，我们的支持团队很乐意为您提供协助。

提交支持工单

Unturned 模组和插件安装 - 知識庫

技术支持

分类

Unturned 模组和插件安装