HereDed 💀

A feature-rich Paper Minecraft plugin that tracks player deaths as tributes, broadcasts Hunger Games-style announcements with custom sounds, and provides powerful, configurable death modes with an interactive Admin GUI.

Features

• 📣 Hunger Games Tributes — Plays a dramatic cannon explosion sound to all online players and broadcasts a bold announcement when a player dies: "A tribute has fallen: [Player]".
• ⚙️ Dynamic Death Modes — Configure how player deaths are managed server-wide. Choose between:
  • NORMAL (Vanilla behavior): Standard vanilla death where items and levels drop on the ground.
  • TOMBSTONE: Saves all inventory, armor, and offhand items into a grave chest block at the death location.
    • Tells the player the exact coordinates and world name of their grave.
    • Configurable ownership lock (tombstone.lock-to-owner in config.yml) to prevent other players from looting graves.
    • Fully protected from explosions, piston movements, and hopper extractions.
  • INFINITE: Keep inventory and level upon death with no penalties.
  • HARDCORE: Automatic, instant resurrection but clears the inventory and resets levels to 1.
• 🖥️ Admin GUI — Switch death modes in real-time using an intuitive, interactive inventory-based GUI.
• 📜 Join MOTD & Death Lists — Displays a welcome message (configurable in motd.txt) and broadcasts a list of all tributes that have fallen in the last 24 hours to joining players.
• 💾 Persistent Storage — Saves death history to deaths.json (auto-pruned after 24 hours) and active graves to tombstones.yml so they persist through server reboots.

---

Requirements

• Server: Paper 1.21+
• Java: Java 21+

---

Installation

1. Download the latest HereDed-*.jar from the releases page.
2. Place the JAR file into your server's plugins/ directory.
3. Restart or start your server to generate config files.
4. Customize settings in plugins/HereDed/config.yml and plugins/HereDed/motd.txt as needed.

---

Commands & Permissions

Commands

Command	Alias	Description	Permission
/hereded gui	/hd gui	Opens the Admin GUI to change the death mode.	hereded.admin
/hereded admin	/hd admin	Opens the Admin GUI to change the death mode.	hereded.admin
/hereded status	/hd status	Checks the active death mode, count of active graves, and recent deaths.	hereded.use
/hereded reload	/hd reload	Reloads the configuration, motd.txt, and active tombstones.	hereded.admin

Permissions

• hereded.use (Default: true) — Allows basic command usage (/hereded status).
• hereded.admin (Default: op) — Allows opening the Admin GUI and reloading the plugin configuration.

---

Configuration Files

All configuration files are located in the plugins/HereDed/ folder:

File	Description
config.yml	Main configuration file. Set the default death mode (death-mode: NORMAL) and toggle grave ownership lock (tombstone.lock-to-owner: false).
motd.txt	Custom welcome message shown to players on join. Supports the {player} placeholder.
deaths.json	Auto-generated file containing recent death records. Pruned automatically every 24 hours. Do not edit manually.
tombstones.yml	Auto-generated registry of active tombstones. Do not edit manually.

---

Building from Source

To compile the plugin yourself:

./gradlew build

The compiled JAR will be located in the build/libs/ directory.

---

License

This project is licensed under the GNU General Public License v3.0.