Skip to content
Aithor Dev

Placeholders

On this page

Placeholders

Requires PlaceholderAPI. The expansion identifier is nation, so every placeholder is written %nation_<name>%.

Government

Placeholder Returns
%nation_president% The president's name, or None
%nation_president_uuid% The president's UUID, or None
%nation_president_online% Yes / No
%nation_term_time% Time remaining in the current term (2d 4h 13m)
%nation_consecutive_terms% Consecutive terms served
%nation_approval_rating% Current approval rating, one decimal
%nation_salary_payouts% Total salary paid out, two decimals

Cabinet

Placeholder Returns
%nation_defense_minister% Minister of Defense's name, or None
%nation_treasury_minister% Minister of Treasury's name, or None
%nation_cabinet_count% Number of filled cabinet seats
%nation_cabinet_salary_total% Total cabinet salary paid out

Executive orders

Placeholder Returns
%nation_order_active% Yes / No
%nation_order_count% Number of active orders
%nation_order_name% Name of the active order
%nation_order_time% Time remaining on the active order
%nation_order_effect% Effect description of the active order
%nation_order_cooldown% Remaining cooldown
%nation_order_purge_active% Yes / No
%nation_order_xp_multiplier% Current XP multiplier
%nation_order_vault_multiplier% Current vault-point multiplier
%nation_order_farming_multiplier% Current farming-drop multiplier
%nation_order_pvp_damage_multiplier% Current PvP damage multiplier
%nation_order_shop_discount% Current shop discount, as a percentage

Per-order status

For every order type there are two placeholders, using the order's enum name in lower case:

Text
%nation_order_<order>%          # Yes / No β€” is it active?
%nation_order_<order>_time%     # remaining time, or 0s

Available order names: golden_age, war_economy, economic_recovery, environmental_protection, education_advancement, purge_protocol, presidential_pardon, tax_suspension, tax_surge.

Example: %nation_order_golden_age%, %nation_order_purge_protocol_time%.

Minister decisions

Placeholder Returns
%nation_minister_order_active% Yes / No
%nation_minister_order_count% Number of active decisions
%nation_minister_order_drop_multiplier% Global drop multiplier, two decimals
%nation_minister_order_xp_multiplier% Global XP multiplier, two decimals
%nation_minister_order_tax_holiday% Yes / No

Per-office decisions

Text
%nation_minister_<office>_order%        # the active decision's name, or None
%nation_minister_<office>_order_time%   # remaining time, or 0s

Offices: defense, treasury, health.

Example: %nation_minister_defense_order%.

Elections

Placeholder Returns
%nation_phase% Current election phase name
%nation_phase_time% Time remaining in the phase
%nation_candidates_count% Number of registered candidates
%nation_total_votes% Total votes cast
%nation_election_active% Yes / No

Treasury

Placeholder Returns
%nation_treasury% Balance, two decimals
%nation_treasury_income% Total income, two decimals
%nation_treasury_expenses% Total expenses, two decimals

Tax system (server-wide)

Placeholder Returns
%nation_tax_enabled% Yes / No
%nation_tax_amount% Invoice amount, two decimals
%nation_tax_interval% Billing interval in hours (24)
%nation_tax_next_collection% Time until the next billing cycle
%nation_tax_total_collected% Lifetime tax collected
%nation_tax_cycle_count% Number of billing cycles run
%nation_tax_debtor_count% Players carrying national debt
%nation_tax_outstanding_debt% Total national debt across all players
%nation_tax_penalty_rate% Penalty multiplier (2x)

Player β€” role

These need a player context.

Placeholder Returns
%nation_is_president% Yes / No
%nation_is_cabinet% Yes / No
%nation_cabinet_position% Office display name, or None

Player β€” lifetime statistics

Placeholder Returns
%nation_votes_cast% Total votes cast
%nation_times_ran% Times run for president
%nation_times_president% Times served as president
%nation_times_cabinet% Times served in a cabinet post
%nation_endorsements_given% Endorsements given
%nation_endorsements_received% Endorsements received
%nation_total_donations% Total donated, two decimals
%nation_playtime_hours% Playtime in hours, one decimal

Player β€” arena

Placeholder Returns
%nation_arena_kills% Arena kills
%nation_arena_deaths% Arena deaths
%nation_arena_kd% Kill/death ratio, two decimals
%nation_killstreak% Current killstreak
%nation_best_killstreak% Best killstreak

Player β€” tax

Placeholder Returns
%nation_tax_status% Clear, Unpaid, Penalty or National Debt
%nation_tax_outstanding% Total outstanding, two decimals
%nation_tax_invoice_count% Number of outstanding invoices
%nation_tax_debt% National debt remaining, two decimals
%nation_tax_defaulted% Number of invoices that defaulted
%nation_tax_auto_pay% Yes / No
%nation_tax_last_paid% Date of the last payment (04 Jun 2026), or Never
%nation_tax_total_paid% Lifetime tax paid, two decimals

Player β€” current election

Placeholder Returns
%nation_has_voted% Yes / No
%nation_is_candidate% Yes / No
%nation_candidate_votes% Your weighted vote total, one decimal
%nation_candidate_endorsements% Your endorsement count
%nation_candidate_slogan% Your campaign slogan, or None

The three candidate_* placeholders only return a value when the player is actually a registered candidate.

Notes

  • Time values use the format 2d 4h 13m, falling back to seconds (45s) for short durations and 0s when nothing is active.
  • An unknown placeholder returns nothing, so a typo shows as an empty string.
  • Player-specific placeholders return nothing without a player context.

Search documentation

    Type to start searching.