Skip to content

Placeholders

Jump to bottom
Myles K edited this page Jan 13, 2026 · 3 revisions

Placeholders can vary depending on context. When used on a build server, the placeholders automatically fetch it within the context of that server. When used from the lobby server, placeholders that reference a specific server need a build server specified in the placeholder. Placeholders will mention if they are [G] - Global, [S] - Build server only or [L] - Lobby only

Criteria [G]

Returns a specific criteria's name/description for the currently running comp on a server. The index is zero-based (i.e. %compmanager_criteria_0_description% returns the first criteria's description).

[S] %compmanager_criteria_<index>_name%

[S] %compmanager_criteria_<index>_description%

[L] %complobbymanager_criteria_<serverid>_0_name%

[L] %complobbymanager_criteria_<serverid>_0_description%

Time Until [G]

Returns the time until the competition starts, finishes or voting finishes in a human readable way (i.e. 5m 20s). When it reaches zero, it returns 0s. It's recommended to check the state/fullstatus of a server and conditionally display the most relevant placeholder.

[S] %compmanager_timeuntilstart%

[S] %compmanager_timeuntilend%

[S] %compmanager_timeuntilvoteend%

[L] %complobbymanager_timeuntilstart_<serverid>%

[L] %complobbymanager_timeuntilend_<serverid>%

[L] %complobbymanager_timeuntilvoteend_<serverid>%

Player Specific Placeholders [G] All of the placeholders below support both the build server and lobby server. They are displayed below for the build server, ie to use %compmanager_hasentered% on the lobby server, replace it with: %complobbymanager_hasentered_<serverid>%.

[S] %compmanager_hasentered% - Returns true if the player has entered the current competition, false otherwise.

[S] %compmanager_prize% - Returns the human-readable prize the player won (if any), or null if they haven't won a prize or haven't entered.

[S] %compmanager_prizeclaimed% - Returns true if the player has claimed their prize, false if they haven't, or null if they haven't entered.

[S] %compmanager_iswhitelisted% - Returns true if the player is whitelisted for the competition, false otherwise.

[L] %complobbymanager_iswhitelisted_<serverid>% - Returns null (not implemented on lobby server).

[S] %compmanager_spotsremaining% - Returns the number of spots remaining in the competition (max entrants - current entrants).

[S] %compmanager_maxentrants% - Returns the maximum number of entrants allowed in the competition.

[S] %compmanager_entrants% - Returns the current number of entrants in the competition.

Competition Information [G]

Returns basic information about the currently running competition.

[S] %compmanager_theme% - Returns the theme/title of the current competition.

[S] %compmanager_starttime% - Returns the start date and time of the competition in a formatted string.

[S] %compmanager_endtime% - Returns the end date and time of the competition in a formatted string.

[S] %compmanager_voteendtime% - Returns the vote end date and time in a formatted string.

[S] %compmanager_state% - Returns the current state of the competition (Open, Voting, Closed, Visit).

[S] %compmanager_running% - Returns true if the competition is currently running (state is Open), false otherwise.

[S] %compmanager_fullstatus% - Returns true if the competition is full (no spots remaining), false otherwise.

[L] %complobbymanager_theme_<serverid>% - Returns the theme for the specified server's competition.

[L] %complobbymanager_starttime_<serverid>% - Returns the start time for the specified server's competition.

[L] %complobbymanager_endtime_<serverid>% - Returns the end time for the specified server's competition.

[L] %complobbymanager_voteendtime_<serverid>% - Returns the vote end time for the specified server's competition.

[L] %complobbymanager_state_<serverid>% - Returns the state for the specified server's competition, or the offline message if the server is offline.

[L] %complobbymanager_running_<serverid>% - Returns true if the specified server's competition is running.

[L] %complobbymanager_fullstatus_<serverid>% - Returns true if the specified server's competition is full.

Prizes [G]

Returns information about competition prizes in human-readable format.

[S] %compmanager_firstprize% - Returns the first place prize description.

[S] %compmanager_secondprize% - Returns the second place prize description.

[S] %compmanager_participationprize% - Returns the participation prize description.

[L] %complobbymanager_firstprize_<serverid>% - Returns the first place prize for the specified server.

[L] %complobbymanager_secondprize_<serverid>% - Returns the second place prize for the specified server.

[L] %complobbymanager_participationprize_<serverid>% - Returns the participation prize for the specified server.

Criteria [G]

[S] %compmanager_criteria% - Returns a string representation of all criteria (legacy placeholder, consider using indexed criteria placeholders instead).

[L] %complobbymanager_criteria_<serverid>% - Returns a string representation of all criteria for the specified server.

Server Information [L]

These placeholders are only available on the lobby server.

[L] %complobbymanager_onlineservers% - Returns a list of all online server IDs that have checked in.

[L] %complobbymanager_allservers% - Returns a list of all known server IDs (both online and offline).

Clone this wiki locally