本文内容主要来源于Rust百科(现Rust BWIKI)对味Cherry
安装模组平台
后台安装
点击服务器菜单“启动” 找到以下变量,选择Oxide后重启服务器生效。下载为官方源,安装速度比较慢,建议您手动安装。该设置仅在安装和更新的时候打开,其他时间请关闭,否则会再次安装一次延长启动时间。

手动安装(推荐)
uMod Oxide安装教程
更新Oxide
每当服务端发布更新后,您都需要更新服务端和Oxide。
您需要先保存服务器存档,然后重启服务器,服务器会自动更新服务端,等待服务端更新完成,再根据最上面的安装教程将最新的安装包覆盖至服务器相应目录即可。
使用Oxide
Oxide内置了一些命令,用于管理插件和权限:
指令 | 说明 | 备注 |
oxide.plugins | 查看服务器全部插件 | |
oxide.load 插件名 | 加载指定插件 | 例如:oxide.load BWIKI |
oxide.reload 插件名 | 重新加载指定插件 | |
oxide.unload 插件名 | 卸载指定插件 | 重启服务器后仍会自动加载 |
oxide.grant | 授权权限指令 | 详见下方介绍 |
oxide.group | 组管理指令 | 详见下方介绍 |
oxide.revoke | 移除权限指令 | 详见下方介绍 |
oxide.show | 显示权限信息 | 详见下方介绍 |
oxide.usergroup | 玩家组管理指令 | 详见下方介绍 |
oxide.lang 语言代码 | 设置服务器插件默认语言 | |
oxide.save | 保存Oxide数据 | |
oxide.version | 查看当前的Oxide版本 | |
您可以将“oxide.”简化成“o.”来使用,例如“oxide.version”可以简化成“o.version”
验证Oxide
如何验证Oxide是否安装完成,您可以使用指令o.version
来确认。
如果输入指令后发送提示Command 'o.version' not found
,则代表Oxide没有正确安装。
如果提示Oxide.Rust Version: x.x.xxxx
,则代表Oxide已安装完成,可正常安装插件。
提示
每次更新服务端后都必须要重新安装Oxide,否则插件将无法生效。
游戏服务端每次发布更新后,Oxide也会发布新版本,所以在更新新版本服务端后需要重新下载最新版本Oxide并安装。
如遇添加模组后无法加载,检查服务器根目录是否存在编译文件Compiler.x86_x64,如果没有该文件前往官网下载或者本地下载上传至服务端根目录即可
插件网站
Rust拥有多个插件网站,在此仅列出比较大型和常用的网站。
下载插件
您可以前往以上网站下载所需的插件,在下载后会得到插件名.cs
的文件,这就是插件的本体文件。
提示
请勿更改插件文件名,否则将会导致插件无法正常加载!
安装插件
将下载到的插件名.cs
文件剪切到您服务端根目录的oxide/plugins/
文件夹中即可。
在放入该文件夹后,服务器将会自动加载并在控制台输出Loaded plugin 插件名 版本号 by 作者
的提示,则证明加载成功。
安装提示
在安装插件后,服务器将会自动加载并在控制台输出Loaded plugin 插件名 版本号 by 作者
的提示,则证明加载成功。
但也有其它例外的情况发生,如果您在安装插件后控制台输出:Error while compiling: 插件名.cs
则代表该插件出现问题,无法正常编译。
出现Compiler.exe相关报错怎么办?
由于uMod处于国外服务器,可能会出现国内无法正常访问的情况。导致了无法从远程服务器下载编译器程序(即Compiler.exe)。
您可以访问 官网下载 对应系统的文件到本地后,将其复制到服务器的根目录下即可。
编辑工具
编辑JSON文件建议您使用以下软件:
当然,您也可以使用其它的编辑软件。
配置插件
通常,Rust插件的配置文件都存放在oxide/config/
文件夹中,一般插件在首次加载后会自动生成一个插件名.json
的文件。
您可以在该文件中配置该插件的参数和设置,以达到符合您要求的状态。通常,所有配置文件均由英文组成,如果您不懂英文可以试着将配置文件复制到翻译网站以尝试理解其的意思。
如果oxide/config/
文件夹中没有对应的json文件,那么可以尝试前往数据文件夹oxide/data/
寻找负责配置的插件名.json
文件,但在该文件内的插件名.json
文件不一定就是插件的配置文件,也有可能是插件的存档数据文件哦。
如果两个文件夹都没有插件名.json
,那么可能就代表该插件没有配置文件,不支持自定义。
具体配置请查看您使用的插件的说明页面或相关文档。
配置的值
通常一些配置只需要true
和false
进行配置。
这两个配置是bool类型,true
代表是/真/启用。而false
则相反,是否/假/禁用的意思。根据配置的属性名,您就可以决定该插件的true
和false
了。
其余的基本上就只用填写纯数字或字符串了,请根据默认格式进行更改,您不能对值的类型进行任何变更。
配置完成
配置完成后使用指令o.reload 插件名
(不带任何后缀)进行重载即可。
如果出现配置文件报错等问题,建议您使用JSON格式校验工具验证一下JSON格式是否出误,如果有误请根据校验工具的提示进行修复更改。
翻译插件
一些插件的消息通知全部都是英文,那么我们想要将它变成中文,就需要自己的努力了。
插件的本地化文件存放在oxide/lang/
文件夹中,该文件中存放着各种子文件夹,文件夹名代表着语言代码,例如en
代表的就是英语,ru
代表的是俄语。
zh-CN
就是简体中文了,zh-TW
是繁体中文。如果oxide/lang/
文件夹中没有zh-CN
的文件夹,那么您可以自行创建一个(要注意大小写哦)。然后将oxide/lang/en/
文件夹中您要翻译的插件的插件名.json
复制到oxide/lang/zh-CN
文件夹中。

