AutoInventorySorter — Smart Inventory & Hotbar Organizer

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

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

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

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