DrawerShelves - Professional Grade Storage & Organization!

Minecraft 1.21.9 – 1.21.11

Check out the 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.

📬 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

🗝️ 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 upgrades.yml allows you to change every crafting requirement.
• Anti-Lag: Automatic cleanup of "ghost" displays and block-physics protection for drawer structures.