材料收集背包 SPmaterial
一个专门收纳修仙素材的单容器背包 · v2.3.2
玩家腰带旁多一个背包图标,点开就是材料背包,自动把宝石、丹药、材料、符纸、灵草、卡片收进去,
打开面板可自由双向拖拽,关闭后恢复自动收纳。单容器、无翻页、事件驱动,不跑轮询、不增加常驻负担。
适合谁:装了修仙 / 抽奖 / 宠物 / 锻造等自研插件、自定义素材越来越多的服——尤其是 PVE 长期服。
为什么有用:素材散落在玩家背包和腰带里,既占格子又难管理。这个背包把它们集中收纳、自动分流,玩家背包清爽,材料还不会丢。
技术底子:单文件 C#(Oxide / uMod),JSON 持久化,重启不掉档,热重载不丢数据;同时兼容 CID 自定义物品与皮肤类物品。
为什么有用:素材散落在玩家背包和腰带里,既占格子又难管理。这个背包把它们集中收纳、自动分流,玩家背包清爽,材料还不会丢。
技术底子:单文件 C#(Oxide / uMod),JSON 持久化,重启不掉档,热重载不丢数据;同时兼容 CID 自定义物品与皮肤类物品。
真机画面:背包打开,宝石、丹药、材料、宠物卡片整齐收纳;左下角腰带旁即入口图标一、核心功能
| 自动收纳 | 白名单素材一进背包就自动收入材料背包,无需手动整理 |
| 双向拖拽 | 打开面板期间暂停自动收纳,材料可自由拖回玩家背包,关闭后恢复 |
| 两类物品都认 | 同时支持 CID 独立短名物品(spxx.*)与原生载体 + 皮肤类物品 |
| 图标入口 | ImageLibrary 渲染真实背包 logo,位置可在配置里微调;缺图自动文字兜底 |
| 旧数据兼容 | 早期多页背包数据加载时自动合并到单容器,升级不丢物品 |
二、权限与容量(玩家最关心)
| 权限节点 | 格子 | 物品限制 |
|---|---|---|
| spmaterial.use(默认授予) | 24 | 仅白名单 |
| spmaterial.vip1 | 36 | 仅白名单 |
| spmaterial.vip2 | 48 | 任意物品 |
| spmaterial.admin | — | 管理命令 |
基础权限插件加载时自动授予 default 组,所有玩家进服即 24 格;VIP 需服主单独授权。
三、玩家命令
· 点击屏幕左下角腰带旁的背包图标打开
· 或聊天框输入:
· 或聊天框输入:
材料四、管理员命令(F1 控制台,需 spmaterial.admin)
spmaterial.admin wipe 清空全部在线玩家材料背包 spmaterial.admin setslots <玩家> <数量> 给玩家手动固定格子数 spmaterial.admin resetslots <玩家> 取消固定,恢复权限自动判定
缩小格子时,若目标格数小于玩家已占用格数,系统拒绝改动并保持原样,绝不丢物品。
五、安装(3 步)
1. 把包内 oxide/ 合并进服务器根目录;2. 确认已装 ImageLibrary;3. 插件自动加载,无需手动授权。
oxide/plugins/SPmaterial.cs oxide/config/SPmaterial.json oxide/data/SPmaterial/logo.png
六、性能实测(不增加负担)
| 指标 | 实测结果 |
|---|---|
| 空闲 CPU | 0(无 OnTick / 定时器 / 协程,纯事件驱动) |
| 单次自动收纳 | 创建约 41.85 微秒 / 纯移动约 28.28 微秒 |
| 连续 50 次收纳 | 全部成功,托管内存净增 0 KB |
七、更新记录
v2.3.2 新增武器锻造 6 种宝石(研究纸载体)白名单,修复特效宝石等无法收纳的问题。
v2.3.1 单容器无翻页定稿;基础 24 / vip1 36 / vip2 48;自动授权 default 组;兼容旧多页数据;入口图标位置微调。
v2.3.1 单容器无翻页定稿;基础 24 / vip1 36 / vip2 48;自动授权 default 组;兼容旧多页数据;入口图标位置微调。
依赖:ImageLibrary(缺失时按钮文字兜底,不影响功能)。清档时删除 data/SPmaterial 下的玩家 json、保留 logo.png 即可。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END








