✨ 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
<button class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-badge mat-unthemed mat-badge-overlap mat-badge-above mat-badge-after mat-badge-small mat-badge-hidden ng-star-inserted" aria-label="Download code"></button><button class="mdc-icon-button mat-mdc-icon-button mat-mdc-button-base mat-badge mat-unthemed mat-badge-overlap mat-badge-above mat-badge-after mat-badge-small mat-badge-hidden ng-star-inserted" aria-label="Copy code"></button>
/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)
