Notifications

Notifications

Players choose how they want to be notified about new mail. Four levels, from completely silent to impossible-to-miss:

Level	What Happens
SILENT	Nothing. Mail sits in the inbox until they check.
SUBTLE	Actionbar message at the bottom of the screen
NORMAL	Chat message (default)
PROMINENT	Title popup + sound effect + chat message

Players set their preference with:

/mail settings notifications <level>

Good Default

NORMAL works well for most servers. It’s noticeable without being annoying — a toast popup appears in the corner and fades on its own. Save PROMINENT for servers where mail often contains high-value items and you really want players to notice.

---

Delivery Notifications

When a player gets mail while they’re online — same server or across the network — they’re notified in real time based on their chosen level:

• SILENT — Nothing happens
• SUBTLE — An actionbar message at the bottom of the screen
• NORMAL — A chat message tells them they’ve got new mail
• PROMINENT — Title popup, a sound effect, and a chat message

You can customize the delivery notification text in messages.conf under the delivery section.

---

Login Notifications

When loginNotification is enabled, players see how many unread messages they have when they join. Great for catching mail that arrived while they were offline.

File: config/courier/config.conf

mail {
  loginNotification = true
  loginNotificationThreshold = 1
}

Setting	What It Does
loginNotification	Show unread mail count on login (true/false)
loginNotificationThreshold	Minimum unread messages before the notification fires

Set loginNotificationThreshold higher if you don’t want to bother players over one or two messages. A value of 5 means the notification only appears when they’ve got 5+ unread messages waiting.

Login notification text is also customizable in messages.conf under the login section.

---

Next Steps

• Moderation & Safety — rate limiting, blocking, and abuse prevention
• Messages Config — customize all notification text and formats