MailPresets

Commonly, a server may want to send a mail to someone. Obviously, a server can't open up a gui for you and enter all the answers you'd like so we need to create a preset mail that we can tell the server to dispatch.

Creation

Firstly, to begin the creation. Enter the following command

/mailpreset create

This will bring up the menu for you to select which mail type you wish to send.

Editing

Now that you've begun creation, you will want to edit some attributes such as the sender for example. There are a few ways to do this, by clicking on the message sent to you. Or manually typing out the command. For the sake of this tutorial, we will be typing it out.

Enter the command:

/mailpreset edit sender:Santa

Now, our mail will have the sender to be set from Santa whenever sent! Now, continue to do this with the rest of the elements.

Some elements don't require editing. For example; the expiry time in minutes defaults to the config value if one is not set in edit mode.

In version 1.5.11 and above you can set a reason. To have more than one word, you must replace spaces with the '_' character. This is then read by the mailme system as whitespace.(See FAQ)

Completion

Once you've successfully filled out all of the elements to create the preset, you can either click the "Complete" button sent to you in chat. Or type /mailpreset complete. If you've missed an element to edit, the plugin will let you know that you need to fill in something.

Sending

Now that you've created your shiny preset mail. You'll want to send it. Here's how

Sending to a Player

You can send a mail individually using the following command.

/mailpreset give <playername> <identifier>

Now your playername can be online or offline and the plugin will try its best to find the player. Your identifier is the identifier you set in creation mode.

Sending to Everyone Online

You can send mail to everybody online if you wish. This is simple and handled by the plugin. To do this, type the following command:

/mailpreset give * <identifier>

Sending to Everyone (Including Offline)

You can send mail to everybody that has ever joined the server if you'd like! Please be cautious with this method as although mails are sent asynchronously there is still some processing done before being sent which is on thread. So thousands of players may lag briefly while in execution.

/mailpreset give ** <identifier>

Sending to Players who have a certain permission

You are free to send to players which checks if they have a certain permission. Please be aware that this feature requires vault and a permissions plugin. To do this, simply add the permission on the end. Like this;

/mailpreset give <to> <identifier> <permission>
e.g /mailpreset give * Present01 some.permission.here