Presets

Create a reward once, send it to anyone — or everyone — with one command. That’s presets.

Here’s a complete one:

File: config/courier/presets/event_reward.conf

id = event_reward
displayName = "<gold>Event Reward"
description = [
  "<gray>Thanks for participating!"
  "<yellow>Enjoy your prizes!"
]
senderName = "<gold>Event Team"

displayItem {
  item = "minecraft:nether_star"
  name = "<gold>Event Reward"
  lore = ["<gray>A special prize"]
}

items = [
  { item = "minecraft:diamond", count = 10 }
  {
    item = "minecraft:diamond_sword"
    name = "<red>Event Blade"
    lore = [
      "<gray>Awarded for event participation"
      "<yellow>Season 3"
    ]
  }
]

pokemonSpecs = [
  "eevee level=20 shiny=yes"
  "pikachu level=15"
]

currencies {
  "impactor:dollars" = 500
}

commands = [
  "experience add {player} 100 levels"
]

Each preset is its own .conf file in config/courier/presets/. Let’s walk through every field.

Fields Reference

id : Required. Unique identifier for this preset. This is what you’ll use in commands — make it descriptive. weekly_login_reward beats reward1.

displayName : Display name shown in the mail subject. Supports MiniMessage formatting.

description : Array of description lines for the mail body.

senderName : The “from” name on the mail. Supports MiniMessage. Defaults to “Server” if you don’t set it.

displayItem : Icon shown in GUIs. Contains item, count, name, and lore. A Nether Star or custom item helps players recognize the mail at a glance.

items : Items to attach. See Item Format for all the ways you can define items.

pokemonSpecs : Pokemon specs to attach. See Pokemon Spec Format.

currencies : Currency ID to amount mapping. See Currency Format.

commands : Commands executed on claim. Supports {player} and {uuid} placeholders.

Every field except id is optional. You can make a preset with just items, just currency, just commands — whatever you need.

Sending Presets

To One Player

/mailadmin preset send event_reward Steve

To All Online Players

/mailadmin preset send event_reward online

To Everyone (All Known Players)

/mailadmin preset send event_reward everyone

With a Custom Sender Name

/mailadmin preset send holiday_gift everyone from "<red>Santa Claus"

Managing Presets

Changes to preset files aren’t picked up automatically. After adding or editing a preset, reload:

/mailadmin reload

See all loaded presets and their IDs:

/mailadmin preset list

Tips

Next Steps

Now that you’ve got presets set up, check out Package Locker to see what happens when recipients have full inventories. Or head to Economy Integration if you need to configure currency for your presets.