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

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:

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.