然后打开您要翻译的插件的插件名.json
,编辑后面" "
内的内容即可(示例见上图)。注意不要更改前面的内容哦,否则会导致无法引用。
保存后使用指令o.reload 插件名
(不带任何后缀)重载插件即可,如果重载后仍没有生效请尝试重启服务器。
其他情况
有些时候,一些作者不会在插件内添加本地化的功能,所以您可能需要前往oxide/plugins/
文件夹中寻找您要翻译的插件的插件名.cs
,尝试用CTRL+F搜索对应关键词进行更改,通常也是存放在" "
内,请更改" "
内的内容。
也有时候本地化隐藏在oxide/config/
的配置文件里面哦。
以上两种情况,进行本地化更改将会影响全部玩家。并且直接编辑在oxide/lang/en/
里的json文件也会影响全部语言的玩家。
关于插件权限
有时,有些插件需要授权才能使用一些功能和指令。
例如,当您使用一些指令的使用会弹出类似于You are not allowed to use this command
的消息则代表您没有权限使用该指令。
您需要授权自己该插件的相关权限,该插件的权限名可以在插件的说明或文档页面查看。

然后使用授权指令进行授权即可。
授权权限
首先,您先要知道一个指令:
oxide.grant <group|user> <name|id> <permission>
这是Oxide的授权指令,您也可以将oxide.grant
简化成o.grant
。
下方是该指令的构成和用法。
指令构成 | oxide.grant | <group | user> | <name | id> | <permission> |
构成说明 | 根指令,也可简化成o.grant | group或user(组或用户) | 组名或玩家名/ID | 权限名 |
使用示例 | oxide.grant | group | deafult | plugins.permission |
授权特定组
当您要授权权限给特定的权限组的时候,可以使用
oxide.grant group 组名 权限名
将组名替换成您要授权的权限组的名称,权限名替换成你要授权的权限名即可。
默认权限组
oxide存在着两个默认的权限组,分别是:
授权示例
oxide.grant group default plugins.permission
- 授权所有玩家plugins.permission
权限。
oxide.grant group admin plugins.permission
- 授权所有管理员plugins.permission
权限。
oxide.grant group vip plugins.permission
- 授权所有在vip组的玩家plugins.permission
权限。
授权指定玩家
当您要授权权限给指定的玩家的时候,可以使用
oxide.grant user 玩家名称/SteamID 权限名
将玩家名称/SteamID替换成您要授权的玩家的游戏名称或SteamID,权限名替换成你要授权的权限名即可。
授权示例
oxide.grant user BWIKI plugins.permission
- 授权给名为BWIKI的玩家plugins.permission
权限。
oxide.grant user 765611988305128900 plugins.permission
- 授权给Steam64位ID为765611988305128900的玩家plugins.permission
权限。(该示例ID并不存在,记得更改为您要授权的玩家的Steam64位ID。)
删除授权
删除授权的指令格式与授权指令一样,只是指令头的差别:
oxide.revoke <group|user> <name|id> <permission>
当然也可以和授权指令一样将oxide.revoke
简化成o.revoke
。
删除特定组权限
删除指定玩家的权限
使用插件
在授权权限后,就可以开始使用插件了。
插件的指令也可在插件的文档或说明界面查找到。

