Placeholders
Every placeholder the plugin answers, about the player and about the protection they stand in, in the PlaceholderAPI form and the short form Exylia files read.
Every placeholder below is written in full, and clicking one copies it.
How the name is written
The plugin registers its placeholders through ExyliaLib as one group, protections. PlaceholderAPI reaches
them with the plugin's name in front, so a scoreboard, a hologram or a tab plugin asks for:
%exyliaprotections_protections_name%That is the form this page documents. Inside an Exylia plugin's own files — menus, messages, another Exylia
plugin's scoreboard — the registered name also stands on its own: %protections_name%.
No expansion needs downloading. Without PlaceholderAPI installed only the Exylia form works.
%exyliasurvivalcore_protections_…% belonged to the old protections module. Replace
exyliasurvivalcore_ with exyliaprotections_; the rest of each name is the same.
Every placeholder answers for a player. Read without one — from the console, or a global line of another plugin — it is empty, and the console reports it once.
About the player
| Placeholder | Description |
|---|---|
%exyliaprotections_protections_count% | Protections the player owns. |
%exyliaprotections_protections_max% | How many they may own: their highest exyliaprotections.limit.<n>, or settings.default-limit. |
%exyliaprotections_protections_effects_active% | The member perks active on them right now, by name, comma-separated; empty when none. |
About the protection they stand in
Everything here is about the protection at the player's position, and empty outside one.
| Placeholder | Description |
|---|---|
%exyliaprotections_protections_name% | Its name. |
%exyliaprotections_protections_owner% | Its owner's name. |
%exyliaprotections_protections_role% | The player's role in it: owner, the id of the role they hold, or visitor. |
%exyliaprotections_protections_level% | Its level, 0 before any upgrade. |
%exyliaprotections_protections_lives% | Lives it has left. Empty while raids are off. |
%exyliaprotections_protections_max_lives% | Lives it can hold. Empty while raids are off. |
%exyliaprotections_protections_raid_state% | Its raid state, in the words and colours messages.yml gives it: Safe, Shielded, Under siege, Raidable or Cooling down by default. Empty while raids are off. |
%exyliaprotections_protections_bank% | What its bank holds, formatted in the bank's currency. Empty while banks are off. |
%exyliaprotections_protections_upkeep_cost% | What one upkeep period costs. Empty while upkeep is off. |
%exyliaprotections_protections_upkeep_due% | Time until the next payment, short; the overdue text when it is late; the time until it is deleted when it is abandoned; - when upkeep has never run for it. Empty while upkeep is off. |
%exyliaprotections_protections_sale_price% | Its price while it is listed for sale, in the listing's currency. Empty otherwise, and while the market is off. |
%exyliaprotections_protections_subregion% | The plot the player stands in. Empty outside every plot, and while subregions are off. |
%exyliaprotections_protections_rent_tenant% | Who rents the plot the player stands in — or the whole protection, outside every plot. Empty when nobody does. |
%exyliaprotections_protections_rent_expiry% | Time left on that rent, short. |
%exyliaprotections_protections_warp_rating% | The average rating of its public warp, one decimal. Empty without a warp, and while warps are off. |
%exyliaprotections_protections_warp_visits% | Visits its warp has had. Same conditions. |
role reads the player's own role first and then their clan's. A staff member managing somebody else's
land through exyliaprotections.admin is still a visitor there.
The names of perks and of raid states come from messages.yml, so they follow the server's language. See
Configuration.
Examples
A scoreboard block that only fills in inside a protection:
Land: %exyliaprotections_protections_name%
Owner: %exyliaprotections_protections_owner%
Role: %exyliaprotections_protections_role%Raid status for a server with raids on:
Lives: %exyliaprotections_protections_lives%/%exyliaprotections_protections_max_lives% (%exyliaprotections_protections_raid_state%)The player's allowance:
Protections: %exyliaprotections_protections_count%/%exyliaprotections_protections_max%Something missing on this page? Tell us on Discord