Bigger Ender Chests
用更大的自定义 GUI 替换原版末影箱。支持按玩家设定容量、Bukkit 物品序列化、SQL 或 JSON 存储。
⚠ 安装前须知: 本插件使用独立的存储系统,不会自动导入原版末影箱的内容。请在安装前清空原版末影箱并备份服务器数据。

平台支持

要求
- Minecraft: 针对 1.13+ 的 Bukkit API。请查看 可用版本 以获取适合您服务器的版本。
- Java: 请使用您的服务器所需的 Java 版本。该插件针对 Java 8 字节码进行编译,不会覆盖服务器的 Java 要求。
- LuckPerms: 可选。权限通过 Bukkit 进行检查,因此兼容的权限管理器可以分配以下节点。
功能
- 替换原版末影箱 — 右键点击即可打开更大的 GUI,无需命令
- 按玩家设定容量 — 通过权限精确授予所需行数
- Bukkit 物品序列化 — 使用 Bukkit 的
ItemStack.serialize() 格式保存物品数据
- 三种存储后端 — JSON 文件、SQLite 或 MySQL — 选择适合您服务器的方案
- 人类可读的 JSON — 将序列化的物品数据存储在
userdata/ 下的按玩家划分的文件中
- SQLite & MySQL — 内置 SQLite 驱动程序或连接外部 MySQL 服务器
- 重新打开时保留当前箱子内容 — 重用玩家的实时库存,而不是加载旧的存档副本
- 移动即保存 — 点击和拖拽会在服务器处理移动后排队保存
- 权限管理器支持 — 使用 Bukkit 权限节点为每个组或玩家分配箱子大小,包括通过 LuckPerms
- 单一 JAR — 针对 Minecraft 1.13 及更高版本的 Bukkit API
- 合并的移动保存 — 每刻每个箱子最多只排一个移动保存任务
工作原理
BiggerEnderChest 拦截原版末影箱交互,并打开一个更大的自定义 GUI。玩家内容以人类可读的 JSON 文件、SQLite 或 MySQL 形式在重启之间持久化。
当玩家右键点击末影箱时,插件会取消默认行为,并根据玩家的最高权限级别(1-6 行)打开一个相应大小的容器。54 格的 maksimum 匹配双箱以提供最大空间。
每个已连接的玩家都有一个实时的服务器库存。重新打开时会发送一个使用当前内容的窗口,而不是加载旧的存档副本。点击和拖拽会在下一刻调度保存,在移动被处理后进行。关闭、断开连接和禁用插件也会保存箱子内容。
物品通过选定的后端使用 Bukkit 的 ItemStack.serialize() 格式存储。加载失败时拒绝打开空的替换箱,而断开连接保存失败则会将实时库存保留在内存中。在重启之前解决存储错误,因为内存中的副本无法在进程退出后存活。
| 存储方式 |
设置 |
适用场景 |
| JSON |
零配置 — 文件自动放入 userdata/ |
单服务器,易于编辑文件 |
| SQLite |
零配置 — 创建 data.db |
单服务器,无文件杂乱 |
| MySQL |
需要连接配置 |
使用外部数据库的服务器 |
数据库
选择 JSON 文件、本地 SQLite 数据库或外部 MySQL 数据库。JSON 是捆绑配置中的默认选项。
该插件不提供跨服务器锁定,因此共享 MySQL 表并不能确保跨服务器同时访问同一玩家的箱子是安全的。
SQLite(可选本地数据库 — 不需要外部数据库服务器):
storage:
method: sqlite
首次启动时自动创建 plugins/BiggerEnderChest/data.db。
MySQL(外部服务器):
storage:
method: mysql
mysql:
host: your.db.host
port: 3306
database: minecraft
username: db_user
password: "yourpassword"
table: ender_chest_data
LuckPerms 权限
该插件检查 Bukkit 权限。LuckPerms 或其他兼容的权限管理器可以分配这些节点。授予的最高容量权限生效。
大小更改在成功保存后的下次连接时生效。在减小容量之前,请清空要移除的行,因为超出新容量的物品不会被保留。
| 权限 |
默认值 |
描述 |
biggerenderchest.use |
true |
使用箱子命令及其别名 |
biggerenderchest.size.1 |
false |
1 行(9 格) |
biggerenderchest.size.2 |
false |
2 行(18 格) |
biggerenderchest.size.3 |
false |
3 行(27 格) |
biggerenderchest.size.4 |
false |
4 行(36 格) |
biggerenderchest.size.5 |
false |
5 行(45 格) |
biggerenderchest.size.6 |
true |
6 行(54 格) |
biggerenderchest.* |
OP |
所有权限 |
通过 LuckPerms 将玩家的箱子大小设置为三行:
/lp user kevin permission set biggerenderchest.size.6 false
/lp user kevin permission set biggerenderchest.size.3 true
六行节点默认为 true,因此在分配较小的箱子时请明确拒绝它。同时拒绝由组或通配符授予的任何其他更高容量节点。
为组分配大小权限:
/lp group default permission set biggerenderchest.size.6 false
/lp group default permission set biggerenderchest.size.4 true
箱子大小也尊重继承的权限。只需取消设置六行节点即可恢复其默认的 true 值;需要显式设置为 false 才能拒绝该默认值。
命令
| 命令 |
描述 |
/enderchest |
打开末影箱 GUI |
/echest |
打开末影箱 GUI |
/ec |
打开末影箱 GUI |
配置
config.yml
# 更大末影箱的行数(1-6,每行 = 9 个格子)
# 当未授予任何大小权限时使用;size.6 默认为 true。
rows: 6
# GUI 上显示的标题
gui-title: "&8Bigger Ender Chest"
# 命令设置
command:
# 设置为 false 以完全禁用 /enderchest、/echest 和 /ec 命令
enabled: true
# 存储设置
storage:
# 可用方法:json, sqlite, mysql
method: json
# JSON 文件存储设置
json:
# JSON 文件目录(相对于插件文件夹)
folder: userdata
# SQLite 设置(当 method: sqlite 时使用)
sqlite:
# 数据库文件路径(相对于插件文件夹)
file: data.db
# MySQL 设置(当 method: mysql 时使用)
mysql:
host: localhost
port: 3306
database: minecraft
username: root
password: ""
# 用于存储末影箱数据的表名
table: ender_chest_data
文件结构
使用默认的 JSON 存储时,在保存玩家的箱子后,插件文件夹将如下所示:
plugins/BiggerEnderChest/
├── config.yml
└── userdata/
└── (Minecraft User ID).json
选择 SQLite 时,内容存储在 data.db 中。MySQL 则将其存储在配置的外部数据库表中。
支持
本项目由 sqidgeon 维护。未经我们同意,严禁重新分发此插件!
Bigger Ender Chests
Replace vanilla ender chests with a bigger custom GUI. Per-player sizing, Bukkit item serialization, SQL or JSON storage.
⚠ Before installing: This plugin uses separate storage and does not automatically import vanilla ender chest contents. Empty vanilla ender chests before installation and back up your server data.

