✉️ 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.