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="<凭据>"

(在极少出现的网络极端中断情况下，管理员可根据审计凭据进行人工审核收尾)