? BsruEnderchest
English | ภาษาไทย
BsruEnderchest 是一款面向 Spigot、Paper 和 Folia 服务器的高性能、高品质的末影箱插件。它在原版末影箱的基础上增加了更多存储空间、多页管理、通过 MySQL 实现跨服同步以及强大的管理工具套件,并致力于保持零卡顿体验。
? 现代支持
-
Minecraft 1.20, 1.21 和 26.1.x (2026 Drops)
-
Java 21 至 Java 25+
-
原生 Folia 支持
-
Adventure Component API 集成
-
扩展存储: 将默认末影箱扩展至完整的 6 行(54 个格子)。
-
分页系统: 根据权限为玩家提供多个存储页面的访问权限。
-
兼容 Folia: 该插件设计为可在 Paper/Spigot 和 Folia 服务器上通过单个 JAR 文件原生运行。
-
两种存储模式:
- File(文件): 简单的本地文件存储,无需额外设置(
playerdata/*.yml)。
- MySQL: 集中式数据库存储,用于实现完整的跨服物品同步。
-
异步操作: 所有数据操作(加载/保存)均在后台线程运行,以防止任何服务器卡顿或冻结。
-
数据压缩: 物品数据在保存到数据库前会使用 GZIP 进行压缩,显著减少存储空间和网络流量。
-
智能数据迁移: 当玩家权限升级时,自动且安全地将玩家的物品从单页模式迁移到多页模式,防止任何数据丢失。
-
管理员错误通知: 关键的数据库错误会直接发送给拥有正确权限的在线管理员,而非普通玩家。
-
WorldGuard 集成: 在 item-drop 标志被禁止的区域中,阻止玩家从末影箱 GUI 中掉落物品。
-
高度可配置: 通过清晰的 config.yml 自定义 UI 元素、消息、标题和音效。
? 安装
- 从 Releases 页面下载最新的
.jar 文件。
- 将
BsruEnderchest-X.X.jar 文件放入服务器的 /plugins 目录中。
- 可选: 如需完整功能,请安装 LuckPerms 和 WorldGuard。
- 启动或重启服务器。默认配置文件将被生成。
- 根据需要编辑
config.yml(例如启用数据库)。
- 再次启动服务器或使用
/bsruenderchest reload 命令。
- 为您的玩家和组配置权限。
⚙️ 命令
| Command |
Alias |
Permission |
Description |
/enderchest |
/ec |
bsruenderchest.command.use |
打开您个人的末影箱。 |
/bsruenderchest |
/bec |
(none) |
显示插件信息。 |
/bsruenderchest reload |
/bec reload |
bsruenderchest.admin.reload |
重新加载插件的配置文件。 |
/bsruenderchest chestsee <player> |
/bec chestsee <player> |
bsruenderchest.admin.chestsee |
打开其他玩家的末影箱。 |
? 权限
| Permission |
Description |
Default |
bsruenderchest.use |
允许通过点击方块来打开末影箱。 |
true (所有人) |
bsruenderchest.command.use |
允许使用 /enderchest 命令。 |
true (所有人) |
bsruenderchest.plus.<number> |
授予访问 <number> 页存储的权限(最多 10 页)。 |
op |
bsruenderchest.admin.reload |
允许使用 /bec reload 命令。 |
op |
bsruenderchest.admin.chestsee |
允许使用 /bec chestsee <player> 命令。 |
op |
bsruenderchest.admin.notify |
接收有关数据库连接错误的游戏内警报。 |
op |
? 配置 (config.yml)
# BsruEnderchest Final Version Configuration
# ---------------------------------
# Database Settings
# ---------------------------------
# Set to true to enable the MySQL database system (for cross-server data)
# If false, the plugin will store data in local files under the playerdata folder.
database:
enable: false
host: "localhost"
port: 3306
database: "bsru_enderchest"
username: "user"
password: "password"
# ---------------------------------
# Inventory Titles
# ---------------------------------
# Title format for the paged inventory. Placeholders: {current_page}, {max_pages}
inventory-title-format: "&5&lEnder Chest &8(&fPage {current_page}/{max_pages}&8)"
# Title for players who only have the .use permission (full 6-row mode)
single-page-title: "&5&lEnder Chest (6 Rows)"
# Title format for the admin view. Placeholders: {player_name}, {current_page}, {max_pages}
admin-inventory-title-format: "&c&lAdmin View: {player_name} &8(&fPage {current_page}/{max_pages}&8)"
# Title format for the admin view when viewing a single-page user. Placeholder: {player_name}
admin-single-page-title: "&c&lAdmin View: &e{player_name} &8(6 Rows)"
---------------------------------
消息
---------------------------------
玩家没有命令权限时发送的消息。
no-permission-command-message: "&c你没有权限使用此命令。"
数据库无法加载玩家数据时发送给玩家的消息。
player-database-error-message: "&c[Enderchest] 系统暂时不可用,请稍后重试。"
发生数据库错误时发送给在线管理员的警告。
admin-database-error-message: "&c&l[BSRU Enderchest] &c严重:数据库连接失败!请立即检查控制台。"
玩家尝试在受保护的 WorldGuard 区域丢弃物品时发送的消息。
worldguard-drop-deny-message: "&c你不能在此区域丢弃物品。"
---------------------------------
控制面板项目(用于分页模式)
---------------------------------
control-panel:
previous-page:
enabled:
material: "MAGMA_CREAM"
name: "&a&l上一页"
lore:
- "&7点击跳转到第 &e{previous_page} 页"
disabled:
material: "BARRIER"
name: "&c&l第一页"
lore:
- "&7你已在第一页。"
next-page:
enabled:
material: "ARROW"
name: "&a&l下一页"
lore:
- "&7点击跳转到第 &e{next_page} 页"
disabled:
material: "BARRIER"
name: "&c&l最后一页"
lore:
- "&7你已在最后一页。"
filler:
material: "GRAY_STAINED_GLASS_PANE"
name: " "
---------------------------------
音效
---------------------------------
name: Minecraft 中的声音键(例如 ui.button.click)
volume: 音量大小(例如 1.0)
pitch: 音调高低(例如 1.0)
sounds:
navigate:
name: "ui.button.click"
volume: 0.8
pitch: 1.2
fail:
name: "block.anvil.place"
volume: 1.0
pitch: 1.0
worldguard-deny:
name: "entity.villager.no"
volume: 1.0
pitch: 0.8
## ? 许可证
本项目采用 MIT 许可证授权。详细信息请参阅 [LICENSE](https://github.com/Nattapat2871/BsruEnderchest/blob/main/LICENSE) 文件。
? BsruEnderchest
English | ภาษาไทย
BsruEnderchest is a premium, high-performance Ender Chest plugin for Spigot, Paper, and Folia servers. It enhances the vanilla Ender Chest with more storage, multiple pages, cross-server synchronization via MySQL, and a powerful suite of admin tools, all designed to be lag-free.
? Modern Support
-
Minecraft 1.20, 1.21, and 26.1.x (2026 Drops)
-
Java 21 to Java 25+
-
Native Folia Support
-
Adventure Component API Integration
-
Expanded Storage: Expands the default Ender Chest to a full 6 rows (54 slots).
-
Paged System: Grant players access to multiple pages of storage based on permissions.
-
Folia Compatible: The plugin is designed to run natively on both Paper/Spigot and Folia servers with a single JAR file.
-
Two Storage Modes:
- File: Simple, no-setup-required local file storage (
playerdata/*.yml).
- MySQL: Centralized database storage for full cross-server inventory synchronization.
-
Asynchronous Operations: All data operations (load/save) run on a background thread to prevent any server lag or freezes.
-
Data Compression: Item data is compressed using GZIP before being saved to the database, significantly reducing storage space and network traffic.
-
Smart Data Migration: Automatically and safely migrates a player's items from the single-page mode to the multi-page mode when their permissions are upgraded, preventing any data loss.
-
Admin Error Notifications: Critical database errors are sent directly to online admins with the correct permission, not to regular players.
-
WorldGuard Integration: Prevents players from dropping items from the Ender Chest GUI in regions where the item-drop flag is denied.
-
Highly Configurable: Customize UI elements, messages, titles, and sounds via a clean config.yml.
? Installation
- Download the latest
.jar file from the Releases page.
- Place the
BsruEnderchest-X.X.jar file into your server's /plugins directory.
- Optional: For full functionality, install LuckPerms and WorldGuard.
- Start or restart your server. The default configuration files will be generated.
- Edit
config.yml to your liking (e.g., enable the database).
- Start the server again or use
/bsruenderchest reload.
- Configure permissions for your players and groups.
⚙️ Commands
| Command |
Alias |
Permission |
Description |
/enderchest |
/ec |
bsruenderchest.command.use |
Opens your personal Ender Chest. |
/bsruenderchest |
/bec |
(none) |
Displays plugin information. |
/bsruenderchest reload |
/bec reload |
bsruenderchest.admin.reload |
Reloads the plugin's configuration file. |
/bsruenderchest chestsee <player> |
/bec chestsee <player> |
bsruenderchest.admin.chestsee |
Opens another player's Ender Chest. |
? Permissions
| Permission |
Description |
Default |
bsruenderchest.use |
Allows opening the Ender Chest by clicking the block. |
true (everyone) |
bsruenderchest.command.use |
Allows using the /enderchest command. |
true (everyone) |
bsruenderchest.plus.<number> |
Grants access to <number> pages of storage (up to 10). |
op |
bsruenderchest.admin.reload |
Allows use of the /bec reload command. |
op |
bsruenderchest.admin.chestsee |
Allows use of the /bec chestsee <player> command. |
op |
bsruenderchest.admin.notify |
Receives in-game alerts for database connection errors. |
op |
? Configuration (config.yml)
# BsruEnderchest Final Version Configuration
# ---------------------------------
# Database Settings
# ---------------------------------
# Set to true to enable the MySQL database system (for cross-server data)
# If false, the plugin will store data in local files under the playerdata folder.
database:
enable: false
host: "localhost"
port: 3306
database: "bsru_enderchest"
username: "user"
password: "password"
# ---------------------------------
# Inventory Titles
# ---------------------------------
# Title format for the paged inventory. Placeholders: {current_page}, {max_pages}
inventory-title-format: "&5&lEnder Chest &8(&fPage {current_page}/{max_pages}&8)"
# Title for players who only have the .use permission (full 6-row mode)
single-page-title: "&5&lEnder Chest (6 Rows)"
# Title format for the admin view. Placeholders: {player_name}, {current_page}, {max_pages}
admin-inventory-title-format: "&c&lAdmin View: {player_name} &8(&fPage {current_page}/{max_pages}&8)"
# Title format for the admin view when viewing a single-page user. Placeholder: {player_name}
admin-single-page-title: "&c&lAdmin View: &e{player_name} &8(6 Rows)"
# ---------------------------------
# Messages
# ---------------------------------
# Message sent when a player lacks permission for a command.
no-permission-command-message: "&cYou don't have permission to use this command."
# Message sent to a player when the database fails to load their data.
player-database-error-message: "&c[Enderchest] The system is temporarily unavailable. Please try again later."
# Alert sent to online admins when a database error occurs.
admin-database-error-message: "&c&l[BSRU Enderchest] &cCRITICAL: Database connection failed! Please check the console immediately."
# Message sent when a player tries to drop an item in a protected WorldGuard region.
worldguard-drop-deny-message: "&cYou cannot drop items in this area."
# ---------------------------------
# Control Panel Items (for paged mode)
# ---------------------------------
control-panel:
previous-page:
enabled:
material: "MAGMA_CREAM"
name: "&a&lPrevious Page"
lore:
- "&7Click to go to page &e{previous_page}"
disabled:
material: "BARRIER"
name: "&c&lFirst Page"
lore:
- "&7You are on the first page."
next-page:
enabled:
material: "ARROW"
name: "&a&lNext Page"
lore:
- "&7Click to go to page &e{next_page}"
disabled:
material: "BARRIER"
name: "&c&lLast Page"
lore:
- "&7You are on the last page."
filler:
material: "GRAY_STAINED_GLASS_PANE"
name: " "
# ---------------------------------
# Sounds
# ---------------------------------
# name: Sound key from Minecraft (e.g., ui.button.click)
# volume: How loud the sound is (e.g., 1.0)
# pitch: How high or low the sound is (e.g., 1.0)
sounds:
navigate:
name: "ui.button.click"
volume: 0.8
pitch: 1.2
fail:
name: "block.anvil.place"
volume: 1.0
pitch: 1.0
worldguard-deny:
name: "entity.villager.no"
volume: 1.0
pitch: 0.8
? License
This project is licensed under the MIT License. See the LICENSE file for details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