📋 Placeholders
PlaceholderAPI
Registered automatically when PlaceholderAPI is installed. Nothing to enable.
| Placeholder | Returns |
|---|---|
%polaroidmail_unread% | How many mails are waiting, as a number |
%polaroidmail_has_mail% | true or false |
Both count only delivered mail. A letter still in transit under a delivery delay is not included until it lands.
Use them in scoreboards, tab lists, join messages — anywhere PlaceholderAPI reaches:
&7Mail: &e%polaroidmail_unread%
The count is cached and refreshed whenever anything changes it — sending, claiming, clearing, expiring — plus a poll every 60 seconds as a backstop. You are not hitting the database on every scoreboard frame.
Config placeholders
These are not PlaceholderAPI. They work inside the plugin's own config files only, and each one is available where it makes sense.
Items and lore — see Appearance
%subject% | The mail's subject |
%sender% | Who sent it, or "Anonymous" |
%sent% %claimed% | Dates, formatted by mail.date-format |
%expires% | Time left, e.g. 29d 4h |
%money% | Money attached |
%contents% | On its own lore line, one row per attachment |
%state% | /mail admin entries only |
%recipient% | /mail admin global entries, naming whose mail the row is |
Menus — see Appearance
%count% | Unread count on the claim-all button |
%page% %pages% | Pagination buttons |
%player% | /mail admin title |
%target% | Server-mail dialog title |
%message% | Letter-reading dialog |
Mailbox hologram — see Mailbox Block
%unread% | The viewer's own count |
%player% | The viewer's name |
Server mail — see Server Mail
%player% | The claimer, inside commands: |
Messages — see Messages
%player%, %count%, %max%, %seconds%, %id%, %sender%, each where relevant.