1.21.9 - 1.21.11
DrawerShelves - Professional Grade Storage & Organization!

Check out ShopShelves plugin here:

()

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.[/CENTER]

• Contact Me & Support Information

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 - Allows access to the base /drawers command. (Default: true)
• drawershelves.admin - Full admin access; bypasses all limits and checks. (Default: op)
• drawershelves.reload - Allows reloading the plugin configuration. (Default: op)
• drawershelves.give - Allows giving items via the catalog GUI. (Default: op)

Placement Limits
Set maximum counts in config.yml; use these nodes to override per-player. # = amount.

• drawershelves.drawer.# - Max amount of Small/Medium/Large Drawers.
• drawershelves.compactor.# - Max amount of Compactors.
• drawershelves.controller.# - Max amount of Controllers.

Upgrade Crafting

• drawershelves.upgrade.clean - Craft Clean Item Upgrade.
• drawershelves.upgrade.infinit - Craft Infinite Upgrade.
• drawershelves.upgrade.fill_meter - Craft Fill Meter Upgrade.
• drawershelves.upgrade.hopper_pull - Craft Hopper Pull Upgrade.
• drawershelves.upgrade.hopper_push - Craft Hopper Push Upgrade.
• drawershelves.upgrade.hopper_both - Craft Advanced Hopper Both Upgrade.
• drawershelves.upgrade.bright - Craft Bright Upgrade.
• drawershelves.upgrade.stack - Craft One Stack Upgrade.
• drawershelves.upgrade.trash - Craft Void Upgrade.
• drawershelves.upgrade.inv_1 to .inv_5 - Craft Storage Upgrades (x2 to x32).

Upgrade Usage/Placement

• drawershelves.place.clean - Insert Clean Upgrade.
• drawershelves.place.infinit - Insert Infinite Upgrade (Default: op).
• drawershelves.place.fill_meter - Insert Fill Meter Upgrade.
• drawershelves.place.hopper_pull - Insert Hopper Pull Upgrade.
• drawershelves.place.hopper_push - Insert Hopper Push Upgrade.
• drawershelves.place.hopper_both - Insert Hopper Both Upgrade.
• drawershelves.place.bright - Insert Bright Upgrade.
• drawershelves.place.stack - Insert One Stack Upgrade.
• drawershelves.place.trash - Insert Void Upgrade.
• drawershelves.place.inv_1 to .inv_4 - Insert Tier 1-4 Storage Upgrades.
• drawershelves.place.inv_5 - Insert Emerald Storage Upgrade (Default: 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.
• Upgrades Settings: Fully configurable
  Code (Text):

  upgrades.yml
  allows you to change every crafting requirement.
• Anti-Lag: Automatic cleanup of "ghost" displays and block-physics protection for drawer structures.