TidyInv — Smart Inventory Sorting

Tired of dragging items around every time you open a chest? TidyInv sorts your inventory and any container in one click — or one keypress. Lightweight, server-friendly, and packed with quality-of-life features for Minecraft.

Overview

• 7 sort modes — Category, Name, Quantity, Rarity, By Mod, By Tag, Smart Affinity
• Vertical sort — column-first layout, perfect for organized chests
• 5 chest presets — Food, Tools, Building, Combat, Storage
• 4 sort profiles — Default, Mining, PvP, Building (saved to disk)
• Quick chest actions — Sort, Vertical Sort, Deposit, Restock, Dump All, Take All
• Locked slots — pin items in place with a visual indicator and tooltip
• In-game config GUI — press K to open, no JSON editing needed
• Full command support — /tidyinv … for everything
• 6 languages — English, Spanish (ES / MX), Portuguese (BR), French, German
• Public API — other mods can register custom containers and categorizers
• Server-side sorting with anti-spam cooldown — safe for multiplayer

Keybinds

All keybinds can be reassigned in Minecraft's Controls menu.

Chest buttons

When you open any chest, six buttons appear on the right side of the GUI:

> Buttons follow the chest GUI when it shifts (e.g. when the recipe book opens).

Sort modes

Chest presets

Open a chest and run /tidyinv preset <name>:

Commands

• /tidyinv sort [category|name|quantity|rarity|by_mod|by_tag|affinity]
• /tidyinv preset <food|tools|building|combat|storage>
• /tidyinv lock <slot 0-35>
• /tidyinv unlock <slot 0-35>
• /tidyinv profile list|switch <name>|next|current
• /tidyinv deposit
• /tidyinv restock
• /tidyinv dump
• /tidyinv take

Config

Press K in-game, or edit JSON files inside your config/ folder:

• tidyinv.json — general options
• tidyinv_locked_slots.json — locked slot indices
• tidyinv_profiles.json — sort profiles

In-game options:

• Default sort mode
• Show / hide chest buttons
• Sound ON / OFF
• ActionBar messages ON / OFF
• Lock hotbar by default
• Cooldown slider (0–40 ticks)
• Clear all locked slots
• Cycle between profiles

Public API

Other mods can extend TidyInv to support their own containers and item categories:

<pre><code>import com.luix1604.tidyinv.api.TidyInvAPI; import com.luix1604.tidyinv.sort.ItemCategory;

// Register a custom sortable container TidyInvAPI.registerContainerPredicate(menu -> menu instanceof MyCustomMenu);

// Register a custom item categorizer TidyInvAPI.registerCategorizer(stack -> { if (stack.getItem() instanceof MyMagicItem) return ItemCategory.MATERIALS; return null; // fall through to default }); </code></pre>

Compatibility

> NeoForge does not exist for MC 1.20.1 (its first release shipped on 1.20.2). For Fabric or Forge on that MC era, use the 1.20.1 build.

> Mojang dropped the 1. prefix starting with 26.1 (released early 2026). The canonical ordering is 1.21.11 → 26.1 → 26.1.1 → 26.1.2.

Designed to be compatible with most other mods. Containers from other mods are auto-detected, and modders can register their own via the public API.

Installation

1. Install the loader matching your setup (Fabric / Forge / NeoForge) for your Minecraft version.
2. For Fabric, also install Fabric API.
3. Drop the matching tidyinv-<mc>-<version>-<loader>.jar into your mods/ folder.
4. Launch the game. Press K in-game to open the config.

Source & Issues

GitHub: github.com/Luis1604/TidyInv

Each Minecraft version lives in its own branch. Per-version CHANGELOG.md files document everything that has shipped on that branch.

If you run into a bug, please open an issue on GitHub with your Minecraft version, loader, and the modlist you're using.

License

MIT License — free to use, modify and distribute.

Author

Luix1604 — luix1604