Messages

Every string players see is customizable. They’re all in messages.conf and support MiniMessage formatting.

File: config/courier/messages.conf

Here’s what customizing the login notification looks like:

login {
  header = "<gradient:#FFD700:#FFA500>================================</gradient>"
  unread = "<yellow>You have <white><bold>{count}</bold></white> unread message{plural}."
  hint = "<gray>Type <white>/mail</white> to check your inbox."
  footer = "<gradient:#FFD700:#FFA500>================================</gradient>"
}

When a player logs in with unread mail, they’ll see a gold gradient border with their unread count and a hint to open their inbox.

Sections

The file’s organized by context:

Section	What It Controls
`login`	Login notification (header, unread count, hint, footer)
`delivery`	Mail arrival notifications for each notification level
`success`	Success confirmations (sent, blocked, archived)
`errors`	Player-facing error messages
`adminErrors`	Admin command errors
`info`	Progress and informational messages
`stats`	Stats display (player and admin)
`debug`	Admin debug output
`gui`	In-GUI messages (claimed, archived, deleted)
`guiSend`	Compose GUI messages
`locker`	Package locker messages
`misc`	Miscellaneous (plural suffix, etc.)
`inbox`	Text-mode inbox display

MiniMessage Formatting

Courier uses MiniMessage for all text formatting.

Colors:

<red>Red text</red>
<#FF5555>Hex color text</#FF5555>

Gradients:

<gradient:gold:yellow>Gradient text</gradient>

Styles:

<bold>Bold</bold>
<italic>Italic</italic>
<underlined>Underlined</underlined>
<strikethrough>Strikethrough</strikethrough>

Hover and click events:

<hover:show_text:'<gray>Click to open inbox'><click:run_command:/mail>Click here</click></hover>

Common Placeholders

These work across most message sections:

Placeholder	Description
`{player}`	The current player’s name
`{sender}`	The mail sender’s name
`{recipient}`	The mail recipient’s name
`{subject}`	The mail subject line
`{count}`	Number (unread count, selected count, etc.)
`{seconds}`	Cooldown or time remaining
`{preset}`	Preset name (for admin commands)
`{error}`	Error detail message

Not every placeholder works in every section — Courier resolves them based on context. If a placeholder isn’t relevant (e.g., {sender} in a login message), it won’t be replaced.

Next Steps

Tooltips — customize GUI hover text with templates and fragments
GUI Layouts — adjust slot positions and item appearances