随身仓库插件

PocketInventory 随身仓库

> 为 Paper 1.21 – 1.26.2 服务器打造的玩家随身仓库插件，对接 Vault 经济，支持花钱解锁页面、扩容仓库，全程 GUI 操作，内置中英双语言。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | PocketInventory（随身仓库） |
| 开发者 | LiquidTeam / YuHongChen |
| 最新版本 | v1.3.0 |
| 许可协议 | 保留所有权利（未经许可不得商用或再分发） |
| 兼容版本 | Paper 1.21 – 1.26.2 |
| 运行平台 | Paper（Java 21+） |
| 项目地址 | https://modrinth.com/user/LiquidTeam |
| 官方文档 | 见插件内 config.yml 注释与 lang/ 语言文件 |
简介

PocketInventory 是一款轻量而功能完备的玩家随身仓库插件。玩家输入 /ck 即可打开专属仓库，数据按玩家独立存储；仓库采用 6 行大箱子 GUI（5 行存储区 + 底部菜单栏），支持多页面、上一页/下一页切换、经济解锁与扩容。

插件对接 Vault 经济，第 2 页起可花费金币解锁，已解锁页面还能继续花钱加行；提供 SQLite（默认）/ 文件 / MySQL 三种存储后端，全程异步读写不卡服；内置简体中文与英文语言文件，language: auto 模式下会根据玩家客户端语言自动切换。
核心特性
现代化随身仓库
输入 /ck 即可打开个人仓库，数据按玩家 UUID 独立存储，完全隔离。
大箱子 GUI 交互
固定 6 行布局——5 行存储区 + 底部菜单栏（上一页 / 页码 / 下一页 / 解锁 / 关闭）。支持 Shift 批量存取，锁定格与菜单栏受保护。GUI 标题实时显示当前页码，如 我的随身仓库 (1/5)。
Vault 经济扩容
对接 Vault 经济，第 2 页起花钱解锁（不同页数基础价格可在配置中独立设定），已解锁页面可继续花钱加行；同页连续加行按 row-cost-multiplier 递增。顺序解锁机制：必须先把上一页所有行解锁满，才能解锁下一页。
三种存储后端
默认 SQLite（单文件 data.db，零部署）；可切换为 file（每玩家一个 yml）或 mysql（内置 HikariCP 连接池，连接池参数可调）。sqlite/mysql 初始化失败时自动回退文件存储，数据不丢失；所有读写均异步执行，主线程零阻塞。v1.3.0 起物品序列化改用 NBT 二进制（Base64）格式，完整保留物品 NBT，并兼容旧版 YAML 数据自动迁移。
中英双语言
内置 lang/zh_cn.yml 与 lang/en_us.yml；language: auto 按玩家客户端语言自动选择，也可在配置中强制指定。currency-name 支持自定义货币名与 & 颜色代码。
配置热重载
/ck reload 即时生效，无需重启服务器。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Paper 1.21 – 1.26.2 |
| Java | 21 及以上 |
| 可选依赖 | Vault + 任意经济插件（EssentialsX、CMI 等）——解锁/扩容功能需要 |

> 未安装 Vault 时插件照常运行，仅解锁/扩容功能会提示不可用。
安装方法
下载 PocketInventory-1.3.0.jar
放入服务器的 plugins 文件夹
重启服务器（或使用 PlugMan 等热加载）
生成默认配置后，编辑 plugins/PocketInventory/config.yml
执行 /ck reload 使配置生效

> 升级提醒：从 v1.2.0 及以下升级到 v1.3.0 时，旧版 YAML 格式的仓库数据仍可正常读取，下次保存时会自动转换为新的 NBT 二进制格式，无需手动迁移。建议在升级前备份 plugins/PocketInventory/data/ 目录。
命令与权限

| 命令 | 说明 | 权限 | 默认 |
| --- | --- | --- | --- |
| /ck | 打开随身仓库 | pocketinventory.use | 所有玩家 |
| /ck [页码] | 直接打开指定页面 | pocketinventory.use | 所有玩家 |
| /ck reload | 重载配置与语言文件 | pocketinventory.admin | 仅 OP |

> 命令名与别名可在 config.yml 中自定义，默认主命令 /ck，别名 pocketinventory。
解锁与扩容机制
新玩家默认拥有第 1 页的第 1 行（9 格）
第 2 页及以后需花费金币解锁，解锁成功立即获得该页第 1 行
已解锁页面可继续花费金币增加行数，直至 max-rows 上限
顺序解锁：前置页的所有行必须解锁满，才能解锁下一页
每页价格在 page-prices 中独立配置；同页连续加行按 row-cost-multiplier 递增
从源码构建

mvn clean package

构建产物：target/PocketInventory-1.3.0.jar
近期更新
v1.3.0（2026-08-30）：物品序列化改用 NBT 二进制（Base64），完整保留物品 NBT，修复含 Infinity/NaN 属性修饰值的物品读取报错；兼容旧版 YAML 数据自动迁移
v1.2.0（2026-08-12）：GUI 标题显示当前页码；修复 Shift 批量存取；jar 体积由约 16 MB 缩减至约 7 MB
v1.1.0（2026-08-12）：新增 SQLite/MySQL/File 三种存储后端、全异步 I/O、顺序解锁机制、自定义货币名；支持 MySQL 5.7+