🎯 Smart Sort

The Ultimate Inventory Management Mod for Fabric 1.21.1

Tired of manually organizing your inventory every time you go mining, exploring, or fighting? Smart Sort is here to revolutionize your Minecraft experience!

Create custom profiles for different activities (mining, combat, building, exploring) and switch between them with a single keypress! Never waste time sorting your inventory again - let Smart Sort do it for you!

✨ Key Features

🎨 Visual Profile Editor - No JSON Editing Required!

Drag-and-drop interface - Intuitive and easy to use
Real-time preview - See exactly how your inventory will look
Search functionality - Quickly find any item from 1500+ vanilla & modded items
Adjustable counts - Scroll over slots to set exact quantities (1-64)
Right-click to clear - Remove items from slots instantly

📦 Full Inventory Support

Hotbar (9 slots) - Your most important tools and items
Main Inventory (27 slots) - All your materials and supplies
Armor Slots (4 slots) - Automatically validates correct armor types
Offhand (1 slot) - Shield, torches, or anything else you need

⚡ Smart Automation

🔍 Smart Container Scanning - Automatically pulls items from nearby chests, barrels, and shulker boxes (5 block radius)
🔄 Intelligent Item Swapping - Moves displaced items to free slots automatically
📥 Excess Item Storage - Automatically stores items not in your profile back into nearby containers
⚡ One-Click Organization - Press Apply button or quick-hotkey (R) to instantly organize
🎯 Server-Side Processing - Reliable and accurate in both singleplayer and multiplayer

🔔 Smart Notifications

Missing item warnings - Shows exactly which items and how many are missing
Achievement-style pop-ups - Clear, non-intrusive notifications (10 seconds)
Detailed logging - Console output shows what was moved and where
Movement summaries - See exactly what Smart Sort did

🚀 How to Use

1️⃣ Create Your First Profile

Press P to open the Profile Selection screen
Click "Create New Profile"
Give it a memorable name (e.g., "Deep Mining", "PvP Combat", "Building")

2️⃣ Design Your Perfect Layout

Click "Edit" on your profile
Search for items in the item picker panel (left side)
- Type item names to filter (supports modded items!)
- Scroll through the list to browse
Drag items from the picker onto your desired inventory slots (right side)
Adjust quantities by scrolling over slots
- Respects max stack sizes (e.g., swords max at 1, blocks at 64)
Clear slots by right-clicking on them
Click "Save" when you're happy with your layout

3️⃣ Apply Your Profile

Position yourself near your storage chests (within 5 blocks)
Quick apply: Press R key, OR
Manual apply: Press P → Select profile → Click "Apply"

Watch the magic happen as Smart Sort:

🔍 Scans all nearby containers for your items
📦 Pulls the exact quantities you specified
🔄 Swaps items between slots intelligently
📥 Stores excess items back in chests
✅ Notifies you of any missing items

🎯 Example Profiles

⛏️ Deep Mining

Perfect for long mining sessions in the caves:

Slot 0: Diamond Pickaxe x1
Slot 1: Diamond Shovel x1
Slot 2: Diamond Axe x1
Slot 3: Torch x64
Slot 4: Torch x64 (backup)
Slot 5: Cooked Beef x64
Slot 6: Cobblestone x64 (for bridging)
Slot 7: Water Bucket x1
Slot 8: Crafting Table x1
Offhand: Shield x1

⚔️ PvP Combat

Optimized for player vs player battles:

Slot 0: Diamond Sword x1
Slot 1: Bow x1
Slot 2: Arrow x64
Slot 3: Arrow x64 (backup)
Slot 4: Ender Pearl x16
Slot 5: Golden Apple x16
Slot 6: Healing Potion x1
Slot 7: Strength Potion x1
Slot 8: Speed Potion x1
Armor: Full Diamond/Netherite Set
Offhand: Shield x1 or Totem of Undying x1

🏗️ Building Projects

Everything you need for construction:

Slots 0-3: Building Blocks x64 each
Slots 4-5: Stair/Slab variants x64 each
Slot 6: Torch x64
Slot 7: Scaffolding x64
Slot 8: Axe x1 (for quick corrections)
Main Inv: More building materials with specific counts
Offhand: Building Blocks x64

🛠️ Technical Details

Minecraft Version: 1.21.4
Mod Loader: Fabric
Side: Client + Server (works in singleplayer, requires on both for multiplayer)

📋 Requirements

Fabric API ≥ 0.102.0 (Required)
Fabric Loader ≥ 0.15.0 (Required)
Java 21 or newer

🔧 Why Server-Side Logic?

Smart Sort uses server-side container scanning to access real chest contents, not client-side placeholders. This ensures:

✅ Accurate detection - Reads actual chest contents even when closed
✅ No desync issues - Client and server always agree
✅ Mod compatibility - Automatically detects ALL items from installed mods
✅ Multiplayer support - Works reliably on servers
✅ Safe operations - No item duplication or loss possible

⌨️ Default Controls

Action	Key	Description
Open Profile GUI	`P`	Opens profile selection and management screen
Quick Apply	`R`	Instantly applies the currently active profile
Clear Slot	Right-Click	Removes item from slot in editor
Adjust Count	Mouse Scroll	Increase/decrease item quantity in editor

All keybindings are configurable in Minecraft's Controls settings

💡 Pro Tips

Store your items organized - Keep similar items in the same chest for faster scanning
Create multiple profiles - One for each activity (mining, farming, exploring, etc.)
Use the preview - Check the preview panel before applying to see what will change
Watch the notifications - They tell you exactly what's missing
Stand close to chests - Stay within 5 blocks for reliable scanning
Excess items - Items not in your profile are automatically stored back in chests

🐛 Known Issues

None currently! Smart Sort has been thoroughly tested. If you encounter any issues, please report them on our GitHub Issues page.

📦 Installation

Download the latest version from Modrinth or CurseForge
Install Fabric Loader (0.15.0 or newer)
Download Fabric API (0.102.0 or newer)
Place both Smart Sort and Fabric API in your .minecraft/mods folder
Launch Minecraft and enjoy automated inventory management!

🔮 Planned Features

Coming in v1.1.0

Profile import/export functionality
Custom keybind configuration
Profile categories and folders
Auto-apply on chest open option

Future Updates

Multi-profile quick switching
Profile templates library
Advanced item filtering
Undo/Redo system
Cloud profile sync (optional)

📜 License & Permissions

Smart Sort is licensed under the MIT License.

You are free to:

✅ Use in modpacks (no permission needed!)
✅ Modify for personal use
✅ Distribute with credit
✅ Create derivative works

❤️ Support the Developer

If you enjoy Smart Sort, please consider:

⭐ Starring the GitHub repository
📢 Sharing with friends and in your favorite Minecraft communities
💬 Leaving a review on Modrinth/CurseForge
☕ Donating to support continued development
🐛 Reporting bugs to help improve the mod

💬 Community & Support

GitHub: Report bugs & request features
Discord: Join our community (coming soon)
Wiki: Detailed guides & tutorials (coming soon)

🎨 Screenshots & Videos

Screenshots coming soon! Be the first to share your organized inventory on our Discord!

Want to create a video showcasing Smart Sort? We'd love to feature it! Contact us on GitHub.

Stop wasting time organizing your inventory manually. Download Smart Sort today and experience the future of inventory management! 🚀

Made with ❤️ by SeishiroNagi for the Minecraft community

SmartSort