Variables / MxF Factions
Fancy variables. Can only be used in /f show
Docs version
v1.0.0
Product version
1.0.0-dev
Last updated
Jul 21, 2026
# Placeholders
> **Looking for PlaceholderAPI placeholders? [Click here](placeholderapi.md):**
Fancy variables. Can only be used in /f show
Variable | Explanation
--| ---
{allies-list} | Lists each faction ally with tooltips
{enemies-list} | Lists each faction enemy with tooltips
{online-list} | Lists all online members with tooltips
{offline-list} | Lists all offline members with tooltips
Player variables. Can be used in tooltips.show, scoreboards, or /f show
Variable | Explanation
--| ---
{group} | Players group (/f show only)
{name} | Players name
{lastSeen} | Last time player was seen (if offline), or just 'Online'
{balance} | Players balance
{player-kills} | # of kills the player has
{player-deaths}| # of deaths the player has
{player-power} | Current player power
{player-maxpower} | Player max power
{total-online-visible}| # of players online from the perspective of the current player
Faction variables. Can be used in tooltips.list, scoreboards, or /f show
Variable | Explanation
--| ---
{header} | Default factions header (ex. /f show)
{faction} | Factions tag (if none, uses lang.yml for factionless name)
{faction-relation-color} | Factions color relative to the viewer
{joining} | How to join this faction
{power} | Factions deaths until raidable value
{power-boost} | DTR Symbol based on current DTR (max, regen, frozen, raidable)
{maxPower} | Factions max deaths until raidable value
{chunks} | # of claims faction has (in chunks)
{warps} | # of warps faction has
{description} | Factions description
{create-date} | Date faction was created
{leader} | Faction leader
{land-value} | Value of all claims
{land-refund} | Calculated refund value
{allies} | # of allies faction has
{enemies} | # of enemies faction has
{online} | # of faction members online
{offline} | # of faction members offline
{members} | # of faction members (includes offline)
{faction-balance} | Faction bank balance
{world}, {x}, {y}, {z} | Faction home variables. You don't need to use them all.
{faction-kills} | # of kills the faction has
{faction-deaths}| # of deaths the faction has
{faction-bancount} | # of bans the faction has
{raidable} | Displays true/false (modifiable in lang.yml)
{dtr} | Current faction DTR
{max-dtr} | Max faction DTR based on players
{max-chunks} | Maximum claims the faction can have (power or DTR)
{peaceful} | Displays a message if peaceful
{permanent} | Displays a message if permanent
{dtr-frozen-status} | True or false (customizable in lang.yml) for DTR frozen state
{dtr-frozen-time} | Time remaining in frozen state (legacy core DTR configuration) or blank if not frozen
{tnt-balance} | TNT bank balance
{tnt-max-balance} | Maximum TNT bank balance
{faction-link} | Faction link from /f link
Faction Permissions GUI variables. Can only be used in GUI
Variable | Explanation
--| ---
{relation} | Shows relation name (Can be used in action and relation)
{relation-color} | Relation color
{action} | Shows action name (Can only be used in action)
{action-access} | Shows the action's access with current relation
{action-access-color} | Access color
General variables. Can be used anywhere.
Variable | Explanation
--| ---
{total-online} | Total # of players on the server
{max-warps} | Max # of warps a faction can set
{max-allies} | Max # of allies a faction can have
{max-enemies} | Max # of enemies a faction can have
{factionless} | Count of all factionless players online
{factionless-total} | Count of all factionless players online
MxF visual variables. Can be used in MxF-rendered menu lore and messages.
Variable | Explanation
--| ---
{visual_separator} | Configured MxF separator line
{icon_factions} | Configured faction icon
{icon_combat} | Configured combat icon
{icon_shields} | Configured shield icon
{icon_economy} | Configured economy icon
{icon_tokens} | Configured token icon
{icon_season_points} | Configured Season Points icon
{icon_koth} | Configured KOTH icon
{icon_outposts} | Configured Outposts icon
{icon_statistics} | Configured statistics icon
{icon_history} | Configured history icon
{icon_missions} | Configured missions icon
{icon_rewards} | Configured rewards icon
{icon_storage} | Configured storage icon
{icon_boosters} | Configured boosters icon
{icon_raid} | Configured raid icon
{icon_tnt} | Configured TNT icon
{icon_upgrades} | Configured upgrades icon
{icon_battle_pass} | Configured Battle Pass icon
{icon_rankings} | Configured rankings icon
{icon_settings} | Configured settings icon
{icon_leader} | Configured leader icon
{icon_members} | Configured members icon
{icon_territory} | Configured territory icon
{icon_timers} | Configured timers icon
{icon_locked} | Configured locked-state icon
{icon_completed} | Configured completed-state icon
{icon_disabled} | Configured disabled-state icon
{icon_warning} | Configured warning icon
{icon_info} | Configured information icon
Scoreboard-only variable with special behavior.
Configure the expected width and height of the board in the map section of the config.
Variable | Explanation
--| ---
{map} | Displays a line of the scoreboard map. Add one per line the scoreboard will appear on.
MxF Outpost variables. Can be used in MxF outpost messages and menu lore.
Variable | Explanation
--| ---
{outpost} | Outpost display name
{outpost_id} | Outpost config id
{outpost_owner} | Current owner faction tag
{outpost_status} | Current active/capturing/contested state
{outpost_progress} | Capture progress percent
{outpost_players} | Players currently inside the region
{outpost_mode} | Capture mode
{outpost_reward} | Configured reward summary
{outpost_points} | Stored faction outpost points
{outposts_owned} | Number of outposts owned by the faction
{outpost_time_held} | Time held by the current owner
{outpost_next_reward} | Time until the next interval reward
{outpost_contested} | Whether capture is currently contested
{outpost_attackers} | Present non-owning factions
{outpost_defenders} | Present owning faction defenders
MxF Season Points variables. Can be used in MxF menu lore and MxF-rendered messages.
Variable | Explanation
--| ---
{season_points} | Raw Season Points for the faction
{season_points_formatted} | Formatted Season Points for the faction
{season_points_rank} | Cached Season Points rank for the faction
MxF KOTH variables. Can be used in KOTH messages, KOTH menu lore, and MxF-rendered text.
Variable | Explanation
--| ---
{koth} | KOTH display name
{koth_id} | KOTH config id
{state} | Current KOTH state
{faction} | Capturing or controlling faction
{progress} | Current capture progress
{remaining} | Remaining capture time
{event_remaining} | Remaining event time
{region} | Configured cuboid summary
{reward} | Reward profile summary
MxF Competitive Rules variables. Can be used in MxF-rendered messages and supported menu lore.
Variable | Explanation
--| ---
{competitive_strikes} | Active strikes for the faction
{competitive_open_cases} | Open competitive cases for the faction
{competitive_suspended} | Whether competitive suspension is active
{competitive_frozen} | Whether faction freeze sanction is active
{competitive_payout_disqualified} | Whether payout disqualification is active
MxF Raid Alert placeholders. These are available through PlaceholderAPI with the mxf expansion and can be used in supported MxF-rendered text where PlaceholderAPI is applied.
Variable | Explanation
--| ---
%mxf_raid_alerts_unread% | Unread raid alerts for the faction
%mxf_raid_alerts_critical_unread% | Unread critical raid alerts
%mxf_raid_last_alert% | Latest stored raid alert summary
%mxf_raid_last_alert_time% | Relative time for the latest alert
%mxf_raid_breach_confirmed% | Whether a breach has been confirmed
%mxf_raid_breach_count% | Confirmed breach count
%mxf_raid_explosions_recent% | Recent hostile explosion alerts
%mxf_faction_under_attack% | Whether the faction has an active raid
%mxf_faction_active_raid_phase% | Current active raid phase