OneWayVault跨服物资仓插件
OneWayVault 跨服物资仓插件教程
OneWayVault 是 IGNG 服务器专用的安全跨服/跨周目物资流转系统。它允许玩家将旧周目或指定服务器中的珍贵物资，安全地带往新周目或目标服务器中，实现平稳开荒。
核心机制：单向物资流转规则
为了保障服务器经济生态平衡，防止恶意跨服倒卖，物资在各服务器之间严格遵循单向流动原则：
[ 发送端服务器 (SOURCE) ] ── 存入入库 ──► [ 云端跨服物资仓 ] ── 提取出库 ──► [ 接收端服务器 (SINK) ]
(例如：即将完结的上一周目) (例如：刚开荒的新一周目)
| 服务器角色 | 你的权限 | 核心操作 |
|---|---|---|
| 发送端 (SOURCE) | 只存不取（仅可将物资存入跨服仓） | 整理物资放入箱子，关闭即发送 |
| 接收端 (SINK) | 只取不存（仅可从跨服仓提取物资） | 浏览云端物资库，点击提取到背包 |
注：每台服务器的角色由服主统一预设。进入游戏打开仓库时，界面标题会明确提示当前为“仅可发送”还是“仅可领取”。
一、 发送端操作指南（如何存入物资）
在即将结周目的老服务器或指定发送端服中：
1. 打开存入缓冲区
在聊天框输入指令：
/vault
(或别名 /transfer)
此时会为你打开一个专属的本地物资缓冲箱界面。
2. 存入与整理物品
- 你可以将背包中准备带走的贵重物品（矿物、工具、纪念品等）放入箱子中；
- 支持使用常规操作：普通点击放入、按住 Shift 键快速转移；
- 在箱子内可以自由摆放和整理物品。
3. 提交并发送入库
- 关闭箱子界面：当你整理完毕并关闭箱子时，系统会自动将箱子内的所有物品打包同步至你的云端跨服物资仓；
- 重要提示：关闭箱子后，系统需要片刻时间完成云端同步，聊天框会出现“物资已成功发送”的提示。提交期间请勿频繁连续开关箱子。
二、 接收端操作指南（如何提取物资）
在已开启接收的新周目服务器中：
1. 打开云端物资库
在聊天框输入指令：
/vault
(或别名 /transfer)
系统将为你加载并打开你在该服务器的跨服物资库界面。
2. 提取物品到背包
在仓库界面中点击你的物品即可提取：
- 🖱️ 左键点击：提取该格子的整组物品；
- 🖱️ 右键点击：提取该格子的 1 个物品；
- 🖱️ Shift + 左键/右键：快速整组提取至背包快捷栏。
3. 翻页浏览与刷新
- 底部导航栏提供 上一页（左箭头）、下一页（右箭头） 按钮，如果物品较多可翻页浏览；
- 中间的 刷新（指南针） 按钮可随时重新获取最新的物资状态；
- 点击 关闭（屏障图标） 或直接按 ESC 退出仓库。
智能背包保护：
当你提取物品时，系统会自动检查你的背包剩余空间。若背包空间不足，系统会安全拦截并提示你整理背包，绝不会发生物品溢出或丢失的情况！
三、 使用注意事项与操作规范
- 同名物品的独立存放：
- 插件会精确保留物品的所有属性（包括附魔、耐久度、自定义名称、NBT 组件等）。
- 即使名称相同，如果附魔或耐久不同，也会独立占用不同的仓位，不会强行混合。
- 操作排队原则：
- 为了确保数据绝对一致与安全，每位玩家同一时间只处理一笔物资流转操作。
- 如果网络稍有延迟，看到“操作正在处理”时请稍候 1~2 秒，切勿鼠标狂点。
- 账号绑定与跨服身份：
- 跨服物资仓与你的个人账号绑定，请确保在不同服务器使用同一个账号登录游戏。
四、 常见提示与排查
| 提示内容 | 说明与处理建议 |
|---|---|
| 背包没有足够空间，物资仓未改变 | 你的个人背包已满，请清理背包出空位后再提取 |
| 你已有一笔物资操作正在处理 | 上一次提取或同步尚未完成，请等待 1 秒后再操作 |
| 中央物资仓已达到配额上限 | 你的跨服仓存储格位已满，请先前往接收端提取部分物资后再继续存入 |
| 仓库状态已变化，请刷新 | 数据已更新，点击界面底部的指南针刷新按钮重新打开即可 |
| 物资仓当前不可用 | 正在维护连接，稍等片刻后重试 |
五、 管理员运维命令参考（仅限管理员/OP）
普通玩家无需关注本节内容。
管理员可通过全量权限 onewayvault.admin 或特定节点进行运行状态监控与维护：
检查插件与数据库健康状态：
/owv admin status(查看当前服务器角色 SOURCE/SINK、周目识别号、数据库连接池及待处理队列状态)
查询指定玩家的仓位清单：
/owv admin inspect <玩家UUID>(查看玩家当前在物资仓中的所有物品明细、数量与来源服务器)
查询玩家操作历史日志：
/owv admin history <玩家UUID> [页码](按时间倒序核查玩家的存入 DEPOSIT / 领取 WITHDRAW 记录)
异常单审核与安全确认：
/owv admin pending [页码] /owv admin operation <操作UUID> /owv admin resolve <操作UUID> <commit|finalize|requeue> --confirm reason="<原因>" evidence="<凭据>"(在极少出现的网络极端中断情况下，管理员可根据审计凭据进行人工审核收尾)