你在服务器上给玩家发东西,聊天栏会替你跟全服喊一句 —— 「SERVER 给了 Kk 100 个废料」。这个插件就是把这句话掐掉。东西照发,声音没有。
适合谁:要经常发东西的服 —— 发补偿、发活动奖励、发 VIP 福利、给某个玩家补回被吞的物品。
为什么需要:发给一个人时,那行提示等于把「谁被单独照顾了」贴在公屏上,跟着来的往往是「为什么他有我没有」。发给全服时倒是无所谓,可一旦养成了「发东西全服都知道」的习惯,服主的手就不敢动了。
技术底子:单文件 C#(Oxide / uMod),Harmony 给官方广播的四个出口各打一个前缀。它不发东西——东西仍然由官方命令发,插件只负责让那条消息不出门。
先说清定位,能省掉一堆误会:它不是「发放插件」。你原来用 inventory.give、用管理面板、用别的插件发东西,插件一个字节都不碰,发多少、发到哪个格子、掉不掉地上,全都还是原来那套逻辑。它只在最后一步 —— 消息准备广播出去的那一刻 —— 决定「这条别发了」。
一、官方到底会喊什么
先把要掐的东西摆出来。Rust 官方的三类发放,聊天栏原文长这样:
给全服发(giveall)
SERVER gave everyone 100 x Wood
给某一个人发(giveto)
SERVER gave Kk 1 x Rifle.ak
管理员在 F1 给自己刷(give)
Kk gave themselves 1000 x Low Grade Fuel
官方没有「静默发放」这个选项。这三句话是写死在广播函数里的,你发一次,它喊一次,没有配置能关。
二、它怎么把这些话掐掉的
不给发东西的代码动刀子,只在消息出口上装闸。Rust 的这三类广播,最后都要经过下面四个函数里的一个:
ConVar.Chat.BroadcastPlayerAction(BasePlayer, String) |
「某人做了什么」类广播的主出口,gave themselves 走这里 |
ConVar.Chat.BroadcastPlayerAction(…, String, BasePlayer, String) |
「A 给了 B 什么」的版本,gave you 走这里 |
ConVar.Chat.Broadcast(String, String, String, UInt64) |
玩家公屏聊天也走这个,所以这条要特别小心(见下面第七节) |
ConsoleNetwork.BroadcastToAllClients(String, Object[]) |
底层 chat.add,前面几条最终都可能落到这里再补一遍 |
四个出口都装上前缀,命中特征词就直接跳过原函数。四个全装是因为漏一个就漏一路:有的版本走上面,有的版本走下面,只堵一处会出现「换了个发法又开始喊」。
补丁会不会掉?插件在每次服务器存档时自查一遍四个补丁还在不在,掉了自动重装。你也可以随时敲 sg.check 手动验。这是实测跑出来的必要设计 —— 服务器跑久了、别的插件 reload 时,Harmony 补丁确实会掉。
三、八条命令
前缀 sg. 和 silentgive. 完全等价,打哪个都行。游戏内 F1 与 RCON 都能用,玩家调用必须有管理员身份或权限。
sg.give <物品> [数量] [cond] [皮肤] |
给自己发。只在游戏内 F1 有效(RCON 没有「自己」) |
sg.giveto <玩家> <物品> [数量] [皮肤] |
给指定玩家发。玩家在前、物品在后,跟官方一致;旧写法(物品在前)也认,自动兜底 |
sg.giveall <物品> [数量] |
给全服在线玩家发(自动跳过 NPC),一人一份 |
sg.giveequip <物品> [数量] [皮肤] |
发到快捷栏,省得玩家自己拖 |
sg.givearm <物品ID> [数量] |
发到穿戴栏,按数字 ID(护甲、衣服用这条) |
sg.check |
体检:四个补丁在不在位 + 运行统计。出任何问题先敲这条 |
sg.selftest |
给自己发 1 个木头,验整条链路。需要人在游戏里 |
权限:silentgive.admin 允许使用全部命令(IsAdmin 自带,不用额外给);silentgive.bypass 表示这人发东西时广播照常喊,故意让人看见。
四、敲下去看到什么(真实回话)
下面全是在真服上敲完屏幕上出现的原文,不是编的示例。
先体检一次
> sg.check [SilentGive] === SilentGive 体检 === 版本:1.2.2 配置:广播屏蔽=开 宽松拦截=开 要求数量格式=开 回执给执行者=开 调试=关 补丁: ✓ 在位:ConVar.Chat.BroadcastPlayerAction(BasePlayer, String) ✓ 在位:ConVar.Chat.BroadcastPlayerAction(BasePlayer, String, BasePlayer, String) ✓ 在位:ConVar.Chat.Broadcast(String, String, String, UInt64) ✓ 在位:ConsoleNetwork.BroadcastToAllClients(String, Object[]) 统计:命令hook=0 消息=0 补丁收到=0 补丁拦=0 老hook触发=0 老hook拦=0 结论:✓ 正常 —— 发放广播会被静默拦下
给一个人发
> sg.giveto Kk wood 1 已静默发放:wood x1 → Kk
给全服发
> sg.giveall wood 1 已静默发放:wood x1,成功 1/1 人
RCON 里敲「给自己发」会怎样
> sg.give wood 1 未执行:服务端 / RCON 下没有「执行者」,给自己发的命令用不了; 要给某个玩家发请用 sg.giveto <物品> <玩家> <数量>
这条提示是 1.2.2 特意加的。旧版只回一句「参数不符,或物品 / 玩家没找到」,服主看了会以为插件坏了 —— 其实是 RCON 本来就没有「自己」这个人。
不接管、只掐提示的时候长什么样
> inventory.giveall wood 1 [ServerVar] giving Kk 0 x Wood [SilentGive] [拦截] 已屏蔽发放广播:BroadcastPlayerAction [gave everyone 0 x Wood]
第一行是官方打的 —— 说明发放走的是官方那套,插件没插手。第二行是插件的拦截记录:东西发出去了,那句话没出去。这就是它在正常工作时唯一的痕迹。
落盘日志(oxide/data/SilentGive/log-日期.txt)
2026-11-11 15:41:20 屏蔽广播(BroadcastPlayerAction) [gave themselves 1 x Holosight] 2026-11-11 15:41:59 屏蔽广播(BroadcastPlayerAction) [gave themselves 100 x Homing Missile] 2026-11-11 16:11:47 屏蔽广播(BroadcastPlayerAction) [gave themselves 1000 x Low Grade Fuel]
五、1.2.1 → 1.2.2 修了什么
1.2.1 的主功能是好的(四个补丁都在位、日志里上百条真实拦截),但拿来体检时挖出几个真问题。这一版全是实测复现、改完再实测,不是「看代码觉得可能有问题」。
| 十条命令没拦权限 这条最要紧 |
Oxide 的 [ConsoleCommand] 本身不带权限门槛,方法体里不查就等于对所有人开放。1.2.1 里 sg.give、sg.giveall、sg.giveequip 全都没查 —— 任何玩家在 F1 敲一句 sg.give rifle.ak 1 就能给自己刷 AK,敲 sg.giveall wood 100 就是全服每人 100 木头。现在:十个命令、体检、自检全部过一个统一闸门 —— 服务端 / RCON 放行,玩家必须 IsAdmin 或持有 silentgive.admin。 |
| giveto 参数顺序反了 | 插件按「物品在前、玩家在后」解析,官方是「玩家在前、物品在后」。方向反的后果是接管永远解析失败、静默回退官方 —— 外部表现跟接管成功一模一样,很难发现。 现在:先按官方顺序解析,失败再退回旧顺序。两种写法都实测通过。 |
| 调试模式出厂就是开着的 | 默认 true,每次启动、每次存档都往控制台刷几十行诊断样本。功能没影响,但真出问题时关键那几行被淹了。现在默认关。 |
| 玩家聊天可能被误吞 | 被拦截的四个函数里有一个就是玩家公屏聊天本身。旧版对它也用「含 gave 就拦」的宽松规则,玩家打一句 he gave me 3 x scrap 就会静默消失。现在:玩家聊天那一路单独走严格模式 —— 不做宽松匹配,也跳过 gave you(玩家之间说这句太常见)。 |
| 顺手的四处 | ① 玩家每条公屏消息都要进一次前缀,旧版先拼整句再判断,新版先扫有没有 gave、没有直接放行;② 给「睡眠中(已离线)」玩家发东西改成默认关(写进离线背包有丢件风险),要补发才开; ③ 背包满全掉地上时回执原来写 x0,看着像失败,改成实际给出的件数;④ RCON 下敲 sg.give 类命令给出明确提示(见上一节)。 |
| 没动的 | Harmony 拦截主体、四个靶点、存档自检与自动重装、日志与去重 —— 实测都正常,一个字没改。 |
实测对照(同一台服,改前改后各敲一次):
sg.giveto Kk wood 1 |
旧:解析失败,回退官方 | 新:已静默发放:wood x1 → Kk |
sg.giveto wood Kk 1 |
旧:成功(因为顺序就是反的) | 新:也成功(兜底路径) |
sg.give wood 1(RCON) |
旧:未执行:参数不符… | 新:明确告知用 sg.giveto |
inventory.giveall 广播 |
旧:拦住了 | 新:照样拦住(补丁收到=1 拦=1) |
| 权限表 | 旧:无 silentgive.admin | 新:oxide.show perms 已列出 |
六、怎么装(3 步,2 分钟)
| 1 | oxide/plugins/SilentGive.cs 丢进服务端的 plugins 目录(包里的 oxide 文件夹整个合并到服务端根目录也行) |
| 2 | 控制台执行 oxide.reload SilentGive,看到下面这行就成了:[SilentGive] SilentGive v1.2.2 已加载 | 命令接管:… | 广播屏蔽=开 | 调试=关 |
| 3 | 敲 sg.check 验一下,四个补丁全打勾、结论「✓ 正常」即通 |
不需要做的:不用传图片、不用填授权码、不用装别的插件。这个包一张图都没有 —— 它的效果就是一句话不见了,本来也截不出图。
七、用之前得知道的七件事
| 它不发东西,只掐提示 | 最容易误会的一条。东西仍然由官方 inventory.* 发,插件不参与发放。所以它不能解决「数量给错了」「物品不存在」这类问题,那些还是官方自己的报错 |
| RCON 里发不了「给自己」 | sg.give / sg.giveequip / sg.givearm 需要「执行者」,RCON 没有。要给谁发就用 sg.giveto,物品在前也行 |
| 玩家必须给权限 | 不是管理员、也没 silentgive.admin 的玩家敲这些命令,只会收到「只有管理员可以使用此命令」。这是 1.2.2 补上的,1.2.1 没有这道门 |
| 想让人看见某一次发放 | 给这个人 silentgive.bypass 权限即可 —— 他发东西时广播照常喊出去。活动抽奖那种「必须让人看见」的场合用 |
| 特征词可以自己加 | 配置里 广播特征词 是四条小写英文短语,消息里包含任一条就拦。哪天官方改了措辞导致漏拦,把新文案加进去就行,不用等更新 |
| 离线玩家默认不给发 | 往离线背包塞东西有丢件风险,所以默认关。要给离线的人补发,打开配置里那一项再发 |
| 调试模式排查完要记得关 | 开着会把每条消息样本都刷到控制台。查漏拦的时候开,查完改回 false,不然日志会被淹 |
八、常见问题
| 装了但还是会喊 | 先 sg.check。四个补丁有任何一个打叉,说明没装上或者被别的插件顶掉了 —— 敲 oxide.reload SilentGive 会重装。全打勾还漏,开调试模式发一次,日志里会出现真实文案,把它加进特征词 |
| 改了配置没生效 | oxide.reload SilentGive。配置文件是启动时读的 |
| 玩家说他的聊天被别人看不见了 | 1.2.2 已经把玩家聊天那一路收窄了(不做宽松匹配、跳过 gave you)。如果还有,让他把那句原话发出来,大概率是同时含了 gave themselves / gave everyone 这类特征词 —— 那属于按设计拦的 |
| 和别的发物品插件冲突吗 | 不冲突。它只动消息出口,不碰任何发放逻辑。别的插件发东西照样发,只要那条广播经过这四个函数之一,就会被拦 |
| 日志在哪、会占多大 | oxide/data/SilentGive/log-年-月-日.txt,按天分文件,默认保留 7 天自动删。一条拦截就一行,量很小 |
| 能拦住别的插件的发放广播吗 | 只要那个插件最终是通过上面四个函数之一广播的,就拦。如果它自己拼字符串直接发给客户端、绕开这四个函数,就拦不到 —— 这种情况特征词也没用 |
一句话收尾:它的定位很窄 —— 只做一件事:让「谁拿了多少」这句话别出门。不接管发放、不碰物品、不碰玩家数据,也没有定时器。你要的是「发东西不发公告」,它就是那只手;你要的是「换个方式发东西」,它不是。










