# SyMessage<\/p>\n
A system mailbox plugin for Minecraft Purpur\/Paper 1.21+<\/p>\n
**Author**: Shiyuan
\n**Version**: 1.0.0
\n**Java Version**: 21<\/p>\n
## Features<\/p>\n
– \ud83d\udcec **Player Mailbox GUI** – Type `\/sym open` to open mailbox and view unread messages
\n– \ud83d\udcb0 **Reward Distribution** – Click messages to automatically claim attached currency rewards
\n– \ud83d\udd14 **Login Reminder** – Automatic reminder for unread messages after player login (configurable delay)
\n– \ud83d\udc68\u200d\ud83d\udcbc **Admin Panel** – `\/sym op` to view message delivery status for all players
\n– \ud83d\udce4 **Mass Messaging** – Send messages with rewards to all\/online\/specific players
\n– \ud83d\udc8e **Vault Integration** – Currency rewards via Vault plugin
\n– \u23f0 **Auto Cleanup** – Automatically clean up expired messages (configurable retention days)<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/sym open` | Open system mailbox to view and claim unread messages | `symessage.use` |<\/p>\n
### Admin Commands<\/p>\n
| Command | Description | Permission | #### Target Types<\/p>\n – `all` – All players (including offline) #### Usage Examples<\/p>\n “` ## Configuration (config.yml)<\/p>\n “`yaml # Cleanup task interval (hours), how often to check and clean expired messages # Unread message reminder delay (seconds), how long after login to remind about unread messages ## Build & Installation<\/p>\n ### Requirements<\/p>\n – JDK 21+ ### Build<\/p>\n “`bash Build artifact located at `target\/SyMessage-1.0.0.jar`<\/p>\n ### Installation<\/p>\n 1. Place `SyMessage-1.0.0.jar` into server’s `plugins` directory ## Dependencies<\/p>\n – **Paper\/Purpur 1.21+** ## Permissions<\/p>\n | Permission | Description | Default | ## File Structure<\/p>\n “` ## License<\/p>\n MIT License<\/p>\n","protected":false},"excerpt":{"rendered":" A system mailbox plugin for Minecraft Purpur\/Paper 1.21+<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"symessage","_minecraft_project_id":"jvrpbaMF","_minecraft_author":"Shiyuan","_minecraft_license":"MIT","_minecraft_downloads":9,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"symessage.zip","_minecraft_size_bytes":67635,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:12:24.377380Z","_minecraft_date_created":"2026-04-03T22:26:39.857928Z","_minecraft_date_modified":"2026-05-09T12:18:54.806256Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/symessage","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-09T03:17:23+00:00","_minecraft_import_hash":"5f97434f17188780fc24c39368e0af62","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,126,127,128,867,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-151413","mod","type-mod","status-publish","hentry","mod_category-economy","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/sym send
\n| `\/sym op` | Open admin panel | `symessage.admin` |
\n| `\/sym reload` | Reload configuration file | `symessage.admin` |<\/p>\n
\n– `online` – Online players only
\n– `player:username` – Specific player<\/p>\n
\n\/sym send all Server maintenance notice: Update at 22:00 tonight 50
\n\/sym send online New event started! Come join! 100
\n\/sym send player:Steve Your VIP renewal is successful 500
\n“`<\/p>\n
\n# Message retention time (days), messages older than this will be automatically cleaned up
\nmessage-save-days: 30<\/p>\n
\ncleanup-interval-hours: 24<\/p>\n
\nreminder-delay-seconds: 60
\n“`<\/p>\n
\n– Maven 3.6+<\/p>\n
\nmvn clean package
\n“`<\/p>\n
\n2. Install Vault plugin and any economy plugin (e.g., EssentialsX, CMI, etc.)
\n3. Restart server or load plugin<\/p>\n
\n– **Vault** (Optional, economy features unavailable without it)<\/p>\n
\n|————|————-|———|
\n| `symessage.use` | Use basic commands | All players |
\n| `symessage.admin` | Use admin commands | OP |<\/p>\n
\nplugins\/SyMessage\/
\n\u251c\u2500\u2500 config.yml # Configuration file
\n\u251c\u2500\u2500 messages.yml # Message data storage
\n\u2514\u2500\u2500 …
\n“`<\/p>\n