- ✅ Minecraft Java Edition 26.2 (Paper API 26.2)
- ✅ Paper, Purpur, and other Paper forks
- ✅ Java 25 (required by Minecraft 26.x servers)
⚠️ For Minecraft 1.21.x servers, use SmartSort 1.2.1
- Rebuilt for Minecraft 26.2 on the Paper API with Java 25
- Modern chat (Adventure) for messages and update notices
- Tab completion for
/smartsort - New items sorted into the right groups automatically (spears, maces, wind charges, copper gear, horse/wolf armor and more)
- Update checker only reports newer versions built for your server's Minecraft version
- Sorting is limited to real storage: chests, barrels, shulker boxes, ender chests, hoppers, droppers and dispensers. Furnaces, anvils, brewing stands, horse inventories and other plugins' menus (CMI, shops, GUIs) are never touched
allowed-containersin the config now actually works- Identical items always stack together and different items never merge (enchantments, names and custom data are respected)
- Items can no longer be lost while sorting; if anything goes wrong the inventory is put back exactly as it was
- Clicking an empty armor, offhand or crafting slot no longer sorts anything
max-sorting-operations-per-secondnow limits sort spam per playeruse-permissions: falsenow lets everyone sort/smartsort invand/smartsort hotbarwork for players with onlysmartsort.inventory.sort- New
nothing-to-sortandplayers-onlymessages (added to old configs automatically)
- Fixed items randomly rearranging with each sort - Items now sort consistently and stack neatly from left to right
Sort your inventory from anywhere using commands - works in all gamemodes including Creative!
| Command | Alias | Description |
|---|---|---|
/smartsort inv |
/ss inv |
Sort your main inventory |
/smartsort hotbar |
/ss hotbar |
Sort your hotbar |
/smartsort reload |
/ss reload |
Reload configuration |
/smartsort help |
/ss help |
Show help |
Admins now receive clickable links in chat that open directly to the Modrinth download page when updates are available.
- Shift+right-click sorting works in Survival/Adventure mode inventories and all containers (chests, barrels, etc.)
- Creative mode players: Use commands to sort (shift+right-click doesn't work due to Minecraft limitations)
- Shift+Right-Click - Click on an empty slot to sort (Survival/Adventure mode)
- Commands - Use
/ss invor/ss hotbar(all gamemodes)
- Player Inventory: Hotbar and main inventory sort separately
- Containers: Entire container sorts together
- Smart Stacking: Similar items automatically stack together
- Category Sorting: Items organized by type (weapons, tools, armor, food, blocks, etc.)
Players can be given specific permissions for different types of sorting:
smartsort.use- Grants all sorting permissions
smartsort.inventory.sort- Allows sorting player inventory onlysmartsort.containers.sort- Allows sorting ALL container typessmartsort.containers.chest- Allows sorting chests and trapped chestssmartsort.containers.barrel- Allows sorting barrelssmartsort.containers.shulkerbox- Allows sorting shulker boxessmartsort.containers.enderchest- Allows sorting ender chestssmartsort.containers.hopper- Allows sorting hopperssmartsort.containers.dispenser- Allows sorting dispenserssmartsort.containers.dropper- Allows sorting droppers
smartsort.admin- Access to reload command and update notificationssmartsort.*- All permissions
The plugin checks permissions in this order:
smartsort.use(if player has this, they can sort everything - backward compatible)smartsort.containers.sort(grants all container types)smartsort.containers.<type>(specific container type)smartsort.inventory.sort(for player inventory)
Give a player permission to sort only their inventory:
/lp user PlayerName permission set smartsort.inventory.sort true
Give a player permission to sort all containers but not their inventory:
/lp user PlayerName permission set smartsort.containers.sort true
Give a player permission to sort only chests and barrels:
/lp user PlayerName permission set smartsort.containers.chest true
/lp user PlayerName permission set smartsort.containers.barrel true
Give a player permission to sort everything (legacy):
/lp user PlayerName permission set smartsort.use true
Customizable message keys in config.yml:
no-permission- General no permission messageno-permission-container- Shown when player lacks permission for a container typeno-permission-inventory- Shown when player lacks permission to sort inventorysorted-successfully- Shown after successful sortsorting-failed- Shown if sorting failssorting-disabled-world- Shown in disabled worldsplugin-reloaded- Shown after config reload
check-for-updates- Enable/disable update checkerdisabled-worlds- List of worlds where sorting is disabledsorting.stack-items- Enable/disable auto-stackingsorting.alphabetical- Sort alphabetically within categoriessorting.category-order- Customize category priority
- Java 25 (JDK)
- Maven 3.9 or higher
- Internet connection (for downloading dependencies)
mvn clean package
The compiled JAR will be in the target folder.
Every push runs the Build SmartSort workflow (Actions tab). Open the finished run and download SmartSort-jar at the bottom of the page.
- Updated to Minecraft 26.2 / Paper API / Java 25
- Container safety: only real storage containers can be sorted
- Safer stacking and no-item-loss guarantee
- Spam protection, tab completion, Adventure messages
- Fixed items randomly rearranging with each sort
- Added
/smartsort invand/smartsort hotbarcommands - Creative mode now supported via commands
- Clickable update notifications for admins
- Added automatic config updates
- Added Modrinth update checker
- Improved error handling
- Added granular permission system
- Backward compatible with v1.0.0
- Initial release
- Shift+right-click sorting
- Category-based organization
- Java 25 (JDK)
- Maven 3.9 or higher
- Internet connection (for downloading dependencies)