ReviveSystem

# ReviveSystem v2.0 **A full-featured revival system for Minecraft Hardcore and Semi-Hardcore servers.** ReviveSystem gives dead players a second chance — but only through teamwork and strategic decisions. When a player dies, they aren't permanently eliminated. Instead, they enter Spectator Mode and must wait for another player to bring them back. This keeps the Hardcore feeling intact while preventing frustration from permanent death. > **Compatible with:** Paper, Spigot, Bukkit — Minecraft 1.21 through 26.2+ --- ## Table of Contents 1. (#how-it-works--step-by-step) 2. (#the-head-mechanic-bonus-hearts) 3. (#items--crafting-recipes) 4. (#all-commands) 5. (#all-permissions) 6. (#full-configuration-guide) 7. (#language--messages) 8. (#installation-guide) 9. (#frequently-asked-questions) 10. (#troubleshooting) --- ## How It Works — Step by Step Here's exactly what happens during a typical gameplay session: ### 1. A Player Dies When a player dies in your world, three things happen automatically: 1. **Their head drops** as a physical item at their death location (a Player Head with their skin). 2. **They enter Spectator Mode** — they can fly around and watch, but they cannot interact with the world, break blocks, or chat commands that affect gameplay. 3. **A death info screen appears** — a GUI window showing their Level and total Playtime, which automatically closes after 5 seconds (configurable). The player is now "dead" and waiting for revival. ### 2. How to Revive a Dead Player There are **two ways** to bring a dead player back: #### Method A: The Respawn Point (Player Head on Soul Sand) - Another player picks up the **dead player's dropped head**. - They surround it with **Soul Sand** in a crafting table (head in center, soul sand all around). - This creates a **Respawn Point** — a special head item. - When they **place this head on the ground**, the dead player is teleported to that location and revived. - The placed head disappears after 2 seconds. #### Method B: Admin Command - A server admin or operator can use the command `/revive <playername>` to instantly revive any dead player. ### 3. After Revival - The player returns to **Survival Mode** with the configured amount of health (default: full 10 hearts). - Their death count and revival status are saved. Depending on the server configuration, they can be revived up to a certain limit or infinitely. - All their progress (XP, items they had) follows normal Minecraft death rules. --- ## The Head Mechanic (Bonus Hearts) This is a separate, optional feature that works alongside the revive system: - When a player **picks up a dropped player head** (from someone's death) and **puts it on as a helmet**, they receive **+20 bonus hearts** (10 extra full hearts, for a total of 20 full hearts). - A chat message tells them about the bonus hearts. - The **"Kopf hoch!" advancement** is awarded (appears as a toast notification). - A level-up sound plays. - When the player **takes the head off**, their hearts go back to normal (10 full hearts). - The bonus hearts amount, sound, and volume are all configurable. ### Head Protection Dropped player heads are valuable revival tokens. By default, they **can** be destroyed by lava and explosions. You can change this in the config: - `head.kill-at-lava: false` → Heads survive lava - `head.kill-at-explosion: false` → Heads survive explosions (TNT, Creepers, etc.) --- ## Items & Crafting Recipes ### Respawn Point | Property | Value | |----------|-------| | **Base Item** | Player Head (with dead player's skin) | | **Display Name** | §bRespawn Point of | | **Effect** | Place to revive the specific player | **Crafting Recipe:** ``` ``` Place a dead player's dropped head in the center, surrounded by 8 Soul Sand blocks. --- ## All Commands | Command | Description | Permission | |---------|-------------|------------| | `/revive` | Shows help and available commands | Everyone | | `/revive <player>` | Revives a dead player instantly | `revivesystem.use` | | `/revive reload` | Reloads config and messages without server restart | `revivesystem.admin` | | `/rev` | Alias for `/revive` | Same as `/revive` | ### Command Examples ``` /revive Steve → Revives the player "Steve" /revive reload → Reloads all configuration files /rev Alex → Short form: revives "Alex" ``` --- ## All Permissions | Permission | Description | Default | |------------|-------------|---------| | `revivesystem.use` | Allows using the `/revive <player>` command | Everyone | | `revivesystem.head` | Allows using the Head Mechanic (bonus hearts) | Everyone | | `