Post Master is a lightweight and powerful mailbox plugin for Paper and Folia servers. It allows players to send and receive mail whether they are online or offline, manage custom vouchers through inventory-based interfaces, and keep player communication reliable with configurable storage, background expiration handling, and an API designed for integration with other plugins.
| Feature | Description |
|---|---|
| Offline & Online Mail | Send mail to players whether they are currently online or offline |
| Custom Vouchers | Define vouchers that players can redeem through the mail system |
| Multiple Storage Options | Supports YAML, SQLite, MySQL, and HikariCP-backed database connections |
| Inventory-Based GUI | Built-in interfaces for viewing mail, composing messages, and managing vouchers |
| API & Bridge | Exposes an API for other plugins and supports interoperability |
| Permissions Support | Fine-grained permissions such as DonutMail.use |
| Mail Expiration | Background tasks can handle mail expiration automatically |
| Delivery Notifications | Scheduler integration handles mail notification delivery |
| Paper Support | Designed for modern Paper server environments |
| Folia Friendly | Built with Folia compatibility in mind |
| Modular Architecture | Designed to be extended or integrated with other server systems |
| Configurable Experience | Storage, vouchers, messages, and GUI colors can be customized |
Post Master provides an in-game mailbox system that allows players to stay connected even when they are not online at the same time.
Players can send mail to:
Messages remain available through the mailbox system so recipients can access them when they return.
Post Master uses inventory-based interfaces to keep mailbox interactions simple and familiar.
The GUI system includes interfaces for:
This allows players to interact with the core mail system without relying entirely on command-driven workflows.
Post Master includes support for configurable vouchers that can be delivered and redeemed through the mail system.
Voucher definitions can be stored separately, with example voucher configuration available under:
vouchers/example-voucher.yml
This makes the voucher system configurable without requiring changes to the plugin itself.
Post Master supports multiple storage options depending on the needs of the server.
YAML storage provides a simple file-based option suitable for straightforward installations.
SQLite provides local database storage without requiring an external database server.
MySQL can be used when an external database is preferred.
HikariCP-backed connections provide database connection pooling for supported database configurations.
Post Master exposes an API that allows other plugins to integrate with the mailbox system.
The plugin is designed with interoperability in mind, making it possible to connect mail functionality with other server systems and custom plugins.
Post Master supports fine-grained permissions for controlling access to its functionality.
Example:
DonutMail.use
Permissions can be assigned through the server's permission-management setup.
Background tasks are used to manage important mailbox operations without requiring constant manual intervention.
These tasks can handle:
This helps keep the mailbox system organized while ensuring players are informed when relevant mail is available.
Donut Mail is designed as a lightweight mailbox solution for Paper and Folia servers.
Its modular architecture separates mailbox functionality, storage, vouchers, interfaces, scheduling, and integrations so the plugin can remain focused while still supporting more advanced server setups.
Donut Mail ships with a sample config.yml.
Configuration options include:
Example voucher files can be found under:
vouchers/example-voucher.yml
.jar inside your server's plugins/ folder.config.yml.Post Master requires a supported Paper or Folia server.
Configure your preferred storage backend through config.yml.
If you encounter a bug or have a feature request, please join the Discord community or report it through the appropriate project page.
A configurable shard economy and reward foundation for modern servers
Folia-compatible chat formatting plugin for LuckPerms metadata.
A configurable shard economy and reward foundation for modern servers
Folia-compatible chat formatting plugin for LuckPerms metadata.
