Messages and language

Every message and GUI label comes from a language file in plugins/AT-MailBox/lang/. You can edit the text, change colors, and add new languages.

Bundled languages

AT-MailBox ships three ready to use:

• english
• french
• spanish

Switch with general.language in config.yml, using the filename without .yml:

general:
  language: "french"

Editing text

Open the file for your language (for example lang/english.yml) and change the values. Messages use placeholders in {braces} that the plugin fills in. Keep the placeholders if you want that value to show.

messages:
  item-claimed: "{prefix}&aClaimed &e{item}&a."
  claim-all-success: "{prefix}&aClaimed &e{count} &aitems from your mailbox."

The GUI button names and lore live under the gui section of the same file:

gui:
  title: "&8{player}'s Mailbox &7[Page {page}/{max}]"
  claim-all-button:
    name: "&a&lClaim All"
    lore:
    - "&7Click to claim all items"
    - "&7into your inventory."

InfiniteBags and settings messages

When the InfiniteBags integration is on, a few extra messages and the Settings-menu labels come from the same file:

messages:
  routed-to-bag: "{prefix}&7Your inventory was full. &e{item} &7went straight to your InfiniteBag."
  bag-full-no-slot: "{prefix}&cYour InfiniteBag has no free slot for that item type, so it stayed in your mailbox."
  bag-snapshot-refreshed: "{prefix}&aBag list refreshed. &7What is in your bag now counts as 'already in bag'."
  swept-to-bag: "{prefix}&aMoved &e{count} &aitem(s) from your mailbox straight into your InfiniteBag."
gui:
  settings:
    auto-existing:
      name: "&e&lAuto-send: already in bag"
    auto-all:
      name: "&e&lAuto-send: new types"
    refresh:
      name: "&b&lRefresh bag list"
    back:
      name: "&c&lBack"

The swept-to-bag line is sent when flipping a switch sweeps stored items into the bag. It accepts either {count} or {amount} for the number, so both placeholders work in that one message.

Colors

Message text supports color codes:

• Legacy & codes like &a, &l, &c.
• Hex in the form &#rrggbb, for example &#44eebb. Hex needs a 1.16 or newer client.

Adding your own language

Missing keys fall back

If a language file is missing a key, the plugin uses the English text for it and writes the missing key back to the file. So your custom file stays complete even after an update adds new messages.

Apply your changes

Run /mailbox admin reload after editing, or restart the server.