Introduction to Courier

Courier is a fully server-side mail system for Cobblemon servers. Players can send mail to each other with item and Pokemon attachments, even when recipients are offline.

What is Courier?

Courier provides a complete in-game mail system with:

GUI-based mailbox interface
Item and Pokemon attachments
Cross-server support via Redis/NATS
Admin preset packages for rewards and events
Rate limiting and moderation tools

Key Features

Player Mailbox

Send mail to any player (online or offline)
Attach items and Pokemon
Read, claim attachments, delete messages
Block unwanted senders

Package Presets

Admin Feature

Pre-configured reward packages
Send to individuals, online players, or everyone
Custom sender names for NPCs/events
JSON/HOCON configuration

Cross-Server

Redis or NATS message bus support
Shared MongoDB database
Real-time mail delivery across servers
Distributed rate limiting

Moderation

Per-player rate limits (daily/hourly)
Player blocking system
Audit logging
Admin debug tools

How It Works

Open Mailbox: Players use /mail to open their inbox GUI
Send Mail: Use /mail send <player> to compose a message
Attach Items: Add items from inventory and Pokemon from party/PC
Receive Mail: Recipients get notified on login and can claim attachments
Claim Attachments: Items go to inventory, Pokemon go to party/PC

Admin Features

Server admins can:

Send preset packages to players with /mailadmin sendpreset
Create custom package presets with items and Pokemon
Specify custom sender names (for NPCs, events, etc.)
View player mailbox debug info
Force cleanup of expired mail

Use Cases

Welcome Packages: Send starter kits to new players
Event Rewards: Distribute prizes to participants
Player Trading: Secure item/Pokemon exchange when offline
Server Announcements: Send packages to all players
NPC Integration: Have NPCs “send” mail to players

Commands Overview

Player Commands

Command	Description
`/mail`	Open your mailbox
`/mail send <player>`	Send mail to a player
`/mail stats`	View your mail statistics
`/mail block <player>`	Block a player
`/mail unblock <player>`	Unblock a player

Admin Commands OP Level 4

Command	Description
`/mailadmin sendpreset <target> <preset> [sender]`	Send a preset package
`/mailadmin reload`	Reload preset configurations
`/mailadmin listpresets`	List available presets
`/mailadmin debug <player>`	View player mailbox debug info
`/mailadmin cleanup`	Remove expired mail
`/mailadmin stats`	View global mail stats

Getting Started

Installation Guide Get Courier running on your server

Configuration Configure the mail system

Preset Packages Create custom reward packages

Preset Builder Interactive preset configuration builder