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