💀 Hardcore Respawn(HCR)

A powerful, Paper/Spigot plugin that re-imagines the Hardcore experience – die once, and you are really gone…​ unless your friends have a Revival Token!

---

🚀 Features

	Description
🧿 Revival Token	Craftable item (fully configurable recipe) that allow players to revive the fallen.
📜 /hcr Command Suite	Give tokens, open the recipe configurator, or reload the plugin – all in one parent command.
🖼️ Beautiful GUIs	Paginated list of dead players with custom skulls, smooth animations and one-click revive destinations (bed, spawn, eye-look, death-coords).
⚡ Zero-Lag Utilities	Optimised caching, asynchronous tasks and more to ensure TPS friendly performance.
🔄 Hot Reload	Change the recipe or config on the fly – /hcr reload seamlessly unloads & registers new recipes for every online player.
⚰️ Death Chests	Automatically stores the victim's items in an obsidian-protected chest near the death spot – search radius fully configurable.
🪂 Safe Teleport	Intelligent teleporter finds the closest solid ground (no water/void) or creates a fallback obsidian platform when reviving.
⏱️ Platform Timer	Obsidian platform spawns under the revived player and despawns after they leave, with an in-actionbar progress bar, colour shift & tick sounds.
✨ Auto Potion Effects	Configurable resistance / regen / absorption etc. are re-applied every second while the player stands on the platform.

---

📦 Installation

1. Compile the latest HCR-x.x.jar.
2. Drop it into your server’s plugins/ folder.
3. Restart or /reload the server – that’s it! 🎉
4. (Optional) Edit config.yml to tweak debug mode, GUI shuffle interval or the token recipe.

Minimum requirements
• Java 17+
• Paper / Spigot 1.21.5
• SpiGUI is shaded automatically – no extra dependencies needed.

---

🕹️ Commands

Command	Permission	Description
/hcr	hcr.use	Root command – shows interactive help.
/hcr giveToken <player> [amount]	hcr.givetoken	Give one or more Revival Tokens.
/hcr configureRecipe	hcr.configurerecipe	Opens the drag-&-drop recipe editor GUI.
/hcr reload	hcr.reload	Saves config, clears caches and reloads the plugin without rebooting the server.

---

🔧 Configuration

config.yml ships with sensible defaults but is 100 % editable:

debug: false # Extra console spam for troubleshooting
config_gui_shuffle_interval: 10 # How often the recipe GUI glass panes shuffle (ticks)
effect_duration: 1200 # Revival effect's duration
delete_platform: true # Should we delete platform after revive?
death_chest: true # Should we store items in chest after player death?
death_chest_search_radius: 20 # How far should we search for a valid chest location before giving up.
safe_teleport_search_radius: 20 # How far should we search for a valid teleport location before giving up.
recipe: # 3×3 crafting grid, top-left → bottom-right
  - AIR
  - DIAMOND
  - AIR
  - DIAMOND
  - NETHER_STAR
  - DIAMOND
  - AIR
  - DIAMOND
  - AIR

Change any material to whatever you like.
If the recipe is invalid or entirely AIR, HCR safely rolls back to the default ✨

---

💻 Building from Source

# Clone & build
git clone https://github.com/your/repo.git && cd HCR
mvn clean package
# The shaded jar will be in target/HardcoreRespawn-Reworked-*.jar

The project uses Java 21, Maven 3.8+, and automatically shades SpiGUI & SkullCreator.

---

🙌 Contributing

PRs & feature requests are welcome!
Please open an issue first to discuss major changes.

1. Fork the repository
2. Create your feature branch: git checkout -b feat/amazing-feature
3. Commit your changes: git commit -m 'feat: add amazing feature'
4. Push to the branch: git push origin feat/amazing-feature
5. Open a Pull Request

---

📝 License

Distributed under the MIT license.

---

Made with ❤️ & ☕ by **(diamondpixel/Liparakis/Takys)**