本指南介绍如何在您的 Rust 服务器上安装 Oxide/uMod 或 Carbon 模组框架、添加社区插件以及通过控制台管理插件。有关常规服务器配置和启动变量，请参阅 Rust 服务器配置指南。

安装 Oxide/uMod 或 Carbon

Oxide（现由 uMod 维护）和 Carbon 是 Rust 的模组框架，允许您安装社区构建的插件。这些框架可以添加经济系统、自定义套件、投票奖励、PvE 保护区域等众多功能。

您无需手动上传任何文件。模组框架通过设置单个启动变量即可自动安装：

1. 从 GPanel 控制台选项卡停止您的服务器。
2. 登录 GPanel 并进入启动选项卡。
3. 找到 FRAMEWORK 变量并设置为：
   • oxide — 使用 Oxide/uMod（使用最广泛的框架，拥有最大的插件库）
   • carbon — 使用 Carbon 框架（一个替代方案，拥有自己的插件生态系统）
   • vanilla — 不使用任何模组框架运行
4. 启动服务器。框架文件将自动下载并应用。首次使用 Oxide 启动时，将生成 oxide/ 目录结构。
5. 检查控制台日志中是否有类似 Loaded plugin Oxide.Core 的信息，以确认 Oxide 已激活。

安装插件

插件以 .cs（C# 源代码）文件形式分发。Oxide 在服务器运行时自动编译它们 — 无需预编译。

1. 从 umod.org 或其他可信来源下载插件 .cs 文件。
2. 使用 SFTP 或 GPanel 文件管理器将 .cs 文件上传到服务器上的 oxide/plugins/ 目录。有关 SFTP 的帮助，请参阅如何通过 SFTP 上传文件。
3. 如果服务器正在运行，插件将在几秒内被自动检测并编译。您将在控制台中看到确认加载的输出，例如 Loaded plugin MyPlugin v1.2.3 by Author。
4. 如果服务器未运行，插件将在下次启动时加载。

Oxide 目录结构

oxide/
  plugins/
    MyPlugin.cs       <- place plugin files here
    AnotherPlugin.cs
  config/             <- auto-generated plugin config files
  data/               <- plugin data files
  logs/               <- plugin log files

配置插件

大多数插件在首次加载时会在 oxide/config/ 中生成一个 JSON 配置文件。要自定义插件：

1. 让插件至少加载一次，以生成默认配置文件。
2. 停止服务器（或注意某些插件支持实时配置重新加载）。
3. 使用 GPanel 文件管理器或 SFTP 打开 oxide/config/PluginName.json 中的插件配置文件。
4. 编辑设置并保存文件。
5. 使用 oxide.reload PluginName 重新加载插件或重启服务器。

通过控制台管理插件

以下命令可以从 GPanel 控制台或通过 RCON 客户端运行。有关 RCON 设置，请参阅 Rust RCON 访问和管理员命令。

更新插件

要将插件更新到新版本：

1. 从 umod.org 上的插件页面下载更新后的 .cs 文件。
2. 将新文件上传到 oxide/plugins/，覆盖现有文件。
3. 如果服务器正在运行，Oxide 会检测到文件变更并自动重新编译和重新加载插件。也可以运行 oxide.reload PluginName。
4. 检查控制台是否有错误。某些插件更新可能需要更改 oxide/config/ 中的配置文件。

删除插件

要完全删除插件：

1. 在服务器运行时运行 oxide.unload PluginName 以卸载插件。
2. 从 oxide/plugins/ 中删除 .cs 文件。
3. 如果不再需要，可以选择删除 oxide/config/ 中的插件配置文件和 oxide/data/ 中的数据文件。

热门插件

插件问题故障排除

如果您的插件未加载，请检查以下内容：

• 确认 Oxide 已安装并激活。在 GPanel 的启动选项卡中，FRAMEWORK 变量必须设置为 oxide。控制台日志在启动期间应显示 Loaded plugin Oxide.Core。
• 插件文件必须直接放在 oxide/plugins/ 中，并具有准确的 .cs 扩展名。子目录中的文件或扩展名错误的文件将被忽略。
• 检查控制台和 oxide/logs/ 中的编译错误。有语法错误的插件将无法加载，错误消息会描述具体问题。
• 某些插件依赖于其他插件（例如，许多商店插件需要 Economics）。请先安装所有必需的依赖项。

有关其他常见服务器问题，请参阅 Rust 服务器故障排除。

需要帮助？

如果您遇到本指南未涵盖的问题，我们的支持团队随时为您提供帮助。提交支持工单，并附上您的服务器 ID、问题描述以及相关的控制台输出。