体质强化 SPqh v1.0.0

一句话：让玩家用「石头」把自己的血、水、饿从 100 一路顶到 3000，30 级满级后还能继续点采集、减伤、掉率。
面板自绘、HUD 自绘、四档宝石、11 类掉宝来源、成功率衰减与保底，全部数值写在配置文件里，不用改一行代码就能改成你自己的玩法。

适合谁：PVE / 长期服 / 想给玩家一条「看得见的成长线」的服主。
为什么有用：Rust 的生存压力集中在血、水、饿三条线上，这三条一涨，玩家敢去的地方就变多，留存自然上来；而「石头」把成长拆成看得见的进度条，玩家每天都有事做。
技术底子：单文件 C#（Oxide / uMod），无数据库、无外部依赖（除 ImageLibrary），重启不掉档，热重载不丢数据。

一、它到底做了什么

三条一起长	生命 / 水分 / 饱食同步提升，1 级 100 → 30 级 3000，每级 +100
石头就是材料	背包里四档宝石（碎裂 / 普通 / 精制 / 至臻），点档位自动从背包扣，不用拖拽
三页签面板	强化 / 玩法介绍 / 进阶，新玩家打开就知道怎么玩，不用服主一个个教
右下角 HUD	常显「体质 Lv N」+ 血水饿三条数字 + 四档石头数，关掉面板也能看见进度
失败不掉等级	强化失败只扣当次石头，等级与上限都不掉；每档有独立保底，连着失败到次数必成
石头自己会掉	挖矿、砍树、捡东西、打科学家、杀动物、开木箱 / 军用箱 / 军械箱 / 空投，11 类来源全部可调概率

二、玩家看到的三页

第 1 页「强化」：四格宝石显示库存与保底进度，下面是生命 / 水分 / 饱食三条进度条，底部一条强化按钮。点一下扣石头、成功后进度条往上涨，面板上还会有细框扩散 + 状态卡闪框的反馈，不动整块面板（不会晃眼睛）。

第 2 页「玩法介绍」：8 条规则速查 —— 三条一起长、材料就是石头、成功率、每次扣几颗、失败怎么算、石头哪来、界面怎么用、满级之后。新玩家自己看，服主省事。

第 3 页「进阶」：本体 30 级后才解锁，三条扩展线用同一批石头继续点。没满级时整页锁灰，按钮点不动，后端也不会偷偷生效。

三、等级消耗（玩家最关心的一张表）

消耗按目标等级分五段递增，每 6 级涨一档，越往后越贵，前期给得快、后期拉得长：

目标等级	每级消耗	该段小计	累计
1 → 6	40 颗	240	240
7 → 12	60 颗	360	600
13 → 18	80 颗	480	1080
19 → 24	100 颗	600	1680
25 → 30	120 颗	720	2400

四种档位折算（一路不失败的理论净值）：碎裂石约 2400 颗、普通石约 2400 颗、精制石约 800 颗、至臻石约 240 颗。

这只是净值 —— 25 级往后成功率会衰减到 16% 左右，必然有失败重试，实际期望约为净值的 3 倍上下，不过每档都有保底兜着。按默认掉率正常玩，从 1 级到 30 级大约 4~5 个月；想快就调阶梯，想慢就加衰减，一个数字的事。

四、四档石头（把「肝」拆成四条路）

档位	基础成功率	用量倍率	保底	定位
碎裂石	60%	×1.0	12 次	主力，随手就有
普通石	75%	×1.0	10 次	中期稳一点的选择
精制石	88%	×0.33	8 次	一颗顶三颗，减少挫败
至臻石	100%	×0.1	20 次	土豪直通，商城主力

为什么不是一种石头：一种石头只有「攒」，四种石头才有「选」—— 玩家会自己算哪档最划算，会拿碎裂石试水、拿至臻石保底冲关，这就是决策空间。四档还天然形成四条付费/活跃路径，商城、签到、活动都能挂上去。

注：石头底材统一是 bone.fragments（骨头碎片），靠皮肤分成四档；背包里显示的名字是「碎裂石 / 普通石 / 精制石 / 至臻石」，与面板档位完全对得上。物品悬停的说明文字是客户端本地文本，改不了（只有名字能改），这点先说清楚。

五、满 30 级之后的「进阶」

采集效率	每级 +2%，满 10 级 +20%（矿、木头、采集物整体变多）
减伤	每级 +2%，满 10 级减 20% —— 3000 血满级等效 3750 血
掉落加成	每级 +4%，满 10 级 ×1.4，石头到手更快

三条各 10 级、各自独立，每次升级消耗 2 颗当前选中档位的石头。本体没满级时整页锁死，后端也不生效 —— 不会出现「面板写着未解锁、实际却在偷偷加成」的尴尬。

六、服主怎么装（4 步，5 分钟）

第 1 步：解压把压缩包里的 oxide/ 整个合并进服务器根目录，落地是这三个位置：

