- 版权类型
- 原创
- 插件中文名称
- 冰柠仓库
- 插件英文名称
- IceLemon Warehouse
- 支持的核心(服务端)
- Spigot
- Paper
- Purpur
- Leaves
- 语言支持
- 多语言
- 适配版本(Java)
- 最新版本
- 26.x
- 1.21
- 1.20
- 1.19
- 1.18
- 1.17
- 1.16
- 1.15
- 1.14
- 1.13
- 1.12
- 1.11
- 1.10
- 1.9
- 1.8
[MD]# 冰柠仓库 | 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。
- 数据库记录与玩家背包无法进行跨系统原子提交,异常崩溃时存在物品或扩容券状态不一致的风险。
[/MD]