静默发放插件 SilentGive

静默发放插件 SilentGive-Biu腐蚀网
SilentGive 静默发放 · 免费下载
本插件为免费插件,登录后即可下载。
¥0
免费资源

你在服务器上给玩家发东西,聊天栏会替你跟全服喊一句 —— 「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 天自动删。一条拦截就一行,量很小
能拦住别的插件的发放广播吗 只要那个插件最终是通过上面四个函数之一广播的,就拦。如果它自己拼字符串直接发给客户端、绕开这四个函数,就拦不到 —— 这种情况特征词也没用

一句话收尾:它的定位很窄 —— 只做一件事:让「谁拿了多少」这句话别出门。不接管发放、不碰物品、不碰玩家数据,也没有定时器。你要的是「发东西不发公告」,它就是那只手;你要的是「换个方式发东西」,它不是。

© 版权声明
THE END
喜欢就支持一下吧
点赞10赞赏分享
相关推荐