🪦 Better Revive

A Complete Death & Revive System for Minecraft

Better Revive transforms death in Minecraft into a meaningful, recoverable event.
When you fall, your items don't scatter into the void — they're stored safely inside a grave.
Your friends can bring you back with magical revive potions, and a mystical compass will always guide you home.

⚖️ Built for SMP servers — carefully balanced for PvP, teamwork, and fair recovery.

---

⚔️ Core Features

🪦 The Grave System

When you die, an invisible grave manifests at your death location — marked by your floating player head and a live countdown timer.

• 🔒 Persistent First Grave — your first grave is permanent until collected or destroyed.
• ⏳ Temporary Backup Grave — if you die again mid-recovery, a second grave appears only during your death screen, allowing teammates to still revive you.
• 🎒 Full Inventory Storage — armor, hotbar, offhand, everything.
• 🖱️ Right-click to recover all items instantly.
• ⚠️ If the timer runs out → items drop publicly for anyone to grab.

---

💀 Hardcore Mode Support

Play Hardcore with your friends and get one last chance. Enter the Downed State when you die — if a teammate revives you in time, you survive.

---

📜 Resurrection Scroll

A rare, magical scroll that teleports you directly to your active grave.

Perfect for escaping dangerous dimensions, deep caves, or lava-filled catastrophes.

---

💊 Revive Potions — 3 Tiers

Brew special potions and revive fallen teammates straight from their death screen — no respawn required.

Tier	Healing	Debuffs	Debuff Duration
Revive Potion I	❤ 1 Heart	Slowness, Hunger, Weakness	30s
Revive Potion II	❤❤❤ 3 Hearts	Slowness, Hunger, Weakness	15s
Revive Potion III	❤❤❤❤❤ 5 Hearts	None!	—

How It Works

1. 💀 A player dies → their grave appears.
2. 🧪 A teammate throws a Revive Potion at the grave.
3. 🖥️ The dead player sees Accept / Decline buttons on their death screen.
4. ✅ Accept → teleported back with full inventory + tier-based debuffs.
5. ❌ Decline → normal respawn, grave stays intact for manual pickup.

---

🧭 The Grave Compass

After a normal respawn, you automatically receive a Grave Compass — enchanted with Lodestone tracking.

• ➡️ Always points toward your grave.
• 📏 Shows direction + distance in the action bar:
  ☠ Grave: ⬆ 145m (Y: 64)
• 🖱️ Right-click to open the Grave Contents Screen — preview every item inside.
• 💥 Dissolve your grave remotely — drop all items publicly for looters.
• 🌌 Works across dimensions — displays "Other Dimension" if your grave is in the Nether or End.
• 🔗 The compass cannot be dropped and is removed automatically when the grave is collected, dissolved, or expires.

---

🔥 Instant Death Mechanics

Some deaths are simply unrecoverable — no grave, no revive, no second chances.

• 🌋 Lava Death → instant permanent death, no grave spawns.
• 💀 Void Death → items are lost, no grave can be placed.

⚠️ This keeps high-risk zones actually risky — no cheesing lava lakes or the void with infinite revives.

---

⏱️ Revive Cooldown (Anti-Spam)

After being revived, a Revive Lock (default 60s, configurable) prevents instant re-revives.

• 🔵 Lock timer shown in the action bar and on the grave itself.
• 🚫 Potions thrown during the lock notify both players with remaining time.

---

🧪 Recipes

🍶 Brewing

Potion	Base	Ingredient
Revive Potion I	Splash Potion	Golden Apple
Revive Potion II	Revive Potion I	Honeycomb
Revive Potion III	Revive Potion II	Blaze Rod

🛠️ Crafting

• Resurrection Scroll — 1x Paper (center) surrounded by 8x Revive Potion III in a Crafting Table.

---

🔧 Admin Commands

All commands require OP level 2.

Command	Description
/betterrevive cooldown	Show current revive lock duration
/betterrevive cooldown <seconds>	Set revive lock duration (0–600s)
/betterrevive graveduration	Show current grave duration
/betterrevive graveduration <seconds>	Set grave duration (30–3600s)
/betterrevive xp	Show XP retention percentage
/betterrevive xp <percentage>	Set XP retention (0–100%)
/betterrevive info	Show all settings + color legend
/betterrevive cleanup	Remove orphaned grave display entities

⚙️ Config File

