Sueta

CoreChestsort [1.21 - 26.2]

1.0.7

CoreChestsort is a simple and lightweight chest & inventory sorting plugin for Spigot/Paper servers.

·Plugin

CoreChestsort – Lightweight Chest & Inventory Sorting (GUI + Hotkeys)
CoreChestsort is a lightweight yet powerful chest and inventory sorting plugin for Spigot, Paper and Purpur servers.

It features a configurable category-based sorting system, per-player GUI controls, automatic sorting and hotkeys for quickly sorting or transferring items.

CoreChestsort also respects popular protection plugins and safely supports block containers, Chest Boats and Chest Minecarts.

✅ Features

  • Chest and container sorting
    • Chests
    • Copper Chests
    • Barrels
    • Shulker Boxes
    • Chest Boats
    • Chest Minecarts
  • Safe container filtering
    • Functional inventories such as Furnaces, Hoppers, Droppers and Dispensers are never auto-sorted
    • Hopper Minecarts are excluded
    • Ender Chests can still be sorted manually using hotkeys
  • Inventory sorting
    • /invsort sorts the main inventory only and keeps the hotbar untouched
    • /invsort hotbar sorts the hotbar only
    • Armor and offhand slots are never modified
  • Advanced Category System
    • Fully configurable category-based sorting
    • Structured 900–999 category layout
    • Custom category .txt files
    • Wildcard support (*_log, *_sword, etc.)
    • Bukkit tag support (for example tag:logs)
    • Optional sticky category ordering
    • Configurable sorting method
    • Future-proof handling of new Minecraft materials
    • Unknown materials are safely ignored on older server versions
  • Player GUI
    • Toggle automatic container sorting
    • Toggle automatic inventory sorting
    • Enable or disable individual hotkeys per player
  • Configurable Hotkeys
    • Sort containers without typing commands
    • Sort the main inventory or hotbar using clicks
    • Transfer matching items into or out of containers
    • Transfer all items into or out of containers
    • Works with supported block containers, Chest Boats and Chest Minecarts
  • Accurate Item Matching
    • Matching transfers compare complete item data
    • Enchantments, lore and durability are respected
    • Potion data and display names are respected
    • Custom model data and persistent custom data are respected
    • Different item variants are no longer incorrectly treated as identical
  • Protection Support
    • Supports Lands, GriefPrevention, WorldGuard, Towny and PlotSquared
    • Container sorting and transfer actions are blocked when access is denied
    • PlotSquared checks the actual container location
    • Multiple installed protection plugins can be checked together
  • Reliable Player Data
    • Player preferences are saved automatically
    • Data is saved periodically, when players leave and during shutdown
    • Atomic file replacement reduces the risk of players.yml corruption
    • No database required
  • Multi-language
    • Included English and Dutch messages
    • messagesEN.yml / messagesNL.yml
    • Switch language through config.yml
    • All messages are customizable
  • Update Friendly
    • New configuration defaults are added automatically
    • Existing players.yml data remains compatible
    • Custom category files are never overwritten
    • No permission or data migration is required

✅ Supported Versions

  • Server software: Spigot / Paper / Purpur
  • Minecraft versions: 1.21+, including the 26.1 / 26.2 releases
  • Built directly against the Spigot API to prevent accidental Paper-only dependencies

Commands

Commands

Chest and container sorting

  • /sort or /chestsort – Open the settings GUI
  • /sort on|off|toggle – Enable or disable automatic container sorting
  • /sort hotkeys – Open the hotkeys GUI
  • /sort reload – Reload config, messages, category files and sorting method
  • /sort help – Show help

Inventory sorting

  • /invsort or /isort – Sort the main inventory only
  • /invsort hotbar – Sort the hotbar only
  • /invsort on|off|toggle – Enable or disable automatic inventory sorting
  • /invsort help – Show help

Permissions
CoreChestsort supports permissions, but permission checks can be disabled in config.yml if everyone should have access.

Permissions

Main permissions

  • chestsort.use – Allows container sorting, container hotkeys, transfers and /sort
  • chestsort.use.inventory – Allows inventory sorting and /invsort
  • chestsort.reload – Allows /sort reload

No permissions plugin?
Set the following in config.yml:

use-permissions: false

⌨️ Hotkeys (Configurable)
Hotkeys can be enabled or disabled globally in config.yml. Players can also toggle every hotkey individually through /sort hotkeys.

Hotkeys

Available actions include:

  • Sort an opened container
  • Sort the main inventory
  • Sort the hotbar
  • Move matching items into a container
  • Move all items into a container
  • Take matching items from a container
  • Take all items from a container

Supported actions depend on the configured click type and the inventory currently opened.

⚠️ Note: Middle click may not be detected reliably on some newer client versions because of client-side behavior.

Language

Language

Set the language in config.yml:

language: EN

Available languages:

  • EN → messagesEN.yml
  • NL → messagesNL.yml

Apply changes using:

/sort reload

A full server restart also works.

Category System

Categories

Category files are stored in:

plugins/CoreChestsort/categories/

Features:

  • Exact material names
  • Wildcard patterns
  • Bukkit material tags
  • Numeric category priorities
  • Optional sticky ordering
  • Custom category directory support

Example rules:

diamond_sword
*_log
*_wool
tag:logs

Custom category files can be added without modifying the included defaults.

Updating the 26.1 / 26.2 default categories

Existing installations can regenerate the latest Stone and Plant defaults by deleting only:

  • 970-stone.default.txt
  • 980-plants.default.txt

Restart the server afterward. Custom category files remain untouched.

Installation

Installation
  1. Download CoreChestsort
  2. Place the jar inside the plugins/ directory
  3. Start the server
  4. Configure config.yml, messages and optional category files
  5. Use /sort reload or restart the server after making changes

Updating from an older version

  1. Stop the server cleanly
  2. Replace the existing CoreChestsort jar
  3. Keep config.yml, players.yml, message files and category files
  4. Start the server

No data migration is required.

✅ Recommended Setup
To include the hotbar when transferring items into containers:

sorting:
  ignore-hotbar-on-transfer: false

Player preferences are saved every 10 seconds by default:

storage:
  save-interval-seconds: 10

Demo server

play.corecraft.nl

Issues / Suggestions / Support
If you find a bug or want to suggest a feature, please include:

  • Server software and version
  • Minecraft version
  • CoreChestsort version
  • Plugin list, especially installed protection plugins
  • Relevant console errors
  • Steps to reproduce the issue

You can also join my Discord.

Similar projects

Plugin →