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.