Skip to content

Commands

Complete reference for all Courier commands.

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

Open your mailbox GUI.

/mail

The mailbox GUI shows:

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

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

/mail send <player>

Arguments:

  • player - Username of the recipient

Example:

/mail send Notch

View your personal mail statistics.

/mail stats

Shows:

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

Block a player from sending you mail.

/mail block <player>

Arguments:

  • player - Username of player to block

Example:

/mail block SpammerSteve

Unblock a previously blocked player.

/mail unblock <player>

Arguments:

  • player - Username of player to unblock

Admin Commands courier.admin

Section titled “Admin Commands ”

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

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

Reload preset configurations.

/mailadmin reload

Reloads all files from config/courier/presets/.

List all available preset packages.

/mailadmin listpresets

Shows preset IDs and display names.

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

Manually trigger expired mail cleanup.

/mailadmin cleanup

Removes all mail past its expiration date.

View global mail system statistics.

/mailadmin stats

Shows:

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

Player Commands

CommandDescription
/mailOpen mailbox
/mail send <player>Send mail
/mail statsView stats
/mail block <player>Block player
/mail unblock <player>Unblock player

Admin Commands

CommandDescription
/mailadmin sendpresetSend preset
/mailadmin reloadReload presets
/mailadmin listpresetsList presets
/mailadmin debugDebug player
/mailadmin cleanupForce cleanup
/mailadmin statsGlobal stats
PermissionDefaultCommands
courier.mail.usetrueAll /mail commands
courier.adminop (4)All /mailadmin commands

All commands support tab completion:

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