oxide/plugins/SPqh.cs
oxide/config/SPqh.json
oxide/data/SPqh/icons/  (gem0~3.png、panel.jpg、btn.png 共 6 张)

第 2 步：配置想用作者调好的数值就保留 SPqh.json；想从干净默认开始就删掉它，插件首次启动会自己生成。
第 3 步：授权（漏了这一步玩家点按钮全都没反应，且客户端不报错）

oxide.grant group default spqh.use
oxide.grant group admin spqh.use
oxide.grant group admin spqh.admin

第 4 步：加载确认

oxide.reload SPqh
# 日志要出现这三行：
# SPqh was compiled successfully in ~1700ms
# [SPqh] 素材注入 6/6 张（面板 PNG 走 FileStorage，不走网络）
# Loaded plugin SPqh v1.0.0

依赖：ImageLibrary。没有它插件不会崩，只是面板图标退化成纯色块。

七、所有数值都能改（这才是它值钱的地方）

改 oxide/config/SPqh.json 后 oxide.reload SPqh 即生效，不用重开服、不用改代码。六个分组，40+ 个可调项：

分组	能调什么
通用	总开关、调试小字、全服公告起始等级
强化	等级上限、新手保护等级、全局保底次数、生命/水分/饱食各自的基线、每级加成、上限校验
宝石	载体物品、消耗阶梯（可加段改值）、四档倍率、成功率衰减、最低成功率、每档保底次数、档次名称/皮肤/成功率
掉落	11 类来源的独立概率 + 每次掉几颗 + 总开关
HUD	开关、刷新间隔（嫌重改 2秒，开销直接减半）
扩展线	开关、最高等级、每次消耗、三条每级加成

举个例子 —— 想让满级正好 5000 血：

"强化": {
  "等级上限": 30,
  "进服基线：生命": 100.0,
  "每级加成：生命": 169.0,        // 100 + 169×29 ≈ 5001
  "每级加成上限校验：生命": 5000.0   // 天花板
}

五条现成配方，照抄就能开不同服：

一小时满级（爽服）	消耗阶梯全改 1、成功率衰减 0、最低成功率 100
一年长线（PVE 长期）	阶梯 ×5（200/300/400/500/600）、衰减 2.5、最低 3%
只有碎裂石能用	把普通 / 精制 / 至臻的成功率改 0
土豪直达（付费服）	至臻石倍率改 1、保底改 1，等于一颗必成，当付费道具卖
只走商城不打怪	「启用掉落」改 false，石头全由商城 / 签到 / 活动发

改不动的只有：面板尺寸与配色、面板最多 4 格石头、扩展三条的标题文案、升级特效帧数、宝石改名轮询间隔 —— 这几项写死在代码里，要改得动源码。

八、怎么把宝石放进商城

先搞清楚物品是什么 —— 石头不是新物品，是给 bone.fragments（骨头碎片）套了四张皮肤：

档位	物品短名	皮肤 ID
碎裂石	bone.fragments	2917836458
普通石	bone.fragments	2917835395
精制石	bone.fragments	2917837827
至臻石	bone.fragments	2917837165

做法 A · 商城商品（推荐）
在你的商城 / 商店插件里新建商品，物品填 bone.fragments、数量填颗数、皮肤填上表对应的数字 ID。玩家买到手就是「碎裂石 ×N」，名字和面板对得上，不会出现「买了不知道是啥」。建议只上「碎裂石 100 包」「普通石 100 包」「精制石 10 包」「至臻石 单颗」，别一次给大包，否则满级节奏被冲垮。

做法 B · 签到 / 活动 / 礼包直接发
用命令发货，最简单也最不会出错：

spqh.give <玩家名或SteamID> 1 100    # 100 颗碎裂石
spqh.give <玩家> 2 20              # 20 颗普通石
spqh.give <玩家> 3 5               # 5 颗精制石
spqh.give <玩家> 4 1               # 1 颗至臻石

只发石头、不发等级 —— 成长节奏仍由成功率曲线控制，不会一发就满级。玩家背包满时石头会掉在地上（有提示），补发前让他清一下背包。

一个陪跑的商品结构（可直接抄）：

商品	内容	对应等级段
新手包	碎裂石 ×200	1-6 级，破冰
进阶包	普通石 ×300	7-15 级，主力
精制包	精制石 ×30	16-25 级，减挫败
至臻礼盒	至臻石 ×10	26-30 级，直通
月卡 / 签到	每天碎裂石 ×20	拉长期留存

九、它为什么能留住人（服主视角）

