🗂️ 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

Inventory sorting

Hotbar slot locking

🤔 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

Mode	What it does
`ITEM_TYPE`	Groups by category — weapons, tools, food, blocks, misc
`RARITY`	Common → Uncommon → Rare → Epic → Legendary
`NAME_AZ`	Alphabetical by item name
`QUANTITY`	Largest stacks appear first
`DURABILITY`	Best-condition tools sorted to the top

🔒 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:

Profile	Best for
Survival	General play — balanced layout
PvP	Combat — weapons and potions prioritized
Mining	Pickaxes, torches, shovels, ores up front
Building	Blocks sorted by type and quantity

⚡ 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

Dependency	Version
Minecraft	1.21.5 – 1.21.x
Fabric Loader	0.16.9+
Fabric API	0.136.1+1.21.8 or matching
Java	21+

Optional

Mod	Purpose
Mod Menu	In-game settings GUI
Cloth Config	Advanced config interface

Steps

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

🎮 How to Use

What you want to do	How
Sort your inventory	Press R
Sort an open chest	Open the chest, press R
Sort automatically on open	Set `autoSortOnOpen: true` in config
Change sort mode	Edit `sortMode` in config or use Mod Menu
Lock a hotbar slot	Edit `lockSword`, `swordSlot`, etc. in config
Protect an item from sorting	Add it to `blacklistedItems` in config

⚙️ 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


Source Code	github.com/devxkamlesh/autoinventorysorter
Bug Tracker	GitHub Issues
Developer	@devxkamlesh
Portfolio	devxkamlesh.vercel.app

☕ 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

AutoInventorySorter — Smart Inventory & Hotbar Organizer