Updated for Minecraft Paper Servers 26.1.2

InventorySortListener.java Sound.UI_BUTTON_CLICK → Sound.UI_LOOM_SELECT_PATTERN (UI_BUTTON_CLICK was removed in 1.21.x)

isPlayerInventoryView() rewritten Old: fragile string hacks (.name().contains("CRAFTING")) New: clean InventoryType enum comparison

instanceof Player guard added to onInventoryClick (event.getWhoClicked() can theoretically be non-Player) buildItemComparator() — added null-check on meta.displayName() (displayName() can return null in 1.21.4 if not explicitly set) PlainTextComponentSerializer import made explicit (top-level import)

SortCooldownManager.java BukkitTask field added to hold cleanupTask reference cleanup() now cancels the task cleanly before clearing maps startCleanupTask() stores return value in cleanupTask field

plugin.yml version bumped to 1.2.0 to reflect the update

Updated InventorySortListener to improve item stacking and sorting functionality, including handling of filled maps and action bar messages.

📦 InventoryAutoSort

A lightweight, hotbar-safe inventory sorting plugin for Minecraft Paper servers. Sort and stack your entire backpack with a simple double right-click on any empty slot — no commands, no hassle.

✨ Features

🖱️ Double right-click any empty inventory slot to sort
📚 Auto-stacks duplicate items before sorting
🔒 Hotbar preserved — slots 0-8 are never touched
🎒 Container support — sorts chests, barrels, and other containers
⏱️ Sort cooldown — prevents spam sorting
🔕 Toggle support — players can disable sorting for themselves
🧺 Bundle compatible — right-clicking with a bundle works normally
⚡ Lightweight — no dependencies, no database, no config bloat

🎮 How To Use

Open your inventory
Right-click an empty slot once (you'll hear a click sound)
Right-click the same empty slot again quickly
✅ Your backpack is now sorted and stacked!

Your hotbar is always safe and will never be reordered.

🔧 Installation

Download the latest .jar from Releases
Drop it into your server's /plugins folder
Restart your server
That's it — no configuration needed!

🔑 Permissions

inventoryautosort.use
Allows a player to use inventory sorting true

🗂️ Sorting Behavior

    Player inventory: Sorts backpack (slots 9-35) only
    Hotbar (slots 0-8): Never touched
    Chest / Barrel / Container: Entire container is sorted
    Duplicate item stacks: Merged before sorting
    Named / enchanted items: Only merged with identical copies
    Bundles on cursor: Right-click works normally