# Notice > **We are currently rewriting the plugin from scratch to add database support, etc. The test version provided in the alpha branch may be unstable. Please be sure to make a backup before running it.** > > **All documentation below is for the old version before the rewrite. This will be updated in the future.** # MailBox The mailbox implements a mail system like those found in smartphone games. You can customize the behavior when clicking on a mail, and you can attach reward items or execute commands. ## Depencies [Paper](https://papermc.io/downloads/paper) `1.21.x` Only ## Commands - `/mailbox` Open mailbox menu. - `/mailbox reload` Reloads config and messages. - `/mailbox clear ` Clear target's all mail. - `/sendmail (|schedule )` - `` example: `stone[enchantments={levels:{infinity:0}}]`
Same as vanilla ItemStack argument. [wiki](https://minecraft.wiki/w/Argument_types#minecraft:item_stack) - `` example: `"mail title"` `'{"text":"something"}'`
Same as vanilla Raw JSON Format [wiki](https://minecraft.wiki/w/Raw_JSON_text_format) - `` exmaple: `["","line1","line2"]` Same as ``, but only chlidren are shown. - `` example: `'{"action":"","value":"","used":false}'` - `` Type of action. - `none`: Do nothing. - `close`: Closes mailbox menu - `reward_item` Give a reward item to player. - `run_command` Run a command as player. (execute like this `execute as run `) - `` Value for action. - When `` is `none` or `close` ignore this ``. - When `` is `item`, `` is same as vanilla ItemStack argument. [wiki](https://minecraft.wiki/w/Argument_types#minecraft:item_stack) - When `` is `run_command`, `` is a command. (`/` is not required.) - DO NOT CHANGE `used` field
The plugin uses `used` field to check player already clicked the mail.
If this field are set `true`, all players will receive the mail as clicked. - `` Player. You can use target selector [wiki](https://minecraft.wiki/w/Target_selectors) - `schedule ` Sends an email to all players who are online by the specified time. - `` Time to end sending email. [ISO_DATE_TIME](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/time/format/DateTimeFormatter.html#ISO_DATE_TIME) format `yyyy-mm-ddThh:MM:ss` ## Configuration ```yaml _version: 3 // DONOT CHANGE mail-schedules: - enabled: true name: '"test mail"' description: '{"extra":["hello!","this is test mail!!"],"text":""}' start: '2024-08-09T17:38:45' end: '2024-08-09T19:00' item: minecraft:shulker_box action: '{"action":"reward_item","value":"diamond","used":false}' - enabled: true name: '"login bonus"' description: '{"extra":["hello!","this is date exclusive login bonus!!"],"text":""}' start: '2024-08-09T00:00:00' end: '2024-08-09T23:59:59' item: minecraft:chest[enchantments={levels:{infinity:0},show_in_tooltip:false}] action: '{"action":"reward_item","value":"/give @s emerald 64","used":false}' messages: mail-box: MailBox reload: Configuration reloaded received-time: Received sent-mails: 'Sent mail [name: ] [description: ] to ' scheduled-mail: 'Scheduled mail [name: ] [description: ] at ' received-mail: You have received a mail! open-mail-box: Click here or type /mailbox to open your mailbox change-previous-page: Next page change-next-page: Previous page ```

MailBox

MailBox 1.0.0-beta.3

Changelog

Beta 3

Changes

Files

Metadata

Release channel

Version number

Loaders

Game versions

Downloads

Publication date

Publisher

Version ID