✨ Builder's Relic

Builder's Relic is a lightweight, high-performance Paper plugin designed for survival servers. It introduces a legendary end-game artifact that acts as a magical palette and portable storage vault, letting players carry and place thousands of building blocks without cluttering their inventory.

⚡ The Forging Ritual

The Builder's Relic cannot be crafted in a standard crafting grid—it must be forged through an in-world ritual:

Place a Netherite Block on the ground.
Drop the required sacrifices on top of the block:
- 1x Heavy Core
- 1x Totem of Undying
- 2x Echo Shards
Hold a Nether Star in your hand and Left-Click the Netherite Block.

Lightning will strike the altar, consuming the ingredients, and leaving behind an Unbound Builder's Relic. Right-Click the Unbound Relic to bind it to your soul and forge its unique storage ID!

🛠️ Features

🔮 Direct Main-Hand Placement: Hold the Relic in your main hand and Right-Click to place your selected block instantly. No offhand dummy blocks required!
📦 Infinite Upgradeable Storage: Relics start with 1 row (9 slots). Click the Nether Star inside the GUI with a Nether Star in your inventory to unlock +9 slots (1 row) per upgrade.
📄 Page Navigation System: Built-in multi-page GUI with previous/next arrows to hold infinite types of blocks across endless pages.
🧲 Auto-Deposit Vacuum: Toggle auto-deposit to automatically pull mined blocks straight out of the world and into your Relic storage.
🛡️ Built-in Safeguards: Protection against nested storage ("Relic-ception"), shift-click inventory support, and persistence backed by NBT keys.

🎮 How to Use & Controls

Action	Control
Open Storage GUI	Left-Click while holding the Relic
Place Selected Block	Right-Click or Shift-Right-Click while holding the Relic
Select Block for Building	Left-Click an item inside the Relic GUI
Withdraw a Stack (64)	Right-Click or Shift-Click an item inside the Relic GUI
Deposit Blocks	Click or Shift-Click items from your player inventory into the open GUI

💬 Commands & Permissions

Plaintext

/relic help          - Displays the in-game interactive guide
/relic autodeposit   - Toggles auto-vacuuming picked-up blocks into the Relic
/giverelic           - Spawns a new bound Relic (Requires OP / Permission)

Permissions: buildersrelic.admin (for /giverelic)