Client Sort

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).

Restock

• 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.

• Slot ignoring:
  • Exclude slots from being processed by operations.
  • Configurable via the editor screen.
• Auto operations:
  • Automatically perform an operation (e.g. sorting) when opening an inventory.
  • Configurable via the editor screen.
• Scoping:
  • Include or exclude the hotbar and extra slots from being processed with the inventory.
  • Configurable via mod config, General tab.
• Sorting overrides:
  • Always sort specific items to the start or end.
  • Configurable via mod config, Sorting tab.
• Matching overrides:
  • Ignore NBT data (e.g. enchantments) when comparing items in sort or restock operations.
  • Configurable via mod config, Matching tab.
• Interaction sounds:
  • Play a sound when clicking in client-side operations.
  • Configurable via mod config, Sounds tab.

• 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.

• 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.

• If installed on a dedicated server, ClientSort can use 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.

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

    // 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'!"
      }
    }
  }
}