每天都有进度	HUD 一直在右下角显示「Lv N + 三围数字」，玩家砍两下树就多一颗石头，看得见的小步快跑，比「攒 100 万废料」那种抽象目标黏人得多
失败不劝退	失败只扣当次石头、等级不掉，还有保底兜底 —— 玩家不会因为一次爆掉就骂人退服
天然付费点	四档石头 + 商城 + 签到，一套东西能挂出新手包 / 进阶包 / 精制包 / 至臻礼盒 / 月卡五种商品，且都不破坏平衡（只加速，不越级）
敢去更远的地方	3000 血 + 20% 减伤 ≈ 3750 等效血，玩家能进军用箱、空投点、火箭基地，游戏内容解锁了，留存自然好
省服主的事	面板第二页就是规则说明，新玩家自己看；所有数值可配，换季、开新服、调平衡不用找人改代码

十、命令表

玩家（聊天）：/spqh 开面板 · /spqh close · /spqh tier 0-3 换档 · /spqh up 强化 · /spqh ext claw|reduce|loot 点扩展

管理员命令（控制台 / rcon）	作用
spqh.give <玩家> <1-4> [数量]	发石头，数量上限 2000
spqh.set <玩家> <1-30>	直接设等级，属性上限同步
spqh.up <玩家>	代玩家强化一次
spqh.panel <玩家>	远程开面板
spqh.close [玩家]	关面板，不带名字关掉全部
spqh.tab <0-2> [玩家]	远程切页签
spqh.extup <0-2> [玩家]	远程点扩展线（0 采集 / 1 减伤 / 2 掉率）
spqh.extset <0-2> <等级> [玩家]	直接设扩展等级
spqh.info [玩家]	查等级、上限、保底、四档石头数

十一、性能：它到底占多少

同一台服（12 核 / 64G，13 个插件）做的 A/B 实测：45 秒窗口交替采样 RustDedicated 进程的 CPU 时间，一次插件在线、一次卸载插件。

状态	45 秒 CPU	单核占用
插件在线	23.94s	53.2%
卸载插件后	22.57s	50.2%
增量	1.37s	3.04% 单核 = 0.25% 整机

常驻内存 1-2 MB（同服其它插件 11-317 MB）。为此专门做了几件事：HUD 一次遍历数完四档石头（背包遍历 16 次 → 4 次）、HUD 值没变直接返回、存档 2 秒合并写盘、只在真补默认值时才回写配置、面板重绘复用缓存。
嫌重还能自己调：HUD 刷新间隔改 2 秒（开销减半）、或直接关掉自绘 HUD。

十二、更新记录

v1.0.0（首个发布版）

功能	三页签面板、三围同步强化、四档宝石独立皮肤与命名、消耗阶梯、倍率、衰减、新手保护、分档保底、11 类掉宝、满 30 级扩展线、自绘 HUD、不晃面板的强化反馈、死亡/倒地/下线/重生四处清 UI
稳健性	配置五大分组逐块 null 兜底；保底配 0 = 该档不设保底（不会变成每次必成）；扣石非原子问题修正（石头不够不会扣光还不升级）；扩展线未满级时后端不生效；箱子稀有度判断顺序修正；满级文案/等效血量全部读配置
性能	HUD 背包遍历 16→4 次、HUD 值未变直接返回、存档 2 秒节流、配置按需回写；实测单核 +3% / 整机 +0.25% / 内存 1-2 MB

十三、限制

1. 背包里悬停的「说明文字」改不了 —— 那是 Rust 客户端本地文本，插件只能改物品名字（名字确实变成了「碎裂石 / 普通石 / …」）。
2. 不支持把石头从背包拖进面板 —— Rust 的 CUI 收不到背包拖拽（社区已确认），所以做成「点档位自动扣背包」。
3. 面板和背包同在 Overlay 层，开背包时面板上会盖一层黑纱（设计如此，避免面板被背包吃掉点击）。
4. 单次强化没有冷却，可以连点；要拦就调成功率 / 保底，或自行加冷却。
5. 原生血条上的「100」数字改不了，真实上限看右下自绘 HUD。
6. 面板石头格子最多 4 格；扩展三条标题文案写死在代码里。

十四、下载包里有什么

SPqh-1.0.0.zip
├─ oxide/plugins/SPqh.cs              插件源码（单文件 C#，Oxide 直接编译）
├─ oxide/config/SPqh.json             默认配置（作者调好的数值）
├─ oxide/data/SPqh/icons/
│   ├─ gem0.png / gem1.png           碎裂石、普通石 图标
│   ├─ gem2.png / gem3.png           精制石、至臻石 图标
│   ├─ panel.jpg                     面板底图（512×644）
│   └─ btn.png                       强化按钮长条
└─ SPqh-使用说明.md                   服主手册：安装、配置全表、命令、配方、排查

压缩包按 Oxide 标准目录组织，解压到服务器根目录即可落地。6 张图标必须一起拷 —— 少一张那一处就退化成纯色块。

最后一句实话：这不是一键换皮的噱头插件，它是「一条能让玩家每天回来点一下的成长线」。数值全部摊开在配置里，你想开爽服就一小时满级，想做长线就一年走完，代码一个字都不用动。