🗂️ AutoInventorySorter

A client-side Fabric mod that instantly organizes your Minecraft inventory with one keypress.
No clutter. No digging. Just press R and everything is in its place.

📸 Screenshots

🤔 What does this mod do?

AutoInventorySorter automatically organizes your Minecraft inventory. Press R to sort everything — items are grouped by type, rarity, name, quantity, or durability depending on the mode you choose. It also locks specific hotbar slots so your sword and pickaxe never get displaced, and automatically refills consumed items like food, torches, and arrows.

It runs entirely on the client side — no server installation needed, works on any server including vanilla, Paper, and Fabric.

✨ Features

🎯 One-Key Sorting

Press R to instantly sort your inventory or any open chest/container. The entire operation completes in under 5ms with no lag or disruption.

📂 5 Sort Modes

🔒 Hotbar Slot Locking

Lock specific hotbar slots to always hold certain item types. Defaults:

• Slot 1 → Sword
• Slot 2 → Pickaxe
• Slot 3 → Axe
• Slot 9 → Totem of Undying

Locked items automatically return to their assigned slot every time sorting runs. Fully customizable via config.

🔄 Auto-Refill

When you consume the last item from a hotbar slot, AutoInventorySorter immediately pulls a replacement from your inventory. Supports:

• Food
• Blocks
• Torches
• Arrows

Checks every 0.25 seconds, runs silently in the background.

🚫 Blacklist System

Exclude specific items or inventory slots from sorting entirely. Useful for maps, compasses, named items, or any item you want to keep in a fixed position.

👤 Profile System

Four built-in sort profiles you can switch between:

⚡ Performance

• Memory overhead: ~2 MB
• CPU usage: less than 0.1% average
• Sort time: ~5 ms for a full inventory
• No tick impact on gameplay

📥 How to Install

Required

Optional

Steps

1. Install Fabric Loader
2. Download Fabric API for your Minecraft version
3. Download AutoInventorySorter from the Versions tab
4. Place both .jar files in your .minecraft/mods/ folder
5. Launch Minecraft

🎮 How to Use

⚙️ Configuration

File location: .minecraft/config/autoinventorysorter.json

{
  "enabled": true,
  "sortMode": "ITEM_TYPE",
  "sortKey": "R",
  "enableSlotLocking": true,
  "autoRefillHotbar": true,
  "enableChestSorting": true,
  "enableBlacklist": true,
  "autoSortOnOpen": false,
  "refillFood": true,
  "refillBlocks": true,
  "refillTorches": true,
  "refillArrows": true,
  "lockSword": true,
  "swordSlot": 0,
  "lockPickaxe": true,
  "pickaxeSlot": 1,
  "lockAxe": true,
  "axeSlot": 2,
  "lockTotem": true,
  "totemSlot": 8,
  "blacklistedItems": [
    "minecraft:compass",
    "minecraft:filled_map"
  ],
  "blacklistedSlots": []
}

🌐 Multiplayer

This mod is 100% client-side. It does not require installation on the server and works with:

• Vanilla servers
• Fabric servers
• Spigot and Paper servers
• Large networks like Hypixel

Always check a server's specific rules on client mods before using.

❓ FAQ

Does this work with Forge or NeoForge?
Not yet. Fabric only for now. A Forge/NeoForge port is on the roadmap.

Does it support modded items?
Yes. The sort system works with any item, vanilla or modded.

Can I change the sort key from R?
Yes. Edit sortKey in the config file, or use Mod Menu if installed.

Will this cause issues in multiplayer?
No. The mod only reorganizes your local inventory and does not send any extra packets to the server.

🐛 Bugs & Feedback

Please report bugs on GitHub Issues with:

• Minecraft version
• Fabric Loader and Fabric API version
• AutoInventorySorter version
• Steps to reproduce the issue
• Crash log from .minecraft/logs/latest.log if applicable

🔗 Links

☕ Support

If AutoInventorySorter saves you time, consider buying me a coffee!

📜 License

MIT — free to use, fork, and include in modpacks. Credit appreciated but not required.

Made with ❤️ for the Minecraft community