SmartSort - Chest & Inventory Sorter

📦 SmartSort

SmartSort is a lightweight, high-performance inventory management mod for modern Minecraft. It allows players to instantly deposit items from their inventory into nearby categorized chests with a single keystroke or button click.

✨ Features

• ⚡ One-Click Sorting: Automatically scans chests within an 8-block radius and transfers items to matching categorized containers with real-time sound and action-bar feedback.
• 🛡️ Slot Protection & Safe Zones:
  • In 26.3+ (Streamlined Safe Zone): The sorter only touches the upper 2 rows of your inventory. Your Hotbar and the Bottom Row are permanently protected and never dumped (indicated with a subtle slot tint).
  • In 1.21.1 / 1.20.1 (Manual Slot Locking): Hold Left ALT + Left Click on any inventory slot to toggle locks on individual slots.
• 🏷️ In-Game Chest Tagging & GUI: Adds a clean, integrated text input box right above chest interfaces with an upward auto-complete dropdown. Press K to open the Category Management screen to search items, browse results, and configure custom categories effortlessly.
• 🎯 Dynamic & Flexible Matching: Beyond preset categories, it dynamically matches chest names, item display names, and registry IDs. Naming a chest "sword" or a custom keyword routes matching items instantly.
• 🌌 Cross-Dimensional Consistency: Chest data across the Overworld, Nether, and End never mix—even if containers share the exact same coordinates.
• 🔤 Special Character Normalization: Automatically handles language-specific characters (such as Turkish ş, ğ, ü, ç, ö, ı) and remains completely case-insensitive (SWORD, Sword, or sword all behave identically).
• 🧩 Mod Compatibility: Works out of the box with popular mods like Create, Farmer's Delight, and custom container storages.
• 🌍 Multi-Language Support: Full translations included for English (en_us) and Turkish (tr_tr).
• 🌐 100% Multiplayer & Server Ready: Built on NeoForge's modern payload network architecture with full dedicated server, LAN, and Co-op compatibility.

📂 Supported Categories & Item Matching

SmartSort automatically organizes your items into intuitive categories:

• Blocks (blok / block): Dirt, Stone, Cobblestone, Deepslate, Sand, Gravel, Tuff, Obsidian, Sculk, Mud, etc.
• Wood (ahsap / wood): All logs, planks, and wooden variants.
• Farming (tarim / farming): Seeds, wheat, bamboo, sugar cane, saplings, flowers, and leaves.
• Food (yemek / food): All edible foods, crops, and eggs.
• Tools & Weapons (alet / tools): Swords, pickaxes, axes, shovels, hoes, bows, crossbows, tridents, maces, shears, fishing rods, buckets, and compasses.
• Armor (zirh / armor): Helmets, chestplates, leggings, boots, horse armor, and wolf armor.
• Decoration (dekor / decor): Glass, stairs, slabs, doors, trapdoors, signs, banners, torches, lanterns, fences, walls, decorated pots, and copper bulbs.
• Alchemy (simya / alchemy): Potions, splash potions, experience bottles, brewing stands, blaze powder, fermented spider eyes, and glass bottles.
• Raw Materials (hammadde / raw): Honeycomb, breeze rods, fire/wind charges, slimeballs, bones, strings, feathers, sticks, flint, leather, dyes, and bone meal.
• Rare Relics (nadir / rare): Trial keys, echo shards, music discs, ender pearls, eyes of ender, dragon eggs, totems of undying, templates, and conduits.
• Nether (nether): Netherrack, nether bricks, soul sand/soil, basalt, blackstone, glowstone, and quartz.
• Redstone (kiziltas / redstone): Redstone dust, repeaters, comparators, pistons, observers, dispensers, and droppers.
• Utility (islev / utility): Chests, furnaces, crafting tables, anvils, barrels, smokers, blast furnaces, and workbenches.
• Books (kitaplar / books): Enchanted books, regular books, and written books.
• Ores & Minerals (maden / ores): Ores, ingots, raw metals, nuggets, diamonds, emeralds, coal, and lapis lazuli.
• Create Mod (create): Native compatibility for Create mod items (create:*).

⌨️ Controls & Keybinds

• R Key (Rebindable): Instantly sorts inventory items into nearby tagged chests.
• K Key (Rebindable): Opens the Category Management screen.
• ⇄ Button: Convenient button located at the top right of the player inventory screen.
• Left ALT + Left Click (1.20.1 & 1.21.1): Locks or unlocks any slot in your main inventory.
• Protected Safe Row (26.3+): The bottom row and hotbar are permanently protected from being dumped.

🌐 Installation Guide

• Singleplayer / LAN: Drop the .jar into your .minecraft/mods folder.
• Dedicated Servers / Co-op: Must be installed on both the server and connecting clients.

🧩 Complete Your "Smart" Survival Suite!

Check out our other essential quality-of-life mods designed to work seamlessly together:

• 🔨 Smart Crafting Station — Craft items directly using materials from nearby chests (Terraria-style proximity crafting).
• 🗑️ SmartTrash — Safe, clutter-free inventory trash slot with undo support.