BsruEnderChest

# 📦 BsruEnderchest <div align="center"> (https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) (https://img.shields.io/github/stars/Nattapat2871/BsruEnderchest?style=flat-square)](https://github.com/Nattapat2871/BsruEnderchest/stargazers) !(https://api.visitorbadge.io/api/VisitorHit?user=Nattapat2871&repo=BsruEnderchest&countColor=%237B1E7A&style=flat-square) (https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/Nattapat2871) </div> <p align= "center"> <b>English</b> | <a href="/README_TH.md">ภาษาไทย</a> </p> 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 1. Download the latest `.jar` file from the (https://github.com/Nattapat2871/BsruEnderchest/releases) page. 2. Place the `BsruEnderchest-X.X.jar` file into your server's `/plugins` directory. 3. **Optional:** For full functionality, install **(https://luckperms.net/download)** and **(https://dev.bukkit.org/projects/worldguard)**. 4. Start or restart your server. The default configuration files will be generated. 5. Edit `config.yml` to your liking (e.g., enable the database). 6. Start the server again or use `/bsruenderchest reload`. 7. 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`) ```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)" #