DrawerShelves

DrawerShelves - Professional Grade Storage & Organization!

Tired of messy chest rooms? DrawerShelves transforms standard Minecraft shelves into high-capacity, specialized storage units! Whether you need to store thousands of a single item, compact your ores automatically, or link multiple units to a central controller, this plugin provides a sleek, lag-free solution with full 3D HUD visuals.

---

📦 Core Drawer Types

Every drawer is built from a standard Shelf block but specialized for different needs.

* Controller: Concentrates all its power into one item type. Perfect for massive quantities of cobble or dirt. * Controller: Split capacity for two different item types. * Controller: Maximum organization with three distinct slots. * Controller: Automatically converts items between their forms (e.g., Nuggets ⇋ Ingots ⇋ Blocks). * Controller: The "brain" of your storage. Link nearby drawers (up to 16 by default) to deposit items into the entire network at once.

---

🛠️ The Upgrade System

Customize your drawers with up to Shift + Right-Clicking. Access the upgrade menu by Shift + Right-Clicking the front face of a drawer.

📈 Storage & Capacity

* One Stack Upgrade: Multiplies base capacity by One Stack Upgrade:. * One Stack Upgrade: Removes capacity limits entirely for creative-style storage. * One Stack Upgrade: Limits the drawer to exactly 64 items (useful for shop displays).

🤖 Automation & Utility

* Clean Upgrade: Allows drawers to automatically pull from containers above/behind or push to containers below/behind. * Clean Upgrade: Automatically deletes excess items once the drawer reaches maximum capacity. * Clean Upgrade: Specifically for tools and armor. It strips custom NBT and "merges" durability into a shared pool for bulk storage of equipment.

🎨 Visuals & Feel

* Bright Upgrade: Adds a visual progress bar to the HUD showing how full each slot is. * Bright Upgrade: Makes the 3D HUD glow, making it perfectly visible in total darkness.

---

⚡ Main Mechanics

🖥️ 3D Text HUD

No more opening GUIs to check counts! High-performance Triple Mode: show item counts directly on the block face. * Triple Mode: Merges identical items into one total count. * Triple Mode: Shows separate counts for every individual slot.

🔗 Controller Networking

Link a Controller to your drawers using a lateral BFS discovery (±3 blocks). * Double Right-Click: Insert your held item into the first matching drawer in the network. * Double Right-Click: Instantly deposit all matching items from your entire inventory into the linked network.

💎 Compaction Logic

Compactors treat storage as a single pool of "units." If you put in 9 Iron Ingots, you can pull out 1 Iron Block or 81 Iron Nuggets instantly.

---

🔐 Permissions & Access

Control who can touch your stuff with the built-in Trust Levels: menu. * Trust Levels: Toggle between Trust Levels:, Trust Levels:, or Trust Levels:. * Trust Levels: Add specific players with varying permissions (Item Access, Upgrade Editing, or Full Management).

---

📜 Commands

* `/drawers help` - View the help menu. * `/drawers give [player]` - Open the Drawer Catalog to browse and take items (Admins). * `/drawers recipe` - Browse crafting recipes for every drawer and upgrade. * `/drawers compact` - Browse or create custom compaction recipes. * `/drawers mode <SINGLE/TRIPLE/TOP/BOTTOM>` - Customize your personal HUD preferences. * `/drawers reload` - Reload all configurations and sync displays.

---

🔑 Permission Nodes

⚙️ Core Permissions

* `drawershelves.command` - Access to the base `/drawers` command. (Default: true) * `drawershelves.admin` - Bypass all limits and permission checks. (Default: op) * `drawershelves.reload` - Reload plugin configurations. (Default: op) * `drawershelves.give` - Give drawer items via `/drawers give`. (Default: op)

📊 Placement Limits

*Set server-wide defaults in `config.yml`. # = max amount.* * `drawershelves.drawer.#` - Max Small/Medium/Large Drawers. * `drawershelves.compactor.#` - Max Compactors. * `drawershelves.controller.#` - Max Controllers.

⚒️ Upgrade Crafting

* `drawershelves.upgrade.<type>` - Allows crafting specific upgrades (e.g., `clean`, `infinit`, `fill_meter`, `hopper_pull`, `hopper_push`, `hopper_both`, `bright`, `stack`, `trash`, `inv_1` to `inv_5`).

📥 Upgrade Placement

* `drawershelves.place.<type>` - Allows inserting upgrades into a drawer. * *Note: `drawershelves.place.infinit` and `drawershelves.place.inv_5` default to OP.*

---

🛠️ For Admins

* Anti-Lag: HUDs use the native Display entity system; no armor stand lag. * Anti-Lag: All HUD data and counts are saved in a local database for maximum reliability. * Anti-Lag: Fully configurable `recipes.yml` allows you to change every crafting requirement. * Anti-Lag: Automatic cleanup of "ghost" displays and block-physics protection for drawer structures.