UltimateGraves

** 🪦 UltimateGraves - Complete Plugin Overview --- 📖 Description **UltimateGraves** is a premium, feature-rich grave management system for Minecraft 1.21.1+ servers running on Paper. When players die, instead of losing their items, a grave is created at their death location, storing all inventory contents, armor, and experience points safely. Built with modern Java 21 and the latest Paper API, UltimateGraves offers unparalleled performance, flexibility, and customization. Whether you run a survival server, RPG realm, or hardcore PvP arena, UltimateGraves adapts to your needs with its intelligent protection system, smart location detection, and extensive configuration options. **No more rage-quits from lost items. No more unfair deaths in lava or void. Just peace of mind.** --- 🎯 Core Concept When a player dies: 1. **🔍 Smart Location Detection** - Finds a safe spot (handles void, lava, walls) 2. **📦 Items Secured** - All inventory, armor, and offhand items stored 3. **⚰️ Grave Spawned** - Visual marker placed (player head, hologram, particles) 4. **🔒 Protected** - Configurable protection modes (private, public, timed, PvP, token-based) 5. **🧭 Navigation** - Player receives compass pointing to grave 6. **⏰ Expiration** - Configurable timer before grave becomes public/expires 7. **💰 Economy** - Optional costs for teleportation and retrieval (Vault integration) --- ✨ Key Features Summary | Category | Features | |----------|----------| | **🛡️ Protection** | 5 Protection Modes, Timed Access, PvP Detection, Token System, Guardian Mobs | | **🎨 Visuals** | Player Head Graves, Native Holograms, Particle Effects, Beacon Beams, Glow Effects | | **🗄️ Storage** | SQLite & MySQL Support, Async Operations, HikariCP Pooling, NBT Preservation | | **🧠 Intelligence** | Safe Location Finder, Void/Lava Handling, Soulbound Items, Overflow Management | | **💎 Economy** | Vault Integration, Teleport Costs, Retrieval Fees, Item Refunds | | **🎮 Interaction** | Interactive GUI, Quick Loot, Smart Equip, Compass Tracking, Multi-Click Actions | | **⚙️ Configuration** | 580+ Config Lines, Every Feature Toggleable, Hot Reload, Per-World Settings | | **🔌 Integration** | PlaceholderAPI, WorldGuard, Vault, Developer API, Custom Events | --- 🌟 Detailed Feature Breakdown 🛡️ **Protection System (Strategy Pattern)** **5 Protection Modes:** 1. **PRIVATE Mode** 🔒 - Only the grave owner can access - Admins with bypass permission can open - Perfect for PvE servers 2. **PUBLIC Mode** 🌍 - Anyone can loot the grave - First come, first serve - Ideal for hardcore/anarchy servers 3. **TIMED Mode** ⏰ - Private for X seconds (configurable) - Becomes public after timer expires - Balances fairness and risk 4. **PVP_PVE Mode** ⚔️ - Smart detection: - Killed by player → Public grave (PvP loot) - Killed by mob/environment → Private grave - Perfect for factions/war servers 5. **TOKEN Mode** 🔑 - Requires a custom item (Grave Key) to open - Keys can be sold, rewarded, or crafted - Creates unique economy opportunities --- 🎨 **Visual System (Native 1.21 API)** **Grave Block:** - **Player Head** with owner's skin (default) - OR configurable materials (Netherite Block, Chest, Ender Chest, etc.) - **Glowing effect** with customizable color - **Explosion-proof** and **piston-proof** **Holograms** (TextDisplay Entities - NO PLUGINS NEEDED): ``` ⚰ GRAVE ⚰ Owner: Steve Time: 14m 32s Cause: Fell into Lava Items: 47 ``` - **Live countdown timer** - **Fully customizable lines** - **MiniMessage color support** (gradients, RGB, hex) - **Auto-updates** every second **Particle Effects:** - Rising soul flames (configurable type) - Customizable count, speed, spread - 20+ particle types supported - Adjustable spawn interval **Beacon Beam:** - Visible only to grave owner - Points to grave from distance - Configurable color (RGB) - Adjustable visibility range (64 blocks default) --- 🧠 **Smart Location Algorithm** **The Problem:** Players die in lava, void, inside walls → Graves can't spawn normally **The Solution:** ```java if (death in VOID) { → Scan 10-block radius for solid ground → If none found: Create glass platform at Y=5 } if (death in LAVA) { → Replace lava with Netherite Block → Clear surrounding lava (configurable radius) } if (death in WALL) { → Raycast for nearest air pocket → Spawn grave at safe location } ``` **Configurable Options:** - Search radius (horizontal & vertical) - Void platform height - Lava replacement block - Unsafe block list - Platform creation toggle --- 💎 **Unique "Premium" Features** 1. **Grave Guardian System** 👻 - **Random spawn chance** (default 15%) - Zombie/Skeleton equipped with **player's armor & weapon** - Grave **locked until guardian is killed** - Customizable: - Mob type (Zombie, Skeleton, Wither Skeleton, Piglin Brute) - Health multiplier (default 2x) - Damage multiplier (default 1.5x)