Smart Mail

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