- 版权类型
- 原创
- 插件中文名称
- 星牌仓库
- 插件英文名称
- HxWarehouse
- 原帖地址
- #
- 支持的核心(服务端)
- Spigot
- Paper
- Folia
- 语言支持
- 中文(简体)
- 前置组件
- #
- 适配版本(Java)
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
[MD]
# HxWarehouse
专注于 **数据安全**、**MySQL 多服同步**、**高卡顿/崩服恢复** 的仓库插件。
市面上有太多功能齐全的仓库插件了,但是专注于数据安全的插件少见。
不主打花哨功能,而是把最核心的仓库链路做稳,尽量避免传统仓库插件常见的:
- 卡顿时保存来不及导致物品丢失
- 崩服后仓库与背包不同步导致刷物
- 多服同时写入导致数据错乱
- 旧异步任务覆盖新数据
---
## 支持环境
- Paper
- Spigot
- Folia
支持版本:
- `1.16.5 - 1.21.x`
---
## 插件特点
- MySQL 多服共享仓库
- 单玩家单仓库页全网单写锁
- 本地 WAL / Journal 先落盘再提交
- 启动恢复 + 登录修复双重兜底
- 防丢物、防刷物、防旧数据覆盖
- 仓库页支持权限扩展
- 标题支持 PlaceholderAPI
- 独立语言文件与中文注释配置
---
## 当前功能
- 个人仓库
- 多页仓库权限解锁
- MySQL 快照存储
- 本地恢复日志
- 启动恢复
- 登录修复
- 管理员查看仓库
- 管理员回滚仓库
- 管理员恢复重放
- 管理员锁状态查看
---
## 命令与权限
### 玩家命令
| 命令 | 作用 | 权限 |
| --- | --- | --- |
| `/warehouse` | 打开自己的第一页仓库 | `hxwarehouse.use` |
| `/warehouse 2` | 打开自己的第 2 页仓库 | `hxwarehouse.use` + 对应页权限 |
| `/warehouse open 3` | 打开自己的第 3 页仓库 | `hxwarehouse.use` + 对应页权限 |
### 管理命令
| 命令 | 作用 | 权限 |
| --- | --- | --- |
| `/hxw status <玩家>` | 查看该玩家当前会话状态与待修复状态 | `hxwarehouse.admin.status` |
| `/hxw recover list` | 查看当前所有待修复任务 | `hxwarehouse.admin.status` |
| `/hxw recover replay <玩家>` | 手动触发该玩家恢复重放 | `hxwarehouse.admin.status` |
| `/hxw view <玩家> [页数]` | 只读查看目标玩家仓库 | `hxwarehouse.admin.view` |
| `/hxw rollback <玩家> <页数> <revision>` | 回滚指定仓库页到历史版本 | `hxwarehouse.admin.rollback` |
| `/hxw forceopen <玩家> [页数]` | 强制接管该仓库页锁状态 | `hxwarehouse.admin.status` |
### 权限节点
| 权限节点 | 作用 |
| --- | --- |
| `hxwarehouse.use` | 使用玩家仓库 |
| `hxwarehouse.page.2` | 解锁第 2 页 |
| `hxwarehouse.page.3` | 解锁第 3 页 |
| `hxwarehouse.page.4` | 解锁第 4 页 |
| `hxwarehouse.page.5` | 解锁第 5 页 |
| `hxwarehouse.page.6` | 解锁第 6 页 |
| `hxwarehouse.admin.status` | 使用状态/恢复/强制接管相关命令 |
| `hxwarehouse.admin.view` | 只读查看玩家仓库 |
| `hxwarehouse.admin.rollback` | 回滚玩家仓库 |
---
[/MD]