🎯 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

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

2️⃣ Design Your Perfect Layout

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

3️⃣ Apply Your Profile

1. Position yourself near your storage chests (within 5 blocks)
2. Quick apply: Press R key, OR
3. 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

1. Store your items organized - Keep similar items in the same chest for faster scanning
2. Create multiple profiles - One for each activity (mining, farming, exploring, etc.)
3. Use the preview - Check the preview panel before applying to see what will change
4. Watch the notifications - They tell you exactly what's missing
5. Stand close to chests - Stay within 5 blocks for reliable scanning
6. 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

1. Download the latest version from Modrinth or CurseForge
2. Install Fabric Loader (0.15.0 or newer)
3. Download Fabric API (0.102.0 or newer)
4. Place both Smart Sort and Fabric API in your .minecraft/mods folder
5. 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