Skip to content
Matcha! Mods

Introduction to Courier

Introduction to Courier

Section titled “Introduction to Courier”

Courier is a fully server-side mail system for Cobblemon Fabric servers that lets players send mail with items, Pokemon, currency, and more — even to players who aren’t online. Think of it as an in-game post office that never closes.

Why Courier?

Section titled “Why Courier?”

Players want to trade items and Pokemon with friends who aren’t online at the same time. Courier makes that trivial. A friend mails a rare Pokemon, a gym leader sends badge rewards, an admin distributes event prizes to the entire server — it’s all one command or a few clicks in a clean GUI.

Core Systems at a Glance

Section titled “Core Systems at a Glance”

Courier is built around several focused systems that work together. You don’t need all of them right away — start with basic mail and add complexity as you go.

Mail : Send and receive messages with subjects, bodies, and folder organization. Inbox, Sent, Archive, and Trash — just like a real email client.

Packages : Attach items, Pokemon, currency, and even commands to mail. Recipients claim attachments directly from the mail view.

Presets : Send a reward to your entire server with one command. Define mail templates for welcome kits, event rewards, announcements — create once, send to anyone or everyone.

Package Locker : Overflow storage for when a player’s inventory or party is full. Nothing gets lost.

Notifications : Control how players hear about new mail. Silent, Subtle, Normal, or Prominent — set it per-message or server-wide.

Economy : Attach currency to mail through Impactor API integration or command-based currency systems.

Cross-Server : Redis or NATS message bus support for multi-server networks. Mail sent on one server arrives on another instantly.

Moderation : Built-in rate limiting, player blocking, and input sanitization keep your mail system clean and abuse-free.

Configuration Structure

Section titled “Configuration Structure”

Everything in Courier is configured through HOCON files in your server’s config/courier/ directory:

config/courier/
├── config.conf
├── messages.conf
├── courier_tooltips.conf
├── guis/
│   ├── inbox.conf
│   ├── view.conf
│   └── send.conf
└── presets/
    ├── starter_kit.conf
    └── ...

All changes can be hot-reloaded with /mailadmin reload — no server restart required.

What You’ll Need

Section titled “What You’ll Need”

Required:

  • Minecraft 1.21.1 (Fabric)
  • Fabric Loader 0.17+
  • Fabric API
  • Fabric Language Kotlin
  • Cobblemon 1.6+
  • Ceremony 4.0+

Optional:

  • Impactor (for currency attachments and economy integration)
  • MongoDB or MariaDB (for multi-server shared storage)
  • Redis or NATS (for cross-server mail delivery)

Next Steps

Section titled “Next Steps”

Ready to get started? Here’s the recommended path:

  1. Installation Guide — Get Courier running on your server
  2. Your First Mail — Send your first message and attachment
  3. Mail System — Deep dive into folders, search, and management
  4. Configuration Overview — Customize every aspect of Courier