以/
开始的均为聊天命令,否则如果没有特殊说明则是控制台指令。
指令的相关功能请查看插件的文档或说明。
获取权限信息
您也可以通过指令查看指定玩家或组拥有的权限,或所有的权限和组。
查询指定玩家的权限和组
指令:oxide.show user 玩家名称
或 o.show user 玩家名称
。
示例:
oxide.show user BWIKI
- 查询玩家 BWIKI 的全部权限和组。
查询指定组的权限和玩家
指令:oxide.show group 组名称
或 o.show group 组名称
。
示例:
oxide.show group BWIKI
- 查询 BWIKI 组的全部权限和该组的全部玩家。
查询有指定权限的组和玩家
指令:oxide.show perm 权限名称
或 o.show perm 权限名称
。
示例:
oxide.show perm plugins.permission
- 查询拥有plugins.permission
权限的玩家或组。
查询全部权限
指令:oxide.show perms
或 o.show perms
。
示例:
oxide.show perms
- 查询服务器当前的所有权限。
查询全部组
指令:oxide.show groups
或 o.show groups
。
示例:
oxide.show groups
- 查询服务器当前的所有组。
权限组的创建与管理
除了默认的deafult
和admin
组,您也可以自行创建权限组。
创建权限组
指令:oxide.group add 组名
或 o.group add 组名
。
示例:
oxide.group add BWIKI
- 新建一个名为BWIKI
的权限组。
向权限组添加玩家
指令:oxide.usergroup add 玩家名称/ID 组名
或 o.usergroup add 玩家名称/ID 组名
。
示例:
oxide.usergroup add 对味 BWIKI
- 将玩家对味
添加到名为BWIKI
的权限组。
删除权限组
指令:oxide.group remove 组名
或 o.group remove 组名
。
示例:
oxide.group remove BWIKI
- 删除一个名为BWIKI
的权限组。
从权限组删除玩家
指令:oxide.usergroup remove 玩家名称/ID 组名
或 o.usergroup remove 玩家名称/ID 组名
。
示例:
oxide.usergroup remove 对味 BWIKI
- 将玩家对味
从名为BWIKI
的权限组中移除。
设置权限组的标题或排名
权限组的标题通常用于组的描述,或用于聊天头衔。而排行则是作用于权限组的排序。
指令:oxide.group set 组名 标题 排名
或 o.group set 组名 标题 排名
。
示例:
oxide.group set BWIKI [bilibili] 1
- 将权限组BWIKI
的标题设置为[bilibili]
并将排名设置为1
。
设置权限组的父级
为权限组设置父级后,该组将会继承父级的所有权限。
指令:oxide.group parent 组名 父级组名
或 o.group parent 组名 父级组名
。
示例:
oxide.group parent BWIKI admin
- 将权限组BWIKI
的父级设置为admin
,并继承admin
组的所有权限。
小工具
您可以使用以下小工具快速生成授权命令:
- 授权指令快捷生成工具
如何在社区服列表显示模组服
1.关闭服务器。
2.打开服务器根目录/oxide
,编辑oxide.config.json
文件。
3.将第三行"Modded": true,
改为"Modded": false,
然后保存,重启服务器即可。
注意,请阅读下方的指南,以确保符合Facepunch要求。违反该指南的,服务器IP可能会被Facepunch拉入黑名单。
在社区服务器上使用插件的指南
1. 不允许修改游戏玩法的插件:
我们禁止以任何方式影响玩家游戏玩法的插件。
例如:一个可以修改收集倍率、物品生成、玩家生成或熔炼机制的插件。
2. 不允许创建、更改玩家界面的插件
我们禁止在社区服务器中显示各种UI或修改游戏现有UI的任何插件。例如:图片/LOGO。
3. 允许管理类型的插件
您可以在社区服务器上使用有助于管理服务器的插件,只要改插件不会改变玩家的游戏玩法即可。
例如:您可以通过插件将服务器的规则告知玩家,但不能改变游戏的玩法。
常见的插件示例(包括但不限于):
Vanish, Admin Radar, Stash Traps, Logger, Group Limits
4. 允许跳过排队或聊天审核的插件
警告
如果您在社区服务器中使用了以上禁止的插件则服务器IP可能会被列入黑名单,导致服务器无法再在服务器列表显示。
服务器常用插件列表
有些新手服主在寻找自己所需的功能时总会不知道如何寻找,那就先来这里看看吧!以下是服务器中常用的一些插件。
寻找插件
使用快捷键CTRL+F换出搜索框,输入你要寻找的插件关键词即可!
常规插件
插件名称 | 插件英文名 | 介绍/功能 | 下载地址 | 备注/说明 |
资源倍率 | Gather Manager | 设置服务器采集资源的倍率 | uMod | |
叠加设置 | Stack Size Controller | 设置单个物品可以叠加的数量 | uMod | |
刷物品无提示 | No Give Notices | 刷物品公屏不提示 | uMod | 直接安装即可 |
传送插件 | NTeleportation | tpr/home的插件 | uMod | |
制作控制器 | Crafting Controller | 设置物品制作时间 | uMod | |
战利品倍率 | Magic Loot | 设置例如废料等在板条箱中的物品倍率 | uMod | |
自动升级 | BGrade | 可以让玩家设置自动升级建筑 | uMod | |
无绿名 | No Green | 管理员无绿名 | uMod | |
拆除工具 | Remover Tool | 拆除建筑或放置的物品 | uMod | |
白名单 | Whitelist | 仅允许有权限的玩家进入服务器 | uMod | |
GUI商店 | GUI Shop | GUI商店系统 | uMod | |
轮播广告 | Advert Messages | 公屏中的轮播广告 | uMod | |
新手保护 | Start Protection | 新玩家保护 | uMod | |
夜视 | Night Vision | 让玩家拥有夜视的能力 | uMod | |
快速融化 | Quick Smelt | 让熔炉的融化速度变得更快 | uMod | |
KIT礼包 | Rust Kits | kit礼包 | uMod | |
PVE插件