# SimpleSorter<\/p>\n
> A lightweight client-side inventory sorting mod.<\/p>\n
—<\/p>\n
## Features<\/p>\n
### One-Key Smart Sorting<\/p>\n
Open an inventory or container and press **R** to sort items.<\/p>\n
– **Auto Stack Merging** \u2014 Automatically consolidates partial stacks of the same item into full stacks, freeing up valuable slots
\n– **Creative Tab Native Sorting** \u2014 Items are arranged using Minecraft\u2019s Creative Mode tab order and support modded items
\n– **Custom Sort Order** \u2014 Adjust `tabOrder` in the config file to change tab priority
\n– **Pinned Items** \u2014 Configure `pinnedItems` to keep specific items always sorted first
\n– **Dynamic Container Blacklist** \u2014 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
\n– **Config Hot-Reload** \u2014 Edit `simplesorter.json` directly, changes take effect on the next R-key sort without restarting the game
\n– **Pure Client-Side** \u2014 Sorting is performed by simulated clicks, so the server does not need the mod<\/p>\n
—<\/p>\n
### Mouse Tweaks<\/p>\n
#### Shift + Drag to Quick-Move<\/p>\n
Hold **Shift** and **left-click drag** across multiple slots \u2014 every slot you pass over will be instantly quick-moved to the opposite inventory.<\/p>\n
> Useful when moving many slots at once.<\/p>\n
#### Shift + Double-Click to Move All Same Items<\/p>\n
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.<\/p>\n
> Useful for pulling all matching items out of a chest.<\/p>\n
#### Space + Double-Click to Move Everything<\/p>\n
Hold **Space** and **Double-Click** any slot in a container to instantly quick-move **every single item** from that inventory to the opposite side.<\/p>\n
> Useful for quickly emptying a chest.<\/p>\n
—<\/p>\n
### Slot Locking<\/p>\n
Hold **Alt** and **click** any slot to **lock** it \u2014 locked slots display an overlay.<\/p>\n
– Locked slots are **never moved** when sorting with R
\n– Locked hotbar slots are **protected from Q-key drops** (prevents accidental discarding)
\n– Lock state is **automatically saved** and independent per save file
\n– **Alt + click** again to unlock
\n– Hold **Alt + left-click drag** to lock or unlock multiple slots in one sweep. The first slot decides whether the drag locks or unlocks
\n– Overlay color can be customized with `lockOverlayColor`, supporting both `#RRGGBB` and `#AARRGGBB`<\/p>\n
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`.<\/p>\n
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.<\/p>\n
> Useful for keeping tools in fixed slots and reducing accidental drops.<\/p>\n
—<\/p>\n
### Auto Replacer<\/p>\n
– **Tool Break Replacement** \u2014 When a held tool breaks, automatically equips a replacement of the same type from your inventory
\n– **Stackable Item Refill** \u2014 When a held stackable item runs out (e.g. placing blocks), automatically refills from your inventory
\n– Can be **toggled on\/off** in the settings screen<\/p>\n
> Useful when building or mining with repeated item replacement.<\/p>\n
—<\/p>\n
### Caps Lock + Double-Click to Batch Drop<\/p>\n
Hold **Caps Lock** and **double-click** any slot to **drop all identical items** in that inventory (using the Q-key drop action).<\/p>\n
> Useful for clearing large quantities of one item.<\/p>\n
—<\/p>\n
### In-Game Configuration<\/p>\n
Press **Z + I** (default combo) to open a graphical settings panel in-game:<\/p>\n
– **Tab Sort Order (tabOrder)** \u2014 Customize the priority of Creative Mode tabs
\n– **Pinned Items (pinnedItems)** \u2014 Specify item IDs that always sort to the front
\n– **Container Blacklist (blockedContainers)** \u2014 Add container class names to exclude from sorting, or press **B** while a container is open to write the current class name automatically
\n– **Lock Overlay Color (lockOverlayColor)** \u2014 Customize locked-slot overlay color, for example `#80FF0000`
\n– **Z-Key Guard Toggle** \u2014 Disable the Z-key requirement to open settings with just I
\n– **Auto Replacer Toggle** \u2014 Enable\/disable automatic tool and item replacement
\n– **Localized UI** \u2014 Settings interface automatically adapts to your game language (English \/ Chinese)<\/p>\n
Also accessible from **Mod Menu** if installed.<\/p>\n
> Advanced settings can be edited directly in `config\/simplesorter.json`. Changes take effect on the next R-key sort.<\/p>\n
> \u26a0\ufe0f `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.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| Dependency | Required? | Notes |
\n|—|—|—|
\n| **Fabric Loader** \u2265 0.16.5 | \u2705 Required | Mod loader |
\n| **Fabric API** | \u2705 Required | Core API library |
\n| **Fabric Language Kotlin** | \u2705 Required | Kotlin runtime support |
\n| **Cloth Config API** | \u274c Bundled | Config screen framework (already included in the mod jar) |
\n| **Mod Menu** | \u274c Optional | Adds a settings entry in the mod list |<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Install **Fabric Loader** and **Fabric API**
\n2. Download **Fabric Language Kotlin** and place it in your `mods` folder
\n3. Pick the jar matching your Minecraft version and drop it into your `mods` folder
\n4. Launch the game<\/p>\n
—<\/p>\n
## Keybind Reference<\/p>\n
All keybinds appear under the **SimpleSorter** category in Minecraft\u2019s Controls screen and can be changed there.<\/p>\n
| Key | Action | Context |
\n|:—:|—|—|
\n| **R** | Sort & organize inventory | While any container is open |
\n| **Alt + Click** | Lock \/ Unlock slot | Prevents that slot from being sorted |
\n| **Alt + Left-Drag** | Batch lock \/ unlock slots | Drag across multiple slots |
\n| **B** | Toggle current container blacklist | When the current container should not be sorted |
\n| **Caps Lock + Double-Click** | Batch drop identical items | Quickly clear large stacks |
\n| **Shift + Drag** | Quick-move multiple slots | Drag across slots while holding Shift |
\n| **Shift + Double-Click** | Move all identical items | While holding an item on cursor |
\n| **Space + Double-Click** | Move all items from container | Empty an entire inventory at once |
\n| **Z + I** | Open settings screen | Available anytime |<\/p>\n
—<\/p>\n
## Technical Details<\/p>\n
– **Client-Side Only** \u2014 No server modifications; sorting is achieved by simulating player click actions
\n– **Creative Tab Native Sorting** \u2014 Reads Minecraft\u2019s Creative Mode tabs directly to build a sort index, perfectly matching the game\u2019s native item order and automatically supporting all modded items
\n– **Multi-Version Architecture** \u2014 Built with a `core` + `shared` + `platform` layered architecture, allowing one codebase to support multiple Minecraft versions
\n– **Dynamic Config System** \u2014 Supports config file hot-reload, no game restart needed after edits
\n– **Exact Container Matching** \u2014 `blockedContainers` matches exact container class names to avoid accidental fuzzy matches
\n– **Modular Mouse Tweaks** \u2014 Each mouse enhancement is an independent `MouseTweakModule`, making it easy to add or modify features
\n– **License** \u2014 All Rights Reserved (See LICENSE file for strict usage terms)<\/p>\n
—<\/p>\n
\n SimpleSorter<\/b>
\n A simple Minecraft inventory sorting tool.<\/i><\/p>\n","protected":false},"excerpt":{"rendered":"
A lightweight client-side mod for effortless inventory management in Minecraft.<\/p>\n","protected":false},"featured_media":141260,"template":"","meta":{"_minecraft_slug":"simplesorterr","_minecraft_project_id":"6iAdBiSB","_minecraft_author":"Zzai","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":7883,"_minecraft_follows":6,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"simplesorterr.zip","_minecraft_size_bytes":53615356,"_minecraft_version_count":83,"_minecraft_updated_at":"2026-05-16T17:38:15.992049Z","_minecraft_date_created":"2026-03-22T02:48:02.647333Z","_minecraft_date_modified":"2026-05-13T07:40:44.668722Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simplesorterr","_minecraft_icon_attachment_id":141260,"_minecraft_imported_at":"2026-06-08T09:29:19+00:00","_minecraft_import_hash":"c4741244e896034d0e4ec7c9866ac880","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,158,91,92],"mod_loader":[99,106,160],"minecraft_version":[36,62,37,40,41,38,81,82,83,827,828,829,830,831,832,167,163,837,838,839,840,841,842],"class_list":["post-141259","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-neoforge","mod_category-storage","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-4","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-pre-1","minecraft_version-26-1-pre-2","minecraft_version-26-1-pre-3","minecraft_version-26-1-rc-1","minecraft_version-26-1-rc-2","minecraft_version-26-1-rc-3","minecraft_version-26-1-1","minecraft_version-26-1-2","minecraft_version-26-2-snapshot-2","minecraft_version-26-2-snapshot-3","minecraft_version-26-2-snapshot-4","minecraft_version-26-2-snapshot-5","minecraft_version-26-2-snapshot-6","minecraft_version-26-2-snapshot-7"],"yoast_head":"\n