✦ RvGraves ✦

Reimagining Player Death with Immersive 3D Display Monuments

Elevate your server's survival experience with RvGraves, an enterprise-grade, premium death-management utility built natively for modern high-performance Minecraft networks.

Say goodbye to archaic, lag-inducing floor item drops or flat, uninspired floating chest containers. RvGraves utilizes cutting-edge Vanilla Display Entities and complex JOML transformation matrices to construct incredibly detailed, multi-layered 3D memorial structures at the exact site of a player's demise. No client-side resource packs, mods, or configurations are required—everything renders beautifully in vanilla Minecraft.

---

🚀 Key Premium Features

🏛️ The "Fallen Warrior" 3D Monument Architecture

When a player falls in battle, the plugin instantly suppresses vanilla item drops and calculates a mathematically precise, multi-layered structural monument:

• The Foundation: A perfectly centered, low-profile framing border crafted from solid Polished Deepslate, enclosing a mound of rich Podzol earth.
• The Obelisk: An erect, two-tier gothic headstone utilizing weathered Cracked Deepslate Bricks.
• The Relics: The deceased player’s skull rests solemnly against the base of the monument, while their trusty Iron Sword remains thrust dramatically into the soil out front.
• The Beacon: An integrated, glowing Soul Lantern provides structural lighting, ensuring the grave stands out vividly even in the darkest caves or night cycles.
• Smart Orientation: The entire 3D structure dynamically captures the player's precise yaw direction at the exact millisecond of death, ensuring the monument faces perfectly forward in relation to their final moment.

🌀 Mystical Visual FX & Sound Design

• Dynamic Spawn Sequence: The creation of a grave triggers a deep, echoing Wither roar variant coupled with heavy deepslate shattering sound effects. Simultaneously, a dense burst of physical block particles erupts around the plot.
• Orbital Soul Fire Spiral: Active graves generate an advanced, continuous trigonometric particle ring. Shimmering Soul Fire Flame particles orbit the monument in a fluctuating vertical wave, acting as a beacon for searching players.
• Imminent Decay Wobble: When the internal protection timer drops below 10%, the structure enters an imminent decay sequence, utilizing rapid interpolation states to make the central tombstone physically rock and shake back and forth.

🔒 Dual-Phase Protection & Secure Inventories

• Owner Locking: Graves are automatically protected upon creation. Unauthorized players attempting to rob the inventory will be met with a traditional locked chest audio cue and a clean, custom action-bar warning.
• Global Looting Phase: Once the customizable stasis countdown finishes, the protection field shatters with a loud iron chain breaking sound, and a global server-wide broadcast highlights the exact coordinates for scavenging parties.
• Robust Double-Chest GUI: Interacting with an open or bypassed grave opens a secure 54-slot virtual container. If a player empties the inventory completely, the 3D monument shatters instantly into dust, cleaning up the world dynamically.

⏱️ Advanced Mechanics & Moderation

• Stasis Token Integration: Players holding a dedicated Stasis Token (Nether Star tagged with custom Persistent Data Containers) can right-click their grave to extend the protection countdown by 5 minutes per token, complete with an enchantment glint particle burst.
• Smart Emergency Recovery (/gravetp): Lost your items deep in the Nether or the End? Players can issue a straightforward /gravetp command to safely teleport directly to the base of their most recent active grave plot.
• Administrative Operations Menu (/graves): Staff members gain access to a sweeping cross-server tracking menu. The custom 54-slot UI dynamically populates with the head profiles of all current dead players, displaying exact coordinate maps, lock status, and real-time timers. Admins can click any profile to instantly teleport to the scene.

---

💻 Technical Commands & Reference

Command	Syntax	Description	Permission Node	Default
Grave Teleport	/gravetp	Instantly blink to your newest active grave location.	rvgraves.gravetp	op
Admin Overview	/graves	Open the centralized server-wide grave monitoring panel.	rvgraves.admin	op

🔑 Additional Permission Controls

• rvgraves.admin — Grants total master access: Open any locked player grave directly, use the /graves tracking menu, and utilize Shift + Right-Click Force Bypass to look inside containers or clean up world space instantly.

---

🛠️ Configuration Architecture (config.yml)

RvGraves features a developer-friendly configuration layout allowing server owners to fine-tune timers, tweak layouts, and completely match the styling of their network using advanced MiniMessage parsing.

# The global text prefix applied to standard plugin communications
prefix: "<dark_gray>[<gold>RvGraves</gold>]</dark_gray> "

general:
  # The initial baseline timer (in seconds) before security locks expire
  grave-duration-seconds: 900
  # Automatically drop leftover inventory contents if a grave completely expires?
  drop-items-on-expire: false

hologram:
  # Exact vertical distance block offset above the monument core
  height-offset: 2.1
  # Renders a dark, translucent backing plate behind text lines for readability
  transparent-background: true

effects:
  lightning-on-death: true
  ambient-particles: true
  ambient-sounds: true

gui:
  admin-menu-title: "<dark_red>☠ Active Graves</dark_red>"
  open-sound: "BLOCK_BARREL_OPEN"

messages:
  grave-locked: "<red>This grave is protected by dark magic.</red>"
  grave-unlocked-broadcast: "<red>The grave of <player> has deteriorated at <x>, <y>, <z>!</red>"
  teleport-success: "<green>Teleporting to grave...</green>"
  no-graves-found: "<red>You do not have any active graves.</red>"
  admin-bypass: "<green>Admin bypass triggered.</green>"