Placeholder Support

HuskTowns provides placeholders through the PlaceholderAPI (PAPI) plugin via a special expansion.

Setup

  1. Install PAPI and HuskTowns (version 1.3.1+) on your server
  2. Run /papi ecloud download HuskTowns to download the HuskTowns expansion
    • If that doesn’t work, download HuskTowns-Expansion.jar from the PlaceholderAPI eCloud and manually place this in your expansions directory under /plugins/PlaceholderAPI/expansions
  3. Type /papi reload or restart the server
  4. You will now be able to make use of the supported placeholders (see below)
    • You can test these in-game with the /papi parse <player> <placeholder> command

Placeholders

ℹ️ During startup, town caches may take a shot while to initialise; during this time, placeholders will display “Loading…” text.

Placeholder Replaced with Notes
%husktowns_town_name% Name of the town the player is in “Not in town” if they aren’t in a town.
%husktowns_town_role% The player’s current role (mayor, trusted, citizen) “Not in town” if they aren’t in a town.
%husktowns_town_mayor% Username of the mayor of the town the player is in “Not in town” if they aren’t in a town.
%husktowns_town_color% Hexadecimal color of the player’s town (#abcdef) “#fffff” if they aren’t in a town; “#aaaaa” during cache initialisation
%husktowns_town_members% Comma-separated list of members (William278, MeetThePro, Steve) “Not in town” if they aren’t in a town.
%husktowns_town_member_count% Number of members in the player’s town “Not in town” if they aren’t in a town.
%husktowns_town_coffer_balance% Bank balance of the town the player is in
%husktowns_town_level% Level of the town the player is in
%husktowns_current_location_town% Name of the town who own’s the claim the player is in “Wilderness” if it is unclaimed
%husktowns_current_location_can_build% “Yes” or “No” if the player can build at their location -
%husktowns_current_location_can_build_mark% “✔” or “✘” if the player can build at their location Instead of “Loading…”, displays a loading icon instead while caches are initialising.
%husktowns_current_location_claim_type% Type of the claim the player is standing in (regular, plot, farm) “Wilderness” if unclaimed
%husktowns_current_location_claim_time% Formatted date of when the claim being stood in was made “Not claimed” if unclaimed
%husktowns_current_location_claimer% Name of the person who made the claim being stood in “Not claimed” if unclaimed
%husktowns_current_location_claimer_uuid% UUID of the person who made the claim being stood in “Not claimed” if unclaimed
%husktowns_current_location_plot_owner% Name of the person who owns the plot claim being stood in “Not claimed” if unclaimed; “Not a plot chunk” if it’s not a plot.
%husktowns_current_location_plot_owner_uuid% UUID of the person who owns the plot claim being stood in “Not claimed” if unclaimed; “Not a plot chunk” if it’s not a plot.
%husktowns_current_location_town_coffer_balance% Bank balance of the town that owns the claim the player is currently standing in
%husktowns_current_location_town_level% Level of the town that owns the claim the player is currently standing in