Hard Core: The Ultimate Hardcore SMP System

# 💀 HardcoreLeveling

A modern, high-stakes Hardcore revival plugin built exclusively for **Paper 1.21+**. 

Give your players the ultimate adrenaline rush: players can voluntarily commit to Hardcore mode (or server owners can enforce it globally). When a hardcore player falls in battle, their inventory is sealed, and their soul is locked out of the server until their allies embark on a rescue mission to bring them back!

---

## ✨ Key Features

* **Flexible Modes (Opt-in or Global):** 
  * Run it on a regular Survival SMP: Players voluntarily opt-in via `/hardcore` with a **30-day psychological lock**.
  * Run it on Native Hardcore/Hard difficulty: The plugin automatically applies death lockout rules to everyone with zero BossBar clutter.
* **The Afterlife Lockout (Deathban):** Dying cancels the messy death screen and instantly kicks the player, banning them from rejoining until a friend brings them back.
* **Soul Compass Tracking (`/fallen`):** Living players can open an interactive GUI of trapped souls to receive a **Soul Compass** that points directly to the victim's death coordinates—even across different dimensions!
* **The Altar Revival Ritual:** Reviving a friend requires genuine effort. Rescuers must travel to the death site and drop a Totem of Undying onto a consecrated altar.
* **Loot Protection Chest:** No more messy item spills or despawned loot. The altar cleanly summons a **Chest** containing the fallen player's saved gear and inventory.

---

## 🔮 The Revival Ritual

To bring a fallen soul back from the afterlife, a rescuer must:

1. Type `/fallen` and click the dead player's head to receive a **Soul Compass**.
2. Follow the compass to their exact death location (within a 6-block radius).
3. Build the altar structure:
   * Place a **Gold Block** at the base.
   * Place a **Crying Obsidian** directly on top of the Gold Block.
4. **Drop a Totem of Undying** on top of the Crying Obsidian.

[ 🏺 Totem of Undying (Dropped) ]
   [ 🔮 Crying Obsidian            ]
   [ 🟡 Gold Block                 ]

⚡ **Lightning will strike**, the fallen player is unbanned and restored to life, and a chest packed with their gear spawns at the altar!

---

## 📜 Commands & Permissions

| Command | Permission | Description |
| :--- | :--- | :--- |
| `/hardcore` | *None* | Opt-in or opt-out of personal Hardcore mode (requires confirmation code). |
| `/fallen` | *None* | Opens the GUI list of trapped souls to obtain tracking compasses. |
| `/adminrevive <player>` | `hardcoreleveling.admin` | Force-revives a dead player and resets their deathban status. |
| `/adminhardcore <player> <on\|off>` | `hardcoreleveling.admin` | Force-enables or disables hardcore mode for a specific player. |

---

## ⚙️ Requirements & Installation

* **Server Platform:** Paper 1.21+ (Compatible with 1.21.1+)
* **Java Version:** Java 21+
* **Dependencies:** None! Fully standalone (no Vault or external libraries required).

### Installation:
1. Drop the `HardcoreLeveling.jar` into your server's `plugins` folder.
2. Restart your server.
3. Configure your permissions as needed and begin your hardcore journey!