Placeholders

If you have PlaceholderAPI installed, HuskTowns (v2.2+) will automatically register a hook providing a number of placeholders that will be replaced with their appropriate values.

Placeholders

The following table contains the available placeholders. You can customize the replacement messages in the plugin locales file. If you wish to customize the Yes/No messages, please edit your PlaceholderAPI config as those are sourced from there.

Standard placeholders

PlaceholderReplacementNotes
%husktowns_town_name%WatersideName of town the player is in¹
%husktowns_town_role%CitizenName of the role the player has in their town¹
%husktowns_town_mayor%William278Name of the player's town mayor¹
%husktowns_town_color%#ff1200Color of the player's town (gray if not in one)
%husktowns_town_members%Mark12, William278, MeetTheProList of members of the player's town¹
%husktowns_town_member_count%3Number of members of the player's town¹
%husktowns_town_claim_count%4Number of claims made by the player's town¹
%husktowns_town_max_claims%6Maximum number of claims the player's town can make¹
%husktowns_town_max_members%5Maximum number of members the player's town can have¹
%husktowns_town_money%1230.32Balance of the player's town¹
%husktowns_town_level_up_cost%1500.00Cost for the player's town's next level up¹
%husktowns_town_level%1Current level of the player's town¹
%husktowns_town_max_level%20Maximum town level
%husktowns_current_location_town%TomoedaName of the town who owns the claim the player is in²
%husktowns_current_location_town_color%#aaaaaaColor of the town who owns the claim the player is in⁵
%husktowns_current_location_can_build%NoIf the player can build in the claim they are in³
%husktowns_current_location_can_interact%YesIf the player can interact in the claim they are in³
%husktowns_current_location_can_open_containers%NoIf the player can open containers in the claim they are in³
%husktowns_current_location_claim_type%PlotThe type of claim they are in (Claim, Plot, Farm
%husktowns_current_location_plot_members%Sakura32, Toya567If this is a plot, the name of members of the plot⁴
%husktowns_current_location_plot_managers%Sakura32If this is a plot, the name of managers of the plot⁴
%husktowns_current_location_town_money%1130.50Balance of the town who owns the claim the player is in³
%husktowns_current_location_town_level%3Level of the town who owns the claim the player is in³
%husktowns_current_location_town_level_up_cost%2400.00Cost of the town who owns the claim the player is in to level up³
%husktowns_current_location_town_max_claims%15Maximum number of claims of the town the player is in can make³
%husktowns_current_location_town_max_members%20Maximum number of members the town the player is in can have³

¹ — Or, Not in town if the player is not in a town
² — Or, Wilderness if they are not standing in a claim
³ — Or, Not in claim if they are not standing in a claim
⁴ — Displays Not in claim if they are not standing in a claim and Not a plot if they are not in a plot
⁵ — Returns a gray color for wilderness (if they are not standing in a claim)

Leaderboard placeholders

These placeholders return the name of the town dependent on their position in the list of towns, sorted by their respective property (where 1 is the highest ranked town). Useful for making in-game leaderboards to promote competition among towns!

  • %husktowns_town_leaderboard_members_{index}% — Most members
  • %husktowns_town_leaderboard_claims_{index}% — Most claims
  • %husktowns_town_leaderboard_money_{index}% — Highest balance
  • %husktowns_town_leaderboard_level_{index}% — Highest level