PostMaster

<p align="center"> <img src="https://i.imgur.com/M1b4h7M.png)" alt="logo"/> </p>

<p align="center"> <img src="https://i.imgur.com/fQXL1iB.png" alt="Auction" width="400"/> </p>

<p align="center"> <a href="https://ko-fi.com/nightbeamstudio"> <img src="https://cdn.prod.website-files.com/5c14e387dab576fe667689cf/670f5a0171bfb928b21a7e00_support_me_on_kofi_beige.png" alt="logo" width="300"/> </a> </p>

<p align="center"> <a href="https://discord.gg/TJc3CxR4jK"> <img alt="Discord Server" src="https://img.shields.io/static/v1?label=&message=Discord&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=discord&logoColor=white" /> </a> <a href="https://www.youtube.com/@nightbeamstudio"> <img alt="Nightbeam Studio YouTube" src="https://img.shields.io/static/v1?label=&message=YouTube&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=youtube&logoColor=white" /> </a> <a href="https://github.com/MeherBenSalem"> <img alt="Nightbeam Studio GitHub" src="https://img.shields.io/static/v1?label=&message=GitHub&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=github&logoColor=white" /> </a> <a href="https://www.curseforge.com/members/nightbeamstudio/projects"> <img alt="Nightbeam Studio CurseForge" src="https://img.shields.io/static/v1?label=&message=CurseForge&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=curseforge&logoColor=white" /> </a> <a href="https://modrinth.com/organization/nightbeam"> <img alt="Nightbeam Studio Modrinth" src="https://img.shields.io/static/v1?label=&message=Modrinth&color=ECEBE6&labelColor=2F4858&style=for-the-badge&logo=modrinth&logoColor=white" /> </a> </p>

PostMaster is a lightweight and powerful mailbox plugin for Paper/Folia servers.

Features

- Folia-friendly: Send mail to players whether they're online or offline. - Folia-friendly: Define vouchers redeemable through the mail system. - Folia-friendly: Support for YAML, SQLite, MySQL, and HikariCP-based connections. - Folia-friendly: Built-in inventory-based interfaces for viewing mail, composing messages, and managing vouchers. - Folia-friendly: Expose an API for other plugins and allow easy interoperability. - Folia-friendly: Fine-grained command permissions (`postmaster.use`, etc.). - Folia-friendly: Background tasks handle mail expiration and notification delivery. - Folia-friendly: Fully compatible with Paper and Folia builds.

Installation

1. Place the JAR in your server's `plugins/` folder. 2. Restart or reload the server. 3. Configure `config.yml` to choose your preferred storage and customize messages.

Configuration

The plugin ships with a sample `config.yml` which allows you to adjust storage settings, voucher definitions, and GUI colors. Example voucher files can be found under `vouchers/example-voucher.yml`.

Why PostMaster?

PostMaster offers a smooth in-game experience with minimal configuration. Its modular architecture makes it easy to extend or integrate with other plugins. Whether you're running a small survival server or a bustling network, PostMaster keeps your players connected with reliable mail delivery.