Client Sort

ClientSort

Versatile and easy inventory sorting.

Operations

Sort

• Press the button, or hover over the inventory with your mouse and press the keybind (default: middle mouse button).
• When activated, items are sorted by their position in the creative inventory search tab. Alternative sort orders can be used by holding down a modifier key while sorting.
  • Shift - descending order of quantity.
  • Control - alphabetical order.
  • Alt - ascending order of item ID.

Fill Stacks

• Press the button, or hover over the inventory that you want to move items out of and press the keybind (default: unbound).
• When activated, partial stacks in the other inventory are topped-up using items in the origin inventory.
• This button is disabled on the player inventory by default, but can be enabled via the editor (see below).

Transfer Matching

• Press the button, or hover over the inventory that you want to move items out of and press the keybind (default: unbound).
• When activated, the other inventory is restocked using items in the origin inventory. No new item types are added to the other inventory.

Transfer

• Press the button, or hover over the inventory that you want to move items out of and press the keybind (default: unbound).
• When activated, as many items as possible are moved from the origin inventory to the other inventory.

Editor

• The editor can be opened in two ways:
  • If a trigger button is visible, right-click on it.
  • Otherwise, bind the Open Editor keybind (unbound by default) and press it while viewing an inventory.
• When you've opened the editor, hover over Instructions for more information.
• Note: fill and transfer buttons are only shown if set to show on both the player inventory and the container, so you can easily hide them everywhere by hiding them on just the player inventory.

Client-Side Policies

• ClientSort uses a policy system to determine when to allow operations, when to show the trigger buttons, and when to ignore slots. The policy can be configured either via the editor screen or via the Policies tab of the mod options.
• Read the in-game instructions for more information on editing policies.

Server-Side Policies

• If installed on a dedicated server, ClientSort uses policies to automatically disable server-accelerated operations when it detects an incorrect state (such as item duplication).
• The policy list is stored in the clientsort-server.json config file, which can be manually edited and reloaded using the /clientsort reload command.

Serverside policies are not synced to clients, so if a client attempts to perform a server-accelerated operation that the server does not allow, a warning message will be shown to the client. The player can then opt to add a client-side policy to disable the operation entirely, disable server acceleration, or enable automatically falling back to client operations.

Serverside Config File

{
  "options": {
    // Whether validation and automatic blacklisting should be enabled when the mod is used on a
    // dedicated server.
    "validationActiveServer": true,

    // Whether inventories should be blacklisted when the wrong type of item is found in a slot.
    "validateItemType": true,

    // Whether inventories should be blacklisted when the wrong number of items is found in a slot.
    "validateStackSize": true,
    // The minimum difference between expected and actual which should be considered invalid.
    "validateStackSizeThreshold": 32,

    // Whether to always log a message when the result is not exactly as expected (even if
    // validation is disabled, the difference is less than the threshold, etc.)
    "alwaysLogUnexpectedResults": true,

    // The list of policies for different inventory and container types.
    "classPolicies": {
      // An example entry.
      "com.simibubi.create.content.equipment.toolbox.ToolboxMenu": {
        "className": "com.simibubi.create.content.equipment.toolbox.ToolboxMenu",
        "sortEnabled": false,
        "stackFillEnabled": true,
        "transferEnabled": true,
        // Updated automatically when an inventory is blacklisted.
        "lastAutoEditTime": "2025-09-20T14:58:41.1620876+08:00",
        "lastAutoEditReason": "Sort operation failed at slot mapping 12->5: Expected '2 minecraft:spruce_slab' in destination after set, got '0 minecraft:air'!"
      }
    }
  }
}

Installation

Client Required, Server Optional

As the name suggests, ClientSort is fully functional when it is only installed on the client. However, if it is also installed on a server, connected clients with the mod will be able to use server-accelerated (near-instant) operations instead of the normal rate-limited operations.

Dependencies

Fabric: Fabric API, ModMenu, Cloth Config API

Neo/Forge: Cloth Config API

Credits

ClientSort uses code from the following mods, in both modified and unmodified form, in accordance with their respective licenses.

• Mouse Wheelie by Siphalor (Apache-2.0 license)

  • Item comparison
  • Client and server-side sorting
  • Client-side interaction manager

• Inventory Management by Roundaround (MIT license)

  • Inventory trigger buttons
  • Button generation
  • Button position editor

Related Mods

• Mouse Tweaks - item scrolling, mouse dragging.
• More Mouse Tweaks - single-click crafting and trading, quick-move and quick-drop.
• Tweakeroo - hand restock, auto tool-switch, tool break prevention and more.

Contact