Commands

Commands

Complete reference for all Courier commands.

Player Commands

Commands available to all players with the courier.mail.use permission.

/mail

Open your mailbox GUI.

/mail

The mailbox GUI shows:

• Unread mail count
• List of received mail
• Options to read, claim attachments, delete

/mail send

Open the mail composition GUI to send mail to a player.

/mail send <player>

Arguments:

• player - Username of the recipient

Example:

/mail send Notch

Tip

You can send mail to offline players. They’ll receive it when they next log in.

/mail stats

View your personal mail statistics.

/mail stats

Shows:

• Unread mail count
• Total mail received
• Messages sent today (and daily limit)
• Blocked players count

/mail block

Block a player from sending you mail.

/mail block <player>

Arguments:

• player - Username of player to block

Example:

/mail block SpammerSteve

/mail unblock

Unblock a previously blocked player.

/mail unblock <player>

Arguments:

• player - Username of player to unblock

Admin Commands courier.admin

Admin commands require the courier.admin permission (default: OP level 4).

/mailadmin sendpreset

Send a preset package to players.

/mailadmin sendpreset <target> <preset> [sender]

Arguments:

• target - Who to send to:
  • Player username (single player)
  • online - All online players
  • everyone - All players with mailboxes
• preset - Preset ID to send
• sender (optional) - Custom sender name (default: “System”)

Examples:

# Send starter kit to a player
/mailadmin sendpreset Notch starter_kit

# Send welcome gift to all online players
/mailadmin sendpreset online welcome_gift

# Send event reward to everyone from "Event Team"
/mailadmin sendpreset everyone event_reward Event Team

# Send from an NPC
/mailadmin sendpreset Notch rare_pokemon Professor Oak

Custom Senders

Use custom sender names for:

• NPC mail (“Professor Oak”, “Nurse Joy”)
• Event rewards (“Event Team”, “Staff”)
• Server announcements (“Server Admin”)

/mailadmin reload

Reload preset configurations.

/mailadmin reload

Reloads all files from config/courier/presets/.

/mailadmin listpresets

List all available preset packages.

/mailadmin listpresets

Shows preset IDs and display names.

/mailadmin debug

View debug information for a player’s mailbox.

/mailadmin debug <player>

Arguments:

• player - Player to inspect

Shows:

• Player UUID
• Unread count
• Total mail count
• Messages sent today
• Blocked players count
• Cached inbox IDs

/mailadmin cleanup

Manually trigger expired mail cleanup.

/mailadmin cleanup

Removes all mail past its expiration date.

Note

Cleanup runs automatically every hour by default.

/mailadmin stats

View global mail system statistics.

/mailadmin stats

Shows:

• Presets loaded
• Cleanup interval
• Daily message limit
• Max recipients per message

Command Summary

Player Commands

Command	Description
/mail	Open mailbox
/mail send <player>	Send mail
/mail stats	View stats
/mail block <player>	Block player
/mail unblock <player>	Unblock player

Admin Commands

Command	Description
/mailadmin sendpreset	Send preset
/mailadmin reload	Reload presets
/mailadmin listpresets	List presets
/mailadmin debug	Debug player
/mailadmin cleanup	Force cleanup
/mailadmin stats	Global stats

Permissions

Permission	Default	Commands
courier.mail.use	true	All /mail commands
courier.admin	op (4)	All /mailadmin commands

Tab Completion

All commands support tab completion:

• Player names (online + from usercache)
• Preset IDs
• Special targets (online, everyone)