SmartSort - Chest & Inventory Sorter

# 📦 SmartSort (Minecraft 1.21.1 / NeoForge)

**SmartSort** is a lightweight, server-friendly inventory management mod for 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 unlocked items to matching categorized containers with real-time sound and action-bar feedback.
* 🏷️ **In-Game Chest Tagging & GUI:** Adds a clean, integrated text input box right above the chest interface with an upward auto-complete dropdown to keep inventory slots completely clear. Press **K** to open the advanced Category Management screen to search items, browse results, and override 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:** The SmartPos system ensures Overworld, Nether, and End chests never collide or mix data—even if they share the exact same coordinates.
* 🔤 **Special Character Normalization:** Automatically normalizes language-specific characters (e.g., Turkish ş, ğ, ü, ç, ö, ı) and remains completely case-insensitive (`SWORD`, `Sword`, or `sword` all behave identically).
* 🔒 **Slot Locking System:** Hold **Left ALT + Left Click** on any main inventory slot to lock/unlock it. Locked slots are never transferred.
* 🧩 **Mod Compatibility:** Out-of-the-box support for popular mods like Create, Farmer's Delight, and Sophisticated Storage (fully compatible with custom chests, barrels, and all `IItemHandler`-compliant storage).
* 🌍 **Multi-Language Support:** Full translation support for English (`en_us`) and Turkish (`tr_tr`).
* 🌐 **100% Server & Multiplayer Ready:** Built using NeoForge's custom payload network system with instant two-way synchronization and distance security checks. Runs smoothly on Dedicated Servers, Aternos/Exaroton, and LAN.

---

### 📂 Supported Categories & Item Matching

SmartSort automatically normalizes chest tags and categorizes items based on the following:

* 🧱 **Blocks (`blok` / `block`):** Granite, Diorite, Andesite, Tuff, Obsidian, Sculk, Mud, Bone Block, Dirt, Stone, Sand, Gravel, Deepslate, Clay, 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 food items and eggs.
* ⛏️ **Tools & Weapons (`alet` / `tools`):** Swords, pickaxes, axes, shovels, hoes, bows, crossbows, tridents, maces, shears, fishing rods, buckets, boats, and compasses.
* 🛡️ **Armor (`zirh` / `armor`):** Helmets, chestplates, leggings, boots, horse armor, and wolf armor.
* 🪟 **Decoration (`dekor` / `decor`):** All glass types/panes, stairs, slabs, doors, trapdoors, signs, banners, torches, lanterns, fences, walls, copper bulbs, grates, decorated pots, and pottery sherds.
* 🧪 **Alchemy (`simya` / `alchemy`):** Potions, splash potions, experience bottles, brewing stands, blaze powder, fermented spider eyes, glistering melon slices, ominous bottles, and glass bottles.
* 📦 **Raw Materials (`hammadde` / `raw`):** Honeycomb, breeze rods, fire charges, wind charges, slimeballs, snowballs, glow ink sacs, spider eyes, gunpowder, bones, string, feathers, sticks, flint, leather, scutes, glowstone dust, paper, dyes, and bone meal.
* 💎 **Rare Relics (`nadir` / `rare`):** Trial keys, ominous trial keys, echo shards, disc fragments, ghast tears, saddles, music discs, ender pearls, eyes of ender, dragon eggs, totems of undying, smithing templates, heart of the sea, nether stars, and conduits.
* 🔥 **Nether (`nether`):** Netherrack, nether bricks, soul sand/soil, basalt, blackstone, glowstone, and quartz blocks.
* 🔴 **Redstone (`kiziltas` / `redstone`):** Redstone dust, repeaters, comparators, pistons, observers, dispensers, and droppers.
* 🛠️ **Utility (`islev` / `utility`):** Chests, furnaces, crafting tables, anvils, barrels, smokers, blast furnaces, cauldrons, grindstones, looms, cartography tables, fletching tables, and smithing tables.
* 📚 **Books (`kitaplar` / `books`):** Enchanted books, regular books, written books, and book & quills.
* ⛏️ **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 and deposits them into nearby tagged chests.
* **K Key (Rebindable):** Opens the Category Management screen for custom item overrides and live search.
* **⇄ Button:** Located at the top right of the player inventory screen for quick mouse interaction.
* **Left ALT + Left Click:** Locks or unlocks an inventory slot.

---

### 🌐 Server Installation

* **Dedicated Server / Multiplayer:** Must be installed on both the server and client.
* **Singleplayer / LAN:** Just drop the `.jar` into your `mods` folder.

---

### 🧩 Complete Your "Smart" Survival Suite!
Check out our other essential quality-of-life mods designed to work seamlessly together:
* 🔨 **[Smart Crafting Station](https://www.curseforge.com/minecraft/mc-mods/smart-crafting-station)** — Craft items directly using materials from nearby chests (Terraria-style proximity crafting).
* 🗑️ **[SmartTrash](https://www.curseforge.com/minecraft/mc-mods/smarttrash)** — Safe, clutter-free inventory trash slot with undo support.