Platforms

Requirements
- Minecraft: targets the Bukkit API for 1.13+. Check the available versions for your release.
- Java: use the Java version required by your server. The plugin targets Java 8 bytecode, which does not override your server’s Java requirements.
- LuckPerms: optional. Permissions are checked through Bukkit, so compatible permission managers can assign the nodes below.
Features
- Replaces vanilla ender chests — right-click opens a bigger GUI, no commands needed
- Per-player sizing — grant exactly the right number of rows via permissions
- Bukkit item serialization — saves item data using Bukkit’s
ItemStack.serialize() format
- Three storage backends — JSON files, SQLite, or MySQL — pick what fits your server
- Human-readable JSON — stores serialized item data in per-player files under
userdata/
- SQLite & MySQL — built-in SQLite driver or connect to an external MySQL server
- Current chest contents on reopen — reuses the player’s live inventory instead of loading an older saved copy
- Movement saves — clicks and drags queue a save after the server applies the movement
- Permission-manager support — assign chest sizes per group or player using Bukkit permission nodes, including through LuckPerms
- One JAR — targets the Bukkit API for Minecraft 1.13 and newer
- Coalesced movement saves — queues at most one movement-save task per chest per tick
How it works
BiggerEnderChest intercepts vanilla ender chest interactions and opens a larger custom GUI instead. Player contents are persisted across restarts in either human-readable JSON files, SQLite, or MySQL.
When a player right-clicks an ender chest, the plugin cancels the default behaviour and opens an inventory sized to the player's highest permission level (1-6 rows). The 54-slot maximum matches a double chest for maximum space.
Each connected player has one live server inventory. Reopening sends a fresh window using the current contents instead of loading an older saved copy. Clicks and drags schedule a save on the next tick, after the movement is processed. Closing, disconnecting, and disabling the plugin also save chest contents.
Items are stored through the selected backend using Bukkit's ItemStack.serialize() format. A failed load refuses to open an empty replacement chest, and a failed disconnect save keeps the live inventory in memory. Resolve storage errors before restarting, because that in-memory copy does not survive a process exit.
| Storage |
Setup |
Best for |
| JSON |
Zero — drops files in userdata/ |
Single-server, easy file editing |
| SQLite |
Zero — creates data.db |
Single-server, no file clutter |
| MySQL |
Connection config required |
A server using an external database |
Database
Choose JSON files, a local SQLite database, or an external MySQL database. JSON is the default in the bundled configuration.
The plugin does not provide cross-server locking, so sharing a MySQL table does not make simultaneous access to the same player’s chest safe across servers.
SQLite (optional local database — no external database server required):
storage:
method: sqlite
Creates plugins/BiggerEnderChest/data.db automatically on first start.
MySQL (external server):
storage:
method: mysql
mysql:
host: your.db.host
port: 3306
database: minecraft
username: db_user
password: "yourpassword"
table: ender_chest_data
LuckPerms Permissions
The plugin checks Bukkit permissions. LuckPerms or another compatible permission manager can assign these nodes. The highest granted size permission wins.
Size changes take effect on the next connection after a successful save. Empty any rows being removed before reducing the size, because items outside the new size are not retained.
| Permission |
Default |
Description |
biggerenderchest.use |
true |
Use the chest command and its aliases |
biggerenderchest.size.1 |
false |
1 row (9 slots) |
biggerenderchest.size.2 |
false |
2 rows (18 slots) |
biggerenderchest.size.3 |
false |
3 rows (27 slots) |
biggerenderchest.size.4 |
false |
4 rows (36 slots) |
biggerenderchest.size.5 |
false |
5 rows (45 slots) |
biggerenderchest.size.6 |
true |
6 rows (54 slots) |
biggerenderchest.* |
OP |
All permissions |
Set a player's chest size to three rows via LuckPerms:
/lp user kevin permission set biggerenderchest.size.6 false
/lp user kevin permission set biggerenderchest.size.3 true
The six-row node defaults to true, so explicitly deny it when assigning a smaller chest. Deny any other higher size nodes granted by groups or wildcards as well.
Assign a size to a group:
/lp group default permission set biggerenderchest.size.6 false
/lp group default permission set biggerenderchest.size.4 true
Chest size also respects inherited permissions. Simply unsetting the six-row node can restore its default true value; an explicit false is needed to deny that default.
Commands
| Command |
Description |
/enderchest |
Opens enderchest GUI |
/echest |
Opens enderchest GUI |
/ec |
Opens enderchest GUI |
Configuration
config.yml
# Number of rows for the bigger ender chest (1-6, each row = 9 slots)
# Used when no size permission is granted; size.6 defaults to true.
rows: 6
# Title shown on the GUI
gui-title: "&8Bigger Ender Chest"
# Command settings
command:
# Set to false to disable /enderchest, /echest, and /ec commands entirely
enabled: true
# Storage settings
storage:
# Available methods: json, sqlite, mysql
method: json
# JSON file storage settings
json:
# Directory for JSON files (relative to plugin folder)
folder: userdata
# SQLite settings (used when method: sqlite)
sqlite:
# Database file path (relative to plugin folder)
file: data.db
# MySQL settings (used when method: mysql)
mysql:
host: localhost
port: 3306
database: minecraft
username: root
password: ""
# Table name for storing ender chest data
table: ender_chest_data
File Structure
With the default JSON storage, the plugin folder will look like this after a player’s chest is saved:
plugins/BiggerEnderChest/
├── config.yml
└── userdata/
└── (Minecraft User ID).json
With SQLite selected, contents are stored in data.db instead. MySQL stores them in the configured external database table.
Support
This project is maintained by sqidgeon. You are NOT allowed to re-distribute this plugin without consent from us!
评论 0
登录后参与评分
还没有评论,来抢沙发吧