Sorter's Satchel

Deposit matching inventory items into nearby chests with one crafted satchel.

What it does

Sorter's Satchel is a lightweight Paper plugin that replaces unreliable mob-based sorting with a player-controlled deposit tool.

Craft the satchel, right-click it to open its inventory menu, and press Deposit nearby items. Items from your main inventory are transferred into nearby loaded chests that already contain an exactly matching item.

• Matches complete item data, not only the material.
• Fills existing partial stacks before using empty slots.
• Prefers chests with the most matching occupied slots.
• Continues into another matching chest when the first becomes full.
• Leaves unmatched items and overflow in your inventory.
• Preserves armor, offhand items, the satchel, and—by default—the complete hotbar.
• Searches loaded chunks only; using the satchel never loads distant chunks.
• Requires no client mod or resource pack.

Requirements

• Paper 26.2
• Java 25

Installation

1. Download the latest jar from Releases or a successful Actions build.
2. Place the jar in the server's plugins directory.
3. Restart the server.
4. Craft a Sorter's Satchel.

Crafting recipe

The crafted bundle has a custom name, lore, glow, and persistent identity. Renaming an ordinary bundle does not turn it into a satchel.

Usage

1. Keep the Sorter's Satchel anywhere in your inventory.
2. Right-click it.
3. Click the green Deposit nearby items button.
4. Items with an existing destination stack are deposited immediately.

A destination chest must already contain at least one exactly matching item. Named items, enchantments, potion data, durability, and other components are respected.

Configuration

The configuration is created at plugins/SortersSatchel/config.yml:

# Maximum straight-line distance from the player to a destination chest.
search-radius: 16.0

# Preserve the complete hotbar by default.
include-hotbar: false

messages:
  deposited: "<green>Deposited <amount> items into <chests> nearby chests."
  nothing: "<yellow>No inventory items had matching stacks in nearby chests."
  received: "<green>You received a Sorter's Satchel."

The search radius is limited to 1–64 blocks. Set include-hotbar: true if players should also deposit hotbar items.

Commands and permissions

sortersatchel.use is granted by default. sortersatchel.admin defaults to server operators.

Building

gradle clean build

The compiled jar is written to build/libs/.

License

Sorter's Satchel is available under the MIT License.