✉ SmartMail
A simple, immersive in-game mail system for Paper & Spigot.
What is SmartMail?
SmartMail lets players send letters and item packages to each other through a clean GUI — no chat commands, no hassle.
Open your inbox, read your mail, attach items, and track whether your letter was delivered and read. Everything runs off the main thread for minimal server impact.
Features
📩 Compose GUI
Run /mail send to open a chest GUI where you can write mail and attach items. No accidental sends.
📦 Delivery Tracking
Every letter shows its status:
SENT → DELIVERED → OPENED
Status updates automatically when the recipient logs in.
🎁 Item Attachments
Attach items directly to mail. If sending fails for any reason, attached items are safely returned.
🗃️ Return to Sender
Letters and unclaimed attachments can be returned to the original sender with a single button.
🔔 Notifications
Players receive notifications when new mail arrives:
- Chat message
- Sound effect
- Action bar reminder
Online players are notified instantly.
👀 Unread Glow
Unread letters glow in the inbox, making them easy to identify.
📫 Paginated Inbox
Supports unlimited mail with:
- Previous/Next page navigation
- Unread mail counter
- Empty mailbox placeholder
Commands
/mail
Open your inbox.
/mail send
Open the compose window.
/mail reload
Reload the plugin configuration (admin).
Permissions
smartmail.use
Open inbox and receive mail.
smartmail.send
Send mail to other players.
smartmail.admin
Reload configuration.
Storage & Performance
SQLite + WAL Mode
Optimized database storage with fast reads and writes.
Automatic Database Migration
Database updates are handled automatically on startup.
Fully Asynchronous
All database operations run off the main server thread.
Configuration
Everything can be customized through config.yml and reloaded using /mail reload.
Configurable options include:
- GUI titles
- Mail materials
- Unread glow effects
- Sounds
- Notifications
- Action bar messages
- Border materials
Planned Features
The architecture is designed for future expansion.
Upcoming additions may include:
- NPC Postman deliveries
- Reply button
- Mail expiration
- Inbox limits
- Read receipts
- Mail blocking
Support
SmartMail is completely free and actively maintained.
If you encounter a bug or have a feature suggestion, please contact me before leaving a negative review. Most issues can be fixed quickly once reported.
Discord Support: https://discord.com/invite/SDp6N7PhhG
Every report is read and taken seriously.
