✉️ 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 |
| ------------------- |------------------ |
| %mailbox_unread% |Unread mails |
| %mailbox_total% |Total mails |
| %mailbox_important% |Important mails |
| %mailbox_sent% |Sent mails |
| %mailbox_limit% |Current mail limit |
| %mailbox_remaining% |Remaining mails |

---

📜 Commands

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

---

🔑 Permissions

Default Permissions

| Permission |Description |Default |
| -------------- |-------------------------------- |------- |
| mail.admin |Unlimited mails & admin commands |OP |
| mail.important |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 |
| ----------- |--------------------------------- |
| mails |Stores all player mails |
| mail_limits |Stores player limit data |
| mail_meta |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.