Minecraft plugin ChestSort

🔌 About ChestSort

ChestSort — is a plugin for Minecraft servers that allows automatic and manual sorting of chests, barrels, shulker boxes and player inventories.

🎯 Purpose

ChestSort solves inventory‑management friction on multiplayer Minecraft servers by providing reliable sorting (categories, alphabetical, stacking) via commands and hotkeys. It targets Spigot/Paper based servers where players or admins want quick, lossless organization of storage.

⚙ Main features

• Automatic sorting of chests, barrels, shulker boxes, ender chests, minecart chests and player inventories. ()
• Sort by category and/or alphabetically; stackable items are merged where possible. ()
• Player commands and toggles for automatic sorting and inventory sorting. ()
• Hotkeys for quick sorting and chest fill/empty actions (middle‑click, double‑click, shift‑click etc.; configurable). ()
• API for other plugins to call ChestSort’s sorting routines. ()

🧩 Who it's for

• Survival and semi‑vanilla servers wanting QoL improvements.
• Servers with many storage containers (factions, towns, economy servers).
• Developers wanting to integrate advanced sorting via ChestSort API. ()

🏗 Usage examples

• Players double‑click an empty slot to sort a chest quickly.
• Admins enable automatic sorting for users and let ChestSort manage order by category.
• Plugin developers call the ChestSort API to sort custom inventories from other plugins. ()

⚡ Key notes

• ChestSort is designed to avoid item loss or duplication; the author states sorting is extremely fast and safe. ()
• The sorting algorithm is optimized for Minecraft 1.13+; the Spigot resource lists tested versions up to 1.21. ()

⌨️ Commands

Notes: The command names /sort, /chestsort, /invsort and /isort and the permissions chestsort.use and chestsort.use.inventory are documented by the developer. Additional granular permission nodes exist in the config; consult the shipped config.yml for the full list. ()

🔐 Permissions

If you don't want to use a permissions plugin, ChestSort can be configured (use‑permissions option) to allow all players to use sorting. ()

⚙ Installation

📥 Install

• Download the plugin .jar from the official resource (Spigot/GitHub). ()
• Place the .jar into your server's plugins/ folder.
• Fully restart the server (do not use /reload).

📦 Dependencies

• No mandatory dependencies required to run basic features.
• Optional hooks: ChestSort can integrate with certain 3rd‑party plugins (CrackShot, InventoryPages, backpack/shulker plugins) to better handle custom items/backpacks. ()
• ChestSort includes bStats metrics (can be disabled via bStats config). ()

🧾 Configuration

• ChestSort auto‑generates a config.yml on first run and updates it on plugin updates while attempting to keep user changes. ()
• The plugin exposes many options for sorting rules, hotkeys and per‑player settings in config/category files and supports translations via messages in the config. ()
• Database support (MySQL/SQLite): Not documented in official sources — ChestSort is inventory‑based and no DB requirement is indicated. If DB support exists for any optional features, it is not present in primary documentation. ()

🧠 Additional information

Known conflicts / limitations

• ChestSort will only sort containers a player can access; protection plugins that cancel InventoryOpenEvent (e.g., WorldGuard protections) will prevent sorting. Spectator and Adventure modes are excluded. ()
• GUI inventories from other plugins may require explicit support; ChestSort tries to detect GUIs but may need updates for some custom plugins. ()

API & developer notes

• ChestSort exposes an API so other plugins can sort arbitrary Inventory instances using ChestSort's grouping rules. See the repository for API usage details. ()

Telemetry / bStats

• ChestSort uses bStats for metrics by default; users may opt out by editing the bStats config. ()

Support channels

• Official support and issue tracker: GitHub repository and the Spigot resource thread. Official site and Discord are referenced by the author (see project pages). ()

❓ FAQ

Q1: Will ChestSort duplicate or lose items? A1: The author states the sorting method is safe and avoids duplication/loss; sorting is implemented by copying and resorting inventories quickly. Test on staging servers before wide deployment. ()

Q2: Does ChestSort support proxies like BungeeCord / Velocity? A2: Sorting requires InventoryCloseEvent and per‑server inventory access; multi‑server proxy setups may need additional testing. Official docs don’t guarantee cross‑proxy behavior. ()

Q3: How to disable bStats? A3: Disable bStats via the plugins/bstats/config.yml as usual; ChestSort respects the bStats setup. ()

Q4: Where are full permission nodes? A4: Full permission nodes (more granular nodes) are listed in the shipped config.yml / documentation in the repository. Check the plugin config or GitHub for details. ()

When adding ChestSort to your server, test hotkeys and protection interactions on a staging instance. ChestSort is a practical spigot plugin for improving storage management without introducing heavy load on your Minecraft server. ()