- 版权类型
- 原创
- 插件中文名称
- 工作台仓库
- 插件英文名称
- KiInventory
- 原帖地址
- #
- 支持的核心(服务端)
- Paper
- Purpur
- Leaves
- 语言支持
- 中文(简体)
- 前置组件
- PlaceholderAPI(可选)
- 适配版本(Java)
- 26.x
- 1.21
- 1.20
[MD]
# ✨ KiInventory — 全 GUI 多页仓库插件
> 🧩 Paper 多页仓库 · 保留原版工作台,右键即用
> 📌 作者:Kik | 语言:简体中文|联系方式 1252726629
> 📌 交流群: 1125669682
## 🚀 一句话简介
把「多页仓库」接进原版工作台:多页翻页、背包/仓库一键整理、照常合成;关闭自动保存,管理员能查能改能审计,不用改玩家习惯。
## 🧩 核心功能
- 🖥️ **两套界面**:工作台界面 + 独立 27 格仓库界面,快捷栏 9 格统一做导航。
- 📚 **多页仓库**:Page 0 使用玩家真实背包,Page 1..N 为仓库页,翻页显示当前页码。
- 🎒 **真实背包直连**:独立仓库底部显示完整真实背包,可直接存取,不是假背包。
- 🛡️ **关闭零丢失**:ESC / 关闭自动保存,光标物品与合成格物品自动回收,导航物品不可移动、不可丢弃、不可伪造。
- 🖱️ **原版操作一致**:支持 Shift 转移、拖动物品、Q / Ctrl+Q 丢弃、界面外丢出;合成产物支持 Shift 点击。
- 🔐 **异常安全**:死亡 / 掉线 / 关服不丢物品、不刷物品;保存带会话锁与版本校验,过期或无锁写入直接拒绝。
- 🧑💼 **管理套件**:查看、编辑、增减页数、设置上限、远程开关、安全关闭、审计日志、热重载。
- 🗄️ **存储自由**:SQLite(默认)/ MySQL / MariaDB,表结构自动创建,多服靠数据库会话锁协调,不依赖 Redis。
- 🔑 **权限细粒度**:`kiinv.pages.*`、`kiinv.pages.<n>`、`kiinv.admin.*`,默认不开放任何仓库页,按需给。
- 🌐 **多版本兼容**:Paper 1.20.x ~ 26.x,可选 PlaceholderAPI 仓库标题变量。
## 🖼️ 展示图片


## 🕹️ 快速上手
1. 把 `KiInventory.jar` 放入 `plugins/`。
2. 启动服务器,生成 `config.yml`、`messages.yml`、`kiinventory.db`。
3. 给玩家加页:`/kiinv admin add <玩家> 3`。
4. 玩家右键工作台,或输入 `/kiinv open`。
5. 工作台内翻页进仓库页,中间按钮进入独立仓库;ESC 自动保存。
## ⌨️ 常用命令
- `/kiinv help`:显示命令帮助
- `/kiinv open [页码]`:打开工作台,指定页码直接进仓库页
- `/kiinv page <页码>`:翻页,`0` 返回工作台
- `/kiinv toggle`:开启 / 关闭自己的仓库功能
- `/kiinv admin add <玩家> [数量]`:增加仓库页,自动开启功能
- `/kiinv admin remove <玩家> [数量]`:减少仓库页,减到 0 自动关闭
- `/kiinv admin max <玩家> <页码|clear> [--force]`:设置 / 清除页数上限
- `/kiinv admin view <玩家> <页码> [--force]`:只读查看
- `/kiinv admin edit <玩家> <页码> [--force]`:直接编辑
- `/kiinv admin toggle <玩家>`:远程开关
- `/kiinv admin close <玩家>`:安全关闭会话
- `/kiinv admin audit <玩家> [页码|*] [数量]`:审计日志
- `/kiinv admin reload`:重载配置 / 消息
## 🔐 权限简表
- `kiinv.admin.*`:全部管理权限
- `kiinv.admin.pages`:增加 / 减少玩家页数
- `kiinv.admin.max`:修改页数上限
- `kiinv.admin.view`:查看玩家仓库
- `kiinv.admin.edit`:编辑 / 关闭玩家仓库
- `kiinv.admin.toggle`:远程开关
- `kiinv.admin.audit`:审计
- `kiinv.admin.reload`:重载
- `kiinv.admin.force`:强制接管
- `kiinv.use`:插件接管工作台
- `kiinv.open` / `kiinv.page` / `kiinv.toggle`:基础使用
- `kiinv.pages.*`:开放全部仓库页
- `kiinv.pages.<n>`:开放到第 n 页
[/MD]