SweetMail

# SweetMail A player-friendly graphical mail system that supports attachments such as in-game items, BC cross-server notifications, and cross-server mail viewing and sending. > Default configurations are in Chinese. Check (https://github.com/mcio-dev/localization) repository for English or other language. > And I am sorry about that the wiki is only Chinese available right now. In the future, we may translate it to English. ## Introduction I have tried numerous free, open-source, and paid mail plugins that support item attachments, but none of them met my expectations. I also didn't want to use the mail system built into global market plugins, as they offer too few features. Therefore, I planned to develop a mail plugin that is user-friendly for players and has relatively powerful functionality. **Note**: Please read and modify the content of the configuration file before officially putting this plugin into use. ## Version Features This plugin is built for high versions of Minecraft, and compatibility with lower versions will be maintained as much as possible (planned to support down to `1.8`). Below are the differences between various Minecraft versions: + Starting from `1.13`, the flattening update was implemented, deprecating numeric IDs and Data values (commonly known as sub-IDs). If you need to use the sub-ID feature of older versions, add a colon `:` after the ID, e.g., `WOOL:15`. This plugin no longer supports numeric IDs; please use English IDs instead. + CustomModelData was added starting from `1.14`. This means the CustomModelData option set in older versions will not work for resource pack model predicates. + Starting from `1.19.3`, the Bukkit API added the `Translatable` interface, which allows plugins to obtain the translation key of items, enabling the normal display of original item names. This means older versions will not be able to view the Chinese names of attached items in mail details. For lower versions, please install the prerequisite (https://github.com/NyaaCat/LanguageUtils) to display the original item names. The resource pack interface is only available for Paper and its derivative servers of `1.16+`. For specific details, please (https://plugins.mcio.dev/docs/mail/resourcepack). ## Drafts Any player can have one and only one draft. Use `/mail draft` to create or edit a draft. The `recipient`, `title`, `content`, `attachments`, and other elements of the mail can be edited by clicking in the draft interface. When sending `system mail`, administrators can also set the `sender display name` and configure `broad recipients`, such as: + Players who have logged in within 7 days + All online players on the current server + All online players across the entire server network obtained through the proxy server and so on… Currently, drafts do not support cross-server synchronization. If deployed on multiple server regions, each player will have a different draft in each server region. ## Sent Items/Inbox Players have their own sent items box and inbox, sorted from newest to oldest, with page-turning functionality. The inbox allows viewing the list of unread mails and one-click collection of attachments from unclaimed mails. Administrators can use commands to view the sent items and inbox of other players. ## Documentation For plugin download, usage, and development details, please refer to (https://plugins.mcio.dev/docs/mail/intro) and (https://github.com/MrXiaoM/SweetMail/).