✉️ 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
/mailsGUI- 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.5mails.hour.25mails.day.10mails.day.50
The plugin automatically detects the highest permission value.
Example
If a player has:
mails.hour.5mails.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 /mailsYou 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.1mails.hour.2mails.hour.3- …
mails.hour.50
Daily Permissions
mails.day.1mails.day.2mails.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.
