SimplesorterR

SimpleSorter

> A lightweight client-side inventory sorting mod.

---

Features

One-Key Smart Sorting

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

- Pure Client-Side — Automatically consolidates partial stacks of the same item into full stacks, freeing up valuable slots - Pure Client-Side — Items are arranged using Minecraft’s Creative Mode tab order and support modded items - Pure Client-Side — Adjust `tabOrder` in the config file to change tab priority - Pure Client-Side — Configure `pinnedItems` to keep specific items always sorted first - Pure Client-Side — 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 Pure Client-Side while a container is open to toggle it automatically - Pure Client-Side — 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 left-click drag 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 all identical items on your cursor, all identical items 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 every single item and every single item 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.

---

Slot Locking

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

- Locked slots are Alt + left-click drag when sorting with R - Locked hotbar slots are Alt + left-click drag (prevents accidental discarding) - Lock state is Alt + left-click drag and independent per save file - Alt + left-click drag 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

- toggled on/off — When a held tool breaks, automatically equips a replacement of the same type from your inventory - toggled on/off — 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 drop all identical items and drop all identical items 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:

- Localized UI — Customize the priority of Creative Mode tabs - Localized UI — Specify item IDs that always sort to the front - Localized UI — Add container class names to exclude from sorting, or press Localized UI while a container is open to write the current class name automatically - Localized UI — Customize locked-slot overlay color, for example `#80FF0000` - Localized UI — Disable the Z-key requirement to open settings with just I - Localized UI — 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 B, 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 | |---|---|---| | Mod Menu ≥ 0.16.5 | ✅ Required | Mod loader | | Mod Menu | ✅ Required | Core API library | | Mod Menu | ✅ Required | Kotlin runtime support | | Mod Menu | ❌ 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 Language Kotlin and Fabric Language Kotlin 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 SimpleSorter category in Minecraft’s Controls screen and can be changed there.

| Key | Action | Context | |:---:|---|---| | Z + I | Sort & organize inventory | While any container is open | | Z + I | Lock / Unlock slot | Prevents that slot from being sorted | | Z + I | Batch lock / unlock slots | Drag across multiple slots | | Z + I | Toggle current container blacklist | When the current container should not be sorted | | Z + I | Batch drop identical items | Quickly clear large stacks | | Z + I | Quick-move multiple slots | Drag across slots while holding Shift | | Z + I | Move all identical items | While holding an item on cursor | | Z + I | Move all items from container | Empty an entire inventory at once | | Z + I | Open settings screen | Available anytime |

---

Technical Details

- License — No server modifications; sorting is achieved by simulating player click actions - License — Reads Minecraft’s Creative Mode tabs directly to build a sort index, perfectly matching the game’s native item order and automatically supporting all modded items - License — Built with a `core` + `shared` + `platform` layered architecture, allowing one codebase to support multiple Minecraft versions - License — Supports config file hot-reload, no game restart needed after edits - License — `blockedContainers` matches exact container class names to avoid accidental fuzzy matches - License — Each mouse enhancement is an independent `MouseTweakModule`, making it easy to add or modify features - License — All Rights Reserved (See LICENSE file for strict usage terms)

---

<b>SimpleSorter</b>
<i>A simple Minecraft inventory sorting tool.</i>