SimplesorterR

SimpleSorterR

A lightweight client-side inventory sorting mod.

Features

One-Key Smart Sorting

Open an inventory or container and press R to sort items.

• Auto Stack Merging — Automatically consolidates partial stacks of the same item into full stacks, freeing up valuable slots
• Creative Tab Native Sorting — Items are arranged using Minecraft’s Creative Mode tab order and support modded items
• Custom Sort Order — Adjust tabOrder in the config file to change tab priority
• Pinned Items — Configure pinnedItems to keep specific items always sorted first
• Dynamic Container Blacklist — All storage containers are sortable by default (including modded containers like Reinforced Chests). Functional containers are excluded by exact class names in blockedContainers; you can also press B while a container is open to toggle it automatically
• No-Screen Main Inventory Sorting — Enable sortInventoryWhenNoScreen to sort the player main inventory with R while no screen is open
• Config Hot-Reload — Edit simplesorter.json directly, changes take effect on the next R-key sort without restarting the game
• Pure Client-Side — Sorting is performed by simulated clicks, so the server does not need the mod

Mouse Tweaks

Shift + Drag to Quick-Move

Hold Shift and left-click drag across multiple slots — every slot you pass over will be instantly quick-moved to the opposite inventory.

Useful when moving many slots at once.

Shift + Double-Click to Move All Same Items

While holding an item on your cursor, Shift + Double-Click on a matching item to instantly quick-move all identical items from that inventory to the other side.

Useful for pulling all matching items out of a chest.

Space + Double-Click to Move Everything

Hold Space and Double-Click any slot in a container to instantly quick-move every single item from that inventory to the opposite side.

Useful for quickly emptying a chest.

V + Double-Click to Deposit Matching Items

Hold V and Double-Click any filled slot in a container to quick-move matching items from the player main inventory into the container, but only when that item already exists in the container.

• Does not move hotbar slots
• Does not move locked slots
• Does not move items that are not already present in the container
• Does not trigger while an item is held on the cursor

Useful for topping up a sorted chest from your main inventory.

Slot Locking

Hold Alt and click any slot to lock it — locked slots display an overlay.

• Locked slots are never moved when sorting with R
• Locked hotbar slots are protected from Q-key drops (prevents accidental discarding)
• Lock state is automatically saved and independent per save file
• Alt + click again to unlock
• Hold Alt + left-click drag to lock or unlock multiple slots in one sweep. The first slot decides whether the drag locks or unlocks
• Overlay color can be customized with lockOverlayColor, supporting both #RRGGBB and #AARRGGBB

Color values use Hex color codes. Both #RRGGBB and #AARRGGBB are supported. The 8-digit format uses ARGB order: AA opacity, RR red, GG green, BB blue. It is not RGBA.

Common AA values: 40 very transparent, 80 half transparent, C0 mostly opaque, FF fully opaque. Examples: #80FF0000 half-transparent red, #8000FF00 half-transparent green, #800000FF half-transparent blue.

Useful for keeping tools in fixed slots and reducing accidental drops.

Auto Replacer

• Tool Break Replacement — When a held tool breaks, automatically equips a replacement of the same type from your inventory
• Stackable Item Refill — When a held stackable item runs out (e.g. placing blocks), automatically refills from your inventory
• Can be toggled on/off in the settings screen

Useful when building or mining with repeated item replacement.

Caps Lock + Double-Click to Batch Drop

Hold Caps Lock and double-click any slot to drop all identical items in that inventory (using the Q-key drop action).

Useful for clearing large quantities of one item.

In-Game Configuration

Press Z + I (default combo) to open a graphical settings panel in-game:

• Tab Sort Order (tabOrder) — Customize the priority of Creative Mode tabs
• Pinned Items (pinnedItems) — Specify item IDs that always sort to the front
• Container Blacklist (blockedContainers) — Add container class names to exclude from sorting, or press B while a container is open to write the current class name automatically
• Lock Overlay Color (lockOverlayColor) — Customize locked-slot overlay color, for example #80FF0000
• No-Screen Sort (sortInventoryWhenNoScreen) — Allow R to sort the player main inventory while no screen is open
• Z-Key Guard Toggle — Disable the Z-key requirement to open settings with just I
• Auto Replacer Toggle — Enable/disable automatic tool and item replacement
• Localized UI — Settings interface automatically adapts to your game language (English / Chinese)

Also accessible from Mod Menu if installed.

Advanced settings can be edited directly in config/simplesorter.json. Changes take effect on the next R-key sort.

⚠️ blockedContainers uses exact class-name matching, not fuzzy matching. Depending on mappings and Minecraft version, class names may look like GenericContainerScreenHandler instead of ChestMenu; the safest workflow is opening the target container and pressing B so the mod writes the correct name for you.

Requirements

| Dependency | Required? | Notes |
|—|—|—|
| Fabric Loader ≥ 0.16.5 | ✅ Required | Mod loader |
| Fabric API | ✅ Required | Core API library |
| Fabric Language Kotlin | ✅ Required | Kotlin runtime support |
| Cloth Config API | ❌ Bundled | Config screen framework (already included in the mod jar) |
| Mod Menu | ❌ Optional | Adds a settings entry in the mod list |

Installation

1. Install Fabric Loader and Fabric API
2. Download Fabric Language Kotlin and place it in your mods folder
3. Pick the jar matching your Minecraft version and drop it into your mods folder
4. Launch the game

Keybind Reference

All keybinds appear under the SimpleSorterR category in Minecraft’s Controls screen and can be changed there.

| Key | Action | Context |
|:—:|—|—|
| R | Sort & organize inventory | While a container is open; can also sort the main inventory with no screen if enabled |
| Alt + Click | Lock / Unlock slot | Prevents that slot from being sorted |
| Alt + Left-Drag | Batch lock / unlock slots | Drag across multiple slots |
| B | Toggle current container blacklist | When the current container should not be sorted |
| Caps Lock + Double-Click | Batch drop identical items | Quickly clear large stacks |
| Shift + Drag | Quick-move multiple slots | Drag across slots while holding Shift |
| Shift + Double-Click | Move all identical items | While holding an item on cursor |
| Space + Double-Click | Move all items from container | Empty an entire inventory at once |
| V + Double-Click | Deposit matching items | Move only items already present in the container from main inventory |
| Z + I | Open settings screen | Available anytime |

SimpleSorterR
A simple Minecraft inventory sorting tool.