Placeholders

ServerGames registers a PlaceholderAPI expansion with the identifier servergames. PlaceholderAPI is optional: install it and the placeholders work, leave it out and nothing else changes. Replace <arena> with the arena name, for example %servergames_slots_demo%.

Player counts

The ones you’ll put on a lobby hologram.

Placeholder	Value
%servergames_playing%	Players racing right now, all arenas (countdown and race).
%servergames_joined%	Players waiting in a lobby, all arenas.
%servergames_ingame%	Every player inside a race, whatever the state.
%servergames_playing_<arena>%	Players racing in that arena (0 unless it is running).
%servergames_joined_<arena>%	Players waiting in that arena’s lobby (0 unless it is open).
%servergames_players_<arena>%	Signed-up players in that arena, lobby or race.
%servergames_slots_<arena>%	Players and capacity, for example 3/100.

Arena info

Placeholder	Value
%servergames_max_<arena>%	Maximum players.
%servergames_min_<arena>%	Players needed to start.
%servergames_needed_<arena>%	Players still missing before the lobby counts down.
%servergames_countdown_<arena>%	Lobby countdown seconds left (0 when not counting).
%servergames_state_<arena>%	Raw state: IDLE, BUILDING, LOBBY, COUNTDOWN, RACING, FINISHED, CLEANUP.
%servergames_status_<arena>%	The state in your language, from placeholder-state-* in the messages file.
%servergames_time_<arena>%	Elapsed race time, mm:ss.
%servergames_laps_<arena>%	Lap count.
%servergames_mode_<arena>%	FOOT, CAR, KART, F1 or ATV.
%servergames_theme_<arena>%	The arena’s theme.
%servergames_leader_<arena>%	Name of the racer in first place.
%servergames_arenas%	Number of arenas. Also _open, _running and _idle.

The viewing player

Placeholder	Value
%servergames_my_race%	The race they are in (the placeholder-none text when they are in none).
%servergames_my_position%	Their current position.
%servergames_my_lap%	Their current lap.
%servergames_my_laps%	Laps in their race.
%servergames_my_status%	Their race’s state, translated.
%servergames_stats_races%	Races they have started (counted at GO).
%servergames_stats_wins%	Their wins.
%servergames_stats_podiums%	Their podium finishes.

The words placeholder-none and placeholder-state-* in messages_en.yml / messages_tr.yml are plain text on purpose; add colours there if your hologram plugin renders section codes.

Next: config.yml reference.