Mails

✉️ MailBox

Advanced Player Mail System

By PrabhatPie

MailBox is a premium GUI mail plugin for Paper/Spigot servers with offline & online mail support, important staff mails, PlaceholderAPI support, async database handling, and fully configurable GUIs.

Perfect for SMP, Survival, RPG, Economy, and Community servers.

***

🌟 Features

📬 Mail System

* Send mails to online & offline players * Incoming, Sent & Important mail categories * Persistent mail IDs * Read/unread tracking * Delete mails individually or all at once * Pagination support

***

🖥️ GUI Features

* `/mails` GUI * Incoming Mail GUI * Sent Mail GUI * Important Mail GUI * Read Mail GUI * Remaining Mail Limits button * Fully configurable GUI items & slots

***

⚡ Performance

* Fully async operations * SQLite support * Optional MySQL support * HikariCP connection pooling * Thread-safe systems * Optimized for large servers

***

🔐 Permission-Based Limits

Examples

* `mails.hour.5` * `mails.hour.25` * `mails.day.10` * `mails.day.50`

The plugin automatically detects the highest permission value.

Example

If a player has:

* `mails.hour.5` * `mails.hour.15`

Final limit:

* `15 mails/hour`

***

⭐ Important Mail System

Commands

* `/mail important <player> <message>` * `/mail imp <player> <message>`

Features

* Important Mail category * Glow effects * Sounds * Optional undeletable mails * Join notifications

***

🔔 Join Notifications

Examples

* `You have 3 new mails! Check with /mails` * `You have IMPORTANT mail waiting! Check /mails`

Supports

* Chat * Actionbar * Titles

***

📊 PlaceholderAPI

| Placeholder |Description | | ------------------- |------------------ | | <code>%mailbox_unread%</code> |Unread mails | | <code>%mailbox_total%</code> |Total mails | | <code>%mailbox_important%</code> |Important mails | | <code>%mailbox_sent%</code> |Sent mails | | <code>%mailbox_limit%</code> |Current mail limit | | <code>%mailbox_remaining%</code> |Remaining mails |

***

📜 Commands

| Command |Description | | ---------------------------------- |-------------------- | | <code>/mail <player> <message></code> |Send normal mail | | <code>/mail important <player> <message></code> |Send important mail | | <code>/mail imp <player> <message></code> |Important mail alias | | <code>/mails</code> |Open mailbox GUI | | <code>/mail delete <id></code> |Delete mail by ID | | <code>/mail reload</code> |Reload configs | | <code>/mail clear <player></code> |Clear player mailbox |

***

🔑 Permissions

Default Permissions

| Permission |Description |Default | | -------------- |-------------------------------- |------- | | <code>mail.admin</code> |Unlimited mails & admin commands |OP | | <code>mail.important</code> |Send important mails |OP |

***

Hourly Permissions

* `mails.hour.1` * `mails.hour.2` * `mails.hour.3` * … * `mails.hour.50`

***

Daily Permissions

* `mails.day.1` * `mails.day.2` * `mails.day.3` * … * `mails.day.50`

***

⚙️ Configurable

* GUI items * GUI titles * Messages * Sounds * Limits * Cooldowns * Mail expiration * Important mail settings * Placeholder formatting

***

💾 Database Features

Tables

| Table |Purpose | | ----------- |--------------------------------- | | <code>mails</code> |Stores all player mails | | <code>mail_limits</code> |Stores player limit data | | <code>mail_meta</code> |Stores metadata like last mail ID |

Features

* Persistent IDs * Restart-safe storage * Soft-delete system * Auto cleanup * Async-safe queries

***

🧠 Why Use MailBox?

| Feature |Benefit | | ----------------- |----------------------------- | | GUI Mail System |Easy player experience | | Offline Messaging |Players never miss messages | | Async Database |No server lag | | PlaceholderAPI |Great for scoreboards & menus | | SQLite & MySQL |Flexible storage | | Pagination |Handles large inboxes | | Important Mail |Staff announcements | | Configurable GUIs |Match your server style |

***

🛠️ Compatibility

| Software |Supported | | -------- |--------- | | Paper |✅ | | Spigot |✅ | | Purpur |✅ |

Minecraft Version

* `1.21+`

***

📦 Dependencies

| Plugin |Required | | -------------- |-------- | | PlaceholderAPI |Optional |

***

❤️ Perfect For

* SMP Servers * Survival Servers * RPG Servers * Economy Servers * Towny Servers * Factions Servers * Large Networks

***

👨‍💻 Author

PrabhatPie

Premium-quality Minecraft plugin developer.