Plugin placeholders - montlikadani/TabList GitHub Wiki

These are the built-in placeholders which can be used in tablist.yml file especially in header/footer sections. Some of the built-in placeholders in TL plugin have extra settings that can be configured like for %tps% or %date%.

Miscellaneous variables

Variable Description Alternative placeholder from PlaceholderAPI
%anim:animName% Animates specific texts from animcreator.yml file and appends it -
%staff-online% Returns the current amount of staffs who have tablist.onlinestaff permission -
%server-time% Returns the current time based on time zone %server_time_<SimpleDateFormat>%
%server-ram-free% Free server RAM %server_ram_free%
%server-ram-max% Max server RAM %server_ram_max%
%server-ram-used% Used server RAM %server_ram_used%
%servertype% Server type (specifically the server name) %server_name%
%vanished-players% Amount of vanished players that are online ?
%date% Returns the current date based on time zone %server_time_<SimpleDateFormat>%
%mc-version% Bukkit version %server_version%
%motd% Returns the set of server motd ?
%max-players% Returns the amount of max players of the server %server_max_players%
%online-players% Returns the current online players on the server %server_online%
%fake-players% Displays the added amount of fake players. -

TPS (Ticks Per Second) variables

Variable Description Alternative placeholder from PlaceholderAPI
%tps% Shows the current server TPS in 1 minute measurement with the corresponding colour if set %server_tps%
%tps-1min% Shows the current server TPS in 1 minute measurement with the corresponding colour if set. (Same approach with %tps%) -
%tps-5min% Shows the current server TPS in 5 minute measurement with the corresponding colour if set. -
%tps-15min% Shows the current server TPS in 15 minute measurement with the corresponding colour if set. -
%tps-overflow% Shows the amount of overflowed 1 minute tps (2 decimals by default), for example 20.1 -
%tps-overflow-1min% Returns the amount of overflowed 1 minute tps (2 decimals by default), for example 20.1 (same approach with %tps-overflow%) -
%tps-overflow-5min% Returns the amount of overflowed 5 minute tps (2 decimals by default), for example 19.6 -
%tps-overflow-15min% Returns the amount of overflowed 15 minute tps (2 decimals by default), for example 19.9 -

? = No alternative placeholder (may exists in specific plugins)

The above listed extra TPS placeholders can only be used from TabList 5.7.4 version.

Player variables

These placeholders unnecessarily added in the plugin, but there are server owners who don't have PlaceholderAPI installed, so this is why I added these common placeholders to the plugin. Also some of the listed placeholders may return different values, like %ping%. This placeholder can also be formatted with conditions.

Variable Description Alternative placeholder from PlaceholderAPI
%player% Player's name %player_name%
%player-displayname% Player's display name %player_displayname%
%player-gamemode% Player's game mode %player_gamemode%
%world% The player's current world name %player_world%
%player-health% Current level of health %player_health%
%player-max-health% Player's max health %player_max_health%
%ping% Player's ping %player_ping%
%exp-to-level% Returns the amount of experience to level %player_exp_to_level%
%xp% Player's experience level %player_exp%
%level% Player's level %player_level%
%ip-address% Player's IP address %player_ip%
%light-level% The block's light level at the player's current position %player_light_level%

Folia only placeholders

These are the placeholders which can only be used in Folia servers only and from TabList 5.7.4 version.

Variable Description
%folia-current-region-average-tps-5sec% Retrieves the average 5 seconds TPS from the current region
%folia-current-region-average-tps-15sec% Retrieves the average 15 seconds TPS from the current region
%folia-current-region-average-tps-1min% Retrieves the average 1 minutes TPS from the current region
%folia-current-region-average-tps-5min% Retrieves the average 5 minutes TPS from the current region
%folia-current-region-average-tps-15min% Retrieves the average 15 minutes TPS from the current region