Inventory Organizer

A client-side Fabric mod for Minecraft that sorts your inventory automatically with a single button press. Every slot in your inventory can be assigned a rule — by item category, item type, or exact item ID. The sorter runs entirely on your client and works on any server without any server-side installation.

Features

OI Button — One-click inventory sort An OI button appears on the player inventory screen and on the Creative inventory screen. Pressing it moves every item to its configured target slot using standard Minecraft slot-click packets, identical to what the game sends when you drag items manually.

Slot Rules Each of the 36 inventory and hotbar slots can be assigned one of the following rules:

• any — no restriction, used as general overflow space
• g:category — accepts any item from a category (weapons, tools, armor, food, blocks, valuables, utility, potions)
• t:type — accepts any item of a specific type regardless of material (sword, pickaxe, axe, bow...)
• minecraft:item_id — locks the slot to one exact item
• empty — the slot is always kept empty, the sorter never places anything here
• b:rule — places a bundle in the slot and applies a content rule to what goes inside it
• cg:GroupName — accepts any item from a custom group you defined yourself

Custom Groups The Custom Group Editor is a searchable full-screen palette of every item in the game. You build named lists of items, save them, and reference them in slot rules using the cg: prefix. Groups can be exported as plain text files and imported back by dragging the file onto the editor screen.

Sorting Order Within each category, item tiers are sorted in an order you define. The Sorting Order Config screen lets you drag tiers up and down within each category pool.

Storage Sorting An OST button appears on chests, barrels, shulker boxes, and other containers. Storage Presets define rule layouts for containers of specific sizes (9, 27, 54 slots, etc.). When you press OST, the sorter arranges the container contents according to the matching preset.

Kits Kits let you snapshot your current inventory layout under a name and restore it later. Useful for switching between a mining kit, a combat kit, and a building kit instantly.

Fight Mode When you hit a player or are hit by one, Fight Mode activates for 20 seconds. While active, the OI button is rate-limited: it moves one item per press with a randomised 130–179 ms cooldown between presses, mimicking a human clicking during combat. A HUD indicator with a countdown timer appears in the top-left corner of your screen. Fight Mode is designed to keep the mod compatible with server anti-cheat plugins during PvP.

Server Compatibility

This mod is 100% client-side. The server does not need it installed and does not know it is present. All item movements use the same vanilla slot-click packets the game already uses for manual dragging. No custom packets are sent, no server memory is modified, no items are duplicated.

The mod works safely on vanilla servers, Paper, Purpur, and servers running standard anti-cheat plugins. During PvP, Fight Mode automatically limits sorting speed to a human-realistic rate.

If your server rules explicitly forbid inventory macro or auto-sort tools, check them before using this mod. The vast majority of servers have no such rules.

Installation

1. Install Fabric Loader for your Minecraft version.
2. Download Fabric API and place it in your mods folder.
3. Download ModMenu (recommended, for accessing config in-game).
4. Download the Inventory Organizer jar for your Minecraft version and place it in your mods folder.
5. Launch the game. Press E to open your inventory — the OI button will be there.

Cloth Config is bundled inside the mod jar, no separate install is required.

Supported Versions

New features and bug fixes are developed for 1.21.10 and 1.21.11 only. Older versions are provided as-is and will not receive backported updates. Your config, slot rules, custom groups, kits, and storage presets carry over automatically when you update.

Dependencies

Language Support

English, Hungarian, German, Spanish, French, Portuguese (BR), Russian, Chinese (Simplified), Japanese.

License

MIT — see LICENSE for details.

#Ubdate system

Starting with v1.0.1, we're focusing all development on the newest Minecraft versions of the mod. Future bug fixes, new features, and quality-of-life improvements will only land on whatever the latest builds are at the time.

Why? Inventory Organizer supports a long chain of Minecraft versions, and every Minecraft release changes the API in some way — often subtly, sometimes drastically. Maintaining feature parity across all those ports for every patch is more work than a small project can sustain, and most of that effort goes into re-fixing the same things in slightly different ways rather than into making the mod better.

By concentrating on the latest builds, every hour of development translates directly into a better mod — instead of being split across a dozen near-identical ports.

What about older versions? The previous builds stay available on Modrinth and GitHub. They work, they're stable, and there's no reason to remove them. If you're on an older Minecraft version, your existing jar will keep working — it just won't get new features.

Backports — community requests only We're not closing the door completely. If there's a specific bug or feature you really want backported to an older version, open an issue on GitHub describing:

Which Minecraft version you're on Which specific fix or feature from a newer version you want Why (e.g. you're playing on a server pinned to that version, the bug breaks something important, etc.) We'll evaluate it case-by-case. Popular requests, simple backports, and clearly impactful fixes have the best chance. Large feature backports that require deep API rewrites are unlikely.

This is opt-in only — we won't be proactively backporting things, but we'll listen when the community asks.

TL;DR 🟢 Latest versions — actively developed 🟡 Older versions — available and stable, no new updates by default 🟠 Backports — possible by community request, evaluated individually Thanks for using Inventory Organizer, and special thanks to everyone who's reported bugs and suggested improvements — that feedback is what keeps the mod sharp.