Messages & Notifications

Every player-facing string lives in the language files under messages: (and labels: / gui:). Placeholders use {token} braces, not %token%.

Two formats

A message can be a simple string or a structured section.

Flat string (chat)

messages:
  bounty-created: "&aPlaced a bounty on {target} for {amount}!"

Structured section

messages:
  bounty-placed-on-you:
    enabled: true
    type: TITLE              # CHAT, TITLE, ACTIONBAR, BOTH, TOAST
    message: "&c{issuer} placed a bounty on you!"
    title: "&c&lBOUNTY!"
    subtitle: "&7Worth &a{amount}"
    fade-in: 10
    stay: 70
    fade-out: 20
    sound:
      enabled: true
      type: ENTITY_PLAYER_LEVELUP
      volume: 1.0
      pitch: 1.0

Delivery types

type	Shows as
CHAT	Chat line (default)
TITLE	Screen title + subtitle
ACTIONBAR	Above the hotbar
BOTH	Chat and title
TOAST	Advancement-style popup

Title timing

fade-in, stay, and fade-out are in ticks (20 ticks = 1 second) and only apply to TITLE / BOTH.

Sounds

Add a sound: block to any structured message. type is a Bukkit Sound name. An unknown name or enabled: false silently disables the sound.

Disabling a message

Set enabled: false on a structured message to suppress it entirely.