冰柠仓库 | IceLemon Warehouse

一款支持仓库等级升级的 Minecraft Java 服务器插件。玩家可以通过 GUI 管理个人仓库，使用扩容券逐级扩展储物空间。

功能特点

• 等级扩容：1 级解锁 27 格，每升一级增加一行，也就是 9 格。
• 分页仓库：容量超过单页范围后自动分页，最高等级可配置。
• 图形界面：提供仓库面板与升级界面，采用深色、冰蓝与金色的奇幻 RPG 风格。
• 扩容券：管理员可发放升级道具，升级消耗数量可按目标等级配置。
• 多语言：内置简体中文和英文，也支持添加自定义语言文件。
• PlaceholderAPI：提供仓库等级、总容量、已用格、剩余格、页数和等级上限占位符。
• LuckPerms 兼容：使用 Bukkit 标准权限节点，可通过 LuckPerms 管理仓库使用权限、升级权限和等级上限。
• 双存储后端：支持 SQLite 和 MySQL，可在配置中选择。

兼容版本

插件提供三个构建包，请根据服务器版本选择一个安装：

• IceLemonWarehouse_1.8.8-1.12.2.jar：Spigot/Paper 1.8.8–1.12.2
• IceLemonWarehouse_1.13-1.21.11.jar：Spigot/Paper 1.13–1.21.11
• IceLemonWarehouse_26.1-26.3.jar：Spigot/Paper 26.1–26.3

每台服务器只安装一个对应版本的 JAR。Folia 和模组混合服务端暂不支持。兼容范围是构建目标，尚未对每个服务端版本逐一进行实服测试。

命令

命令	说明
/warehouse 或 /ilw	打开个人仓库
/warehouse upgrade	打开仓库升级界面
/warehouse info	查看等级、容量和已用格
/warehouse lang zh_CN	切换简体中文
/warehouse lang en_US	切换英文
/warehouse give <玩家> <数量>	管理员发放扩容券
/warehouse setlevel <玩家> <等级>	管理员提高在线玩家的仓库等级
/warehouse reload	重载语言与玩法配置

权限节点

权限	说明	默认值
icelemonwarehouse.use	使用仓库	所有人
icelemonwarehouse.upgrade	升级仓库	所有人
icelemonwarehouse.admin	使用管理命令	OP
icelemonwarehouse.maxlevel.<等级>	设置玩家可升级到的最高等级	未设置时使用配置上限

PlaceholderAPI 占位符

• %warehouse_level%
• %warehouse_capacity%
• %warehouse_used_slots%
• %warehouse_free_slots%
• %warehouse_pages%
• %warehouse_max_level%

需要安装 PlaceholderAPI 才能使用占位符。未安装时，仓库主体功能仍可运行。

安装说明

1. 根据服务器版本选择一个 JAR，放入 plugins 目录。
2. 启动服务器，让插件生成默认配置和语言文件。
3. 默认使用 SQLite；如需 MySQL，在配置中填写数据库连接信息并重启服务器。
4. 根据服务器需求调整仓库等级上限、扩容券消耗和语言配置。

切换存储后端不会自动迁移数据。使用前请备份数据库、玩家数据及扩容券签名密钥。

注意事项

• 当前版本使用同步数据库保存，数据库响应慢时可能短暂影响服务器 tick。
• 数据库记录与玩家背包无法进行跨系统原子提交，异常崩溃时存在物品或扩容券状态不一致的风险。