Skip to content

Leave Messages

iSAlexHere edited this page Aug 25, 2026 · 2 revisions

Leave Messages

A Leave Message is a custom, styled line broadcast in chat when the player leaves the server. It's a full cosmetic type — owned in the vault and equipped from /cosmetics — and works exactly like Join Messages, mirrored onto the quit event.

Leave Messages are opt-in only. If a player has one equipped, it replaces the normal quit broadcast. If they have nothing equipped, the player leaves in complete silence — no vanilla "X left the game" text, no filler message, nothing. Only players who actually equipped a Leave Message cosmetic broadcast anything.

Delivery bypasses bukkit.broadcast.user entirely (the message is sent directly to every online player), so it reaches everyone even on servers whose permission plugin locks that permission down to OPs.

Configuration (leavemessages.yml)

leave-messages:
  royal:
    display: "&6Royal Departure"                          # shown in menus
    value: "&6&l« &fFarewell, &6&l{player}&f. &6&l»"      # the broadcast
    icon: GOLDEN_HELMET
    permission: celestial.cosmetics.leavemessage.royal
  fade:
    display: "&7Quiet Fade"
    value: "&7{player} &8has left the realm"
    icon: PAPER
    permission: celestial.cosmetics.leavemessage.fade
Field Required Meaning
display yes Name shown in menus
value yes The message broadcast on leave. Supports & codes, &#RRGGBB hex, and {player}
icon yes Menu icon material (or PLAYER_HEAD + texture:)
permission no Defaults to celestial.cosmetics.leavemessage.<id>

The {player} placeholder

Use {player} anywhere in value and it's replaced with the leaving player's name. You can place it more than once, or omit it entirely.

Equipping

  • Players: open /cosmetics, pick the Leave Message category, click one you own.
  • Admins: /cosmetics set <player> leavemessage <id> / /cosmetics clear <player> leavemessage.

Notes

  • Same mechanic as Join Messages: the plugin reads the player's selection directly from the database (not the in-memory cache) so it works reliably even right as the player disconnects.
  • Category toggle: categories-enabled.leavemessage in config.yml.

Next: Chat Emojis

Clone this wiki locally