Rust uMod/Oxide 插件

使用实例详情页「模组」标签页在线搜索、安装、更新和卸载 uMod 插件,手动上传插件,以及修改插件配置和权限。

Rust · 更新于

Rust 实例在安装时已经装好 Oxide(uMod)插件框架。Oxide 插件是 .cs 源码文件,放进 oxide/plugins 目录后会被自动编译并加载,不需要重启服务器。

Oxide 目录结构

数据目录下的 oxide/ 文件夹:

路径 内容
oxide/plugins/ 插件文件(插件名.cs)
oxide/config/ 插件配置文件,通常是 插件名.json,插件首次加载时生成
oxide/data/ 插件运行时保存的数据
oxide/lang/ 插件的多语言文本
oxide/logs/ Oxide 日志,插件报错时可以在这里查看

用「模组」标签页安装插件

Rust 实例的详情页有一个 模组 标签页,用来浏览和安装 uMod 上的 Rust 插件。

搜索与安装

  1. 打开实例详情页,切换到「模组」标签页。
  2. 在搜索框中输入插件名称或关键词(英文),右侧可以选择排序方式:下载量、最近更新、关注数、名称。
  3. 每个插件会显示作者、简介、下载量、最新版本号和更新时间,点击「在 uMod 查看」可以打开插件主页阅读说明。
  4. 点击插件右侧的 安装。按钮会依次显示「下载中」「校验中」「上传中」,完成后会提示「已安装 …,Oxide 会自动加载」。

安装时会核对插件文件的校验值,然后写入 oxide/plugins/插件名.cs。服务器正在运行时,Oxide 会立即加载新插件,可以在「控制台」中看到加载日志。

更新与重新安装

已安装的插件会显示「已安装」标记和本地版本号:

  • 本地版本比 uMod 上的最新版旧时,按钮显示为 更新;
  • 已经是最新版时显示 重新安装,可用于修复被误改的插件文件。

更新只替换插件的 .cs 文件,oxide/config 中的配置和 oxide/data 中的数据会保留。

卸载

页面底部的「已安装插件」卡片列出 oxide/plugins 下的全部 .cs 文件,包括你手动上传的插件。点击对应行的 卸载 并确认后,插件文件会被删除,Oxide 会自动卸载它。插件的配置和数据(oxide/config、oxide/data)会保留,需要彻底清理时请到「文件管理」中手动删除。

无法安装的情况

  • 实例正在安装或创建时,只能浏览,不能安装;
  • 实例已到期时文件为只读,续费后才能安装插件;
  • 页面提示「未检测到 Oxide」时,说明数据目录里没有 oxide 文件夹。插件仍然可以先装好,但需要 Oxide 正常工作后才会加载。这种情况一般是首次开机还没完成,可以先开机一次;如果开机后仍然没有,可以点击「重新安装」重新安装服务端和 Oxide(数据目录保留,建议先备份)。

手动上传插件

不在 uMod 上的插件(例如购买的付费插件)可以手动上传:

  1. 打开「文件管理」,进入 oxide/plugins 目录。
  2. 点击「上传」,选择插件的 .cs 文件。也可以用 SFTP 上传。
  3. Oxide 检测到新文件后会自动编译加载。

文件名必须与插件代码里的类名一致(只能由字母、数字和下划线组成),否则插件不会被加载。

修改插件配置

  1. 插件第一次加载后,会在 oxide/config/ 生成同名配置文件,比如 oxide/config/插件名.json。
  2. 在「文件管理」中打开该文件编辑并保存。修改 JSON 时注意逗号和引号,格式错误会导致插件读取配置失败。
  3. 在 RCON 中执行下面的命令重新加载插件,让配置生效:
oxide.reload 插件名

也可以重启服务器。

权限管理

很多插件通过 Oxide 的权限系统控制谁能使用哪些功能,权限名称以插件说明为准。常用命令(在 RCON 中执行,连接方法见 管理员与 RCON):

命令 作用
oxide.grant user 玩家名或SteamID64 权限名 给某个玩家授权
oxide.revoke user 玩家名或SteamID64 权限名 收回某个玩家的权限
oxide.grant group default 权限名 给所有玩家授权(default 组)
oxide.group add vip 新建一个名为 vip 的权限组
oxide.usergroup add 玩家名或SteamID64 vip 把玩家加入 vip 组
oxide.show user 玩家名或SteamID64 查看玩家拥有的权限

插件管理命令:

命令 作用
oxide.plugins 列出已加载的插件
oxide.load 插件名 加载插件
oxide.unload 插件名 卸载插件(文件保留)
oxide.reload 插件名 重新加载插件
oxide.version 查看 Oxide 版本

插件常见问题

  • 插件加载失败或报编译错误:查看「控制台」或 oxide/logs/ 中的错误信息。最常见的原因是插件版本太旧,不兼容当前的 Rust 或 Oxide,可以在「模组」页更新,或者到 uMod 插件页查看是否有兼容的新版本。
  • 首次开机卡在 Downloading Oxide.Compiler:Oxide 需要插件编译器才能加载插件。平台在安装阶段已经预先下载了编译器;如果安装日志里提示「Oxide.Compiler 预下载失败」,服务器首次启动时会自己下载,网络较慢时可能需要等待较长时间,详见 Rust 常见问题。
  • 插件太多导致卡顿或内存不足:在「控制台」页观察内存占用,卸载不需要的插件,或者升级套餐。