DeathMessages

# DeathMessages A Paper plugin that recolorizes death, join, and quit messages with per-player toggles and blacklisting. ## Features - **Custom colors** — Set separate MiniMessage colors for death messages (main text, player, killer, weapon), join messages, and quit messages. - **Weapon hover tooltip** — Hover over the weapon name in a death message to see its item tooltip (configurable via `Weapon-Hover`). - **Per-player toggle** — Each player can hide/show all death messages (including their own) or hide/show join/quit messages. Toggle controls what *you* see, not what others see of you. - **Blacklist** — Blacklist a player so you no longer see their death messages. Others still see them, and the blacklisted player still sees their own death. - **Global toggles** — Disable death, join, or quit messages globally via config. - **Cooldown** — Per-player cooldown between death messages (configurable, default 10s). - **Min-playtime** — Only show messages from players who have played for at least N minutes (configurable, 0 = disabled). - **Folia support** — `folia-supported: true`. ## Commands | Command | Aliases | Permission | Description | |---------|---------|------------|-------------| | `/deathmessages reload` | `/dm reload` | `deathmessages.command.reload` | Reload config and user data | | `/deathmessages toggle` | `/dm toggle` | `deathmessages.command.toggle` | Toggle death messages on/off (including your own) | | `/deathmessages blacklist <player>` | `/dm blacklist <player>` | `deathmessages.command.blacklist` | Add/remove a player from your personal blacklist | | `/toggleconnectionmsg` | `/togglejoins` | `deathmessages.command.toggleconnectionmsg` | Toggle join/quit messages on/off for yourself | | `/deathmessagestoggle` | `/dmtoggle`, `/dmt` | `deathmessages.command.toggle` | Shortcut for toggling death messages | ## Permissions | Node | Default | Description | |------|---------|-------------| | `deathmessages.command.toggle` | `op` | Allows toggling death messages | | `deathmessages.command.toggleconnectionmsg` | `op` | Allows toggling join/quit messages | | `deathmessages.command.blacklist` | `op` | Allows blacklisting a player | | `deathmessages.command.reload` | `op` | Allows reloading the plugin | ## Configuration ### `config.yml` ```yaml Colors: Death: Main: "<dark_red>" Player: "<dark_aqua>" Killer: "<dark_aqua>" Weapon: "<gold>" Join: Main: "<gray>" Player: "<gray>" Quit: Main: "<gray>" Player: "<gray>" Settings: Min-Playtime-Minutes: 0 Death-Message-Cooldown-Seconds: 10 Death-Messages: true Join-Messages: true Quit-Messages: true Weapon-Hover: true Commands: DeathMessages: Prefix: '&7&r ' # ... messages ... ``` All colors use (https://docs.advntr.dev/minimessage/). ### `UserData.yml` Stored in the plugin data folder. Automatically created when a player runs a toggle or blacklist command. Contains per-UUID data: - `messages-enabled` (default: `true`) - `connection-messages-enabled` (default: `true`) - `is-blacklisted` (default: `false`) ## Building Requires Java 21 and Maven. ```bash mvn clean package ``` The output jar is `target/DeathMessages-1.0.jar`. ## Requirements - Paper 1.21.11+ (api-version 26.1.2) - Java 21