Skip to content

TerminalMC/ClientSort

Repository files navigation

Icon

ClientSort

Versatile and easy inventory sorting.

Environment Latest Minecraft

Loader Loader Loader

Download on Modrinth Download on CurseForge Download on GitHub

About

Sorting

To sort an inventory, simply hover over it with your mouse and press the keybind (default: middle mouse button).

By default, 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 pressing the sort keybind.

  • Shift - descending order of quantity.
  • Control - alphabetical order.
  • Alt - ascending order of item ID.

Other Operations (v2)

In addition to sorting, ClientSort v2.0.0 and later versions include the following operations:

  • Stack Fill
    • Complete all partial stacks in the other inventory using items in the target inventory.
  • Transfer Matching
    • Move all items from the target inventory to the other inventory, without adding any new item types to the target inventory.
  • Transfer
    • Move all items from the target inventory to the other inventory.
Sort demo Stack fill demo Transfer matching demo Transfer demo

Trigger Buttons (v2)

In addition to keybinds, ClientSort supports displaying small buttons above the inventory screen, which can be used to trigger operations.

  • All buttons are disabled by default, but can be enabled via the config menu or the editor screen.
  • The editor screen can be opened via a keybind (unbound by default) when viewing an inventory.
  • When a button is visible, you can right-click on it to open the editor screen.
  • You can hover over Instructions for more info about configuring the trigger buttons.
GUI demo Editor demo

Slot Ignoring (v2)

If you want operations to ignore specific slots, you can click on the slots while viewing the editor screen to add them to the ignore-list for that type of inventory.

This may be particularly useful for modded inventories with special attachment slots, if ClientSort does not recognize that they are not part of the main inventory.

Clientside Policies (v2)

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.

Serverside Policies (v2)

If installed on a server or in singleplayer, 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 connected clients may still attempt to sort a disabled inventory (unless they have a client-side policy disabling it), but the server will not perform the operation.

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.

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

Discord Server

GitHub Issues

License

About

A client-side multi-loader Minecraft mod that provides versatile and easy inventory sorting.

Topics

Resources

License

Stars

Watchers

Forks

Contributors 7