Better Revive creates a server config at:

config/better_revive.json

The config persists across restarts and lets server owners tune revive timing, grave behavior, XP recovery, and debugging.

{
  "cooldownSeconds": 60,
  "graveDurationSeconds": 180,
  "xpPercentage": 100,
  "forceLoadGraveChunks": false,
  "graveTextUpdateIntervalTicks": 20,
  "debugLogging": false
}

Setting	Description
cooldownSeconds	Revive Lock duration after a player has been revived.
graveDurationSeconds	How long a grave stays protected before it expires and drops its contents publicly.
xpPercentage	How much XP is stored inside the grave and restored.
forceLoadGraveChunks	If enabled, the chunk containing a grave stays force-loaded so the grave timer and display can continue updating even when no player is nearby. Disabled by default for better server performance.
graveTextUpdateIntervalTicks	How often the floating grave text updates. Minimum: 20 ticks / 1 second.
debugLogging	Enables extra server log output for debugging.

⚠️ For most servers, forceLoadGraveChunks should stay disabled unless you specifically want graves to keep ticking while nobody is nearby.

---

🎮 Gameplay Scenarios

🟢 Scenario 1 — Normal Death

1. You die → grave appears → death message with coordinates.
2. You respawn → receive a Grave Compass.
3. Follow the compass → right-click the grave → items restored to original slots.
4. Compass vanishes automatically.

🔵 Scenario 2 — Revived by a Teammate

1. You die → grave appears.
2. Teammate throws a Revive Potion.
3. You see Accept / Decline on your death screen.
4. Accept → teleport back with items + debuffs.
5. 60s Revive Lock begins.

🔴 Scenario 3 — The Grave Expires

1. You die → grave appears with countdown.
2. Timer expires → items drop publicly.
3. Compass is removed → notification sent.
4. Anyone can loot the drops.

---

🌍 Multi-Dimension Support

• ✅ Works in Overworld, Nether, and End.
• 🧪 Revive Potions must be thrown in the same dimension as the grave.
• 🧭 Compass shows "Other Dimension" across worlds.
• 🌀 Revive teleportation works across dimensions.

---

📋 Technical Details

Property	Value
Mod Loader	Fabric / NeoForge
Server-side	✅ Yes
Client-side	✅ Required (death screen UI + compass HUD)
keepInventory	✅ Respected — graves won't spawn if enabled

---

🔌 Mod Compatibility

Better Revive plays nicely with popular inventory-extending mods:

• ✅ Accessories Mod — accessory slots are safely stored in the grave NBT and fully restored.
• ✅ Trinkets & Curios Mod — trinket slots handled separately and restored on revive or grave collection.
• 🧭 The Grave Compass is protected from vanilla inventory drops — it will never be lost on re-death.

---

🗣️ Language Support

• 🇬🇧 English (default)
• 🇩🇪 German
• 🌐 All strings fully translatable — contributions welcome!

---

💡 PvP Balance Philosophy

Better Revive was engineered for competitive servers:

• 🛡️ Revive Lock prevents revive-spam in extended fights.
• ⚔️ Tier-based debuffs make cheap revives a real risk (1 HP + Slowness + Weakness).
• 🎯 Revives only work during the death screen — no post-respawn cheese.
• 🤝 Accept/Decline prevents unwanted revives.
• 🔒 Dead players cannot collect items before deciding — no exploit vectors.
• ⏳ Graves have a time limit — no permanent storage abuse.
• 🌋 Lava & void deaths are final — no grave, no recovery. High-risk zones stay high-risk.

---

🚀 Roadmap

Version	Feature
1.1.0	⚡ Performance Optimization (server-side grave handling)
1.1.5	📜 New Revive Scroll Item
1.1.6	🎨 New Revive Potion Texture
1.1.7	🔧 NeoForge Port
1.1.7	🎨 New Revive Texture
1.2.5	🐛 Major Bug Fixes
2.0.0	💀 Hardcore Support

---

❤️ Credits & Links

Made with ❤️ by Mrstilu2k6

🔗 Modrinth · 🔗 CurseForge · ☕ PayPal

---

💬 Found a bug? Have a suggestion? Drop it in the comments or open an issue — every piece of feedback helps shape the 2.0 update!

☕ Enjoying the mod? If you'd like to support my work, a small tip is greatly appreciated. Every bit of support helps me dedicate more time to updates and new features!