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.

📧 Contact Me & Support Information

💬 Primary Support Channel (Preferred)

All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our Discord Server. We actively monitor the server and will respond as soon as possible. This ensures that the whole community can benefit from the discussion and solutions.

🆘 Urgent Private Messaging (PM) Policy

While we prefer all issues to be handled via the Discord server first, you are welcome to PM me directly under specific urgent circumstances:

• Allowed Reason: Your server is crashing or experiencing critical, game-breaking errors directly related to this plugin.
• Requirement: You must be the owner of the server.
• Time Zone: I am operating in the (CET/CEST) Time Zone.
• PM Hours: Please only send private messages between 10:00 AM and 10:00 PM (Brussels Time).

I will endeavor to answer your PM as soon as I can. Private messaging is a professional courtesy, not an entitlement. Thank you!

---

📦 Core Drawer Types

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

• Large Drawer (1-Slot): Concentrates all its power into one item type. Perfect for massive quantities of cobble or dirt.
• Medium Drawer (2-Slot): Split capacity for two different item types.
• Small Drawer (3-Slot): Maximum organization with three distinct slots.
• Compactor: 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 9 upgrade slots. Access the upgrade menu by Shift + Right-Clicking the front face of a drawer.

📈 Storage & Capacity

• Storage Upgrades (Tier 1-5): Multiplies base capacity by x2, x4, x8, x16, or x32.
• Infinite 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

• Hopper Upgrades (Pull/Push/Both): Allows drawers to automatically pull from containers above/behind or push to containers below/behind.
• Void 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

• Fill Meter: 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 Text Displays show item counts directly on the block face.

• Single 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).

• Right-Click Controller: 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 Friends & Access menu.

• Access Modes: Toggle between Everyone, Friends-Only, or Private.
• 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

• Highly Optimized: HUDs use the native Display entity system; no armor stand lag.
• SQLite Persistence: All HUD data and counts are saved in a local database for maximum reliability.
• Custom Recipes: 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.