Skip to content

Placeholders

Florian Stober edited this page Sep 21, 2016 · 25 revisions

Player bound placeholders

Each player related placeholder comes in two versions: One for the player viewing the tab list on one for a player displayed in the tab list. E.g. to display the players name there is ${viewer name} and ${player name}. The first one can be used everywhere, the second one in player slots and filters of player sets.

Viewer version Player version
${viewer name} ${player name}
${viewer ping} ${player ping}
${viewer skin} ${player skin}
${viewer bungeecord_primary_group} ${player bungeecord_primary_group}
${viewer bungeeperms_display} ${player bungeeperms_display}
${viewer bungeeperms_prefix} ${player bungeeperms_prefix}
${viewer bungeeperms_suffix} ${player bungeeperms_suffix}
${viewer bungeeperms_primary_group} ${player bungeeperms_primary_group}
${viewer bungeeperms_primary_group_prefix} ${player bungeeperms_primary_group_prefix}
${viewer bungeeperms_user_prefix} ${player bungeeperms_user_prefix}
${viewer client_version} ${player client_version}
${viewer uuid} ${player uuid}
${viewer world} ${player world}
${viewer team} ${player team}
${viewer vault_balance} ${player vault_balance}
${viewer multiverse_world_alias} ${player multiverse_world_alias}
${viewer faction_name} ${player faction_name}
${viewer faction_member_count} ${player faction_member_count}
${viewer faction_online_member_count} ${player faction_online_member_count}
${viewer faction_at_current_location} ${player faction_at_current_location}
${viewer faction_power} ${player faction_power}
${viewer faction_player_power} ${player faction_player_power}
${viewer faction_rank} ${player faction_rank}
${viewer SimpleClans_ClanName} ${player SimpleClans_ClanName}
${viewer SimpleClans_ClanMembers} ${player SimpleClans_ClanMembers}
${viewer SimpleClans_OnlineClanMembers} ${player SimpleClans_OnlineClanMembers}
${viewer SimpleClans_ClanTag} ${player SimpleClans_ClanTag}
${viewer SimpleClans_ClanTagLabel} ${player SimpleClans_ClanTagLabel}
${viewer SimpleClans_ClanColorTag} ${player SimpleClans_ClanColorTag}
${viewer vault_primary_group} ${player vault_primary_group}
${viewer vault_prefix} ${player vault_prefix}
${viewer vault_suffix} ${player vault_suffix}
${viewer vault_primary_group_prefix} ${player vault_primary_group_prefix}
${viewer vault_player_prefix} ${player vault_player_prefix}
${viewer health} ${player health}
${viewer max_health} ${player max_health}
${viewer location_x} ${player location_x}
${viewer location_y} ${player location_y}
${viewer location_z} ${player location_z}
${viewer xp} ${player xp}
${viewer total_xp} ${player total_xp}
${viewer level} ${player level}
${viewer player_points} ${player player_points}
${viewer vault_currency} ${player vault_currency}
${viewer vault_currency_plural} ${player vault_currency_plural}
${viewer tab_name} ${player tab_name}
${viewer display_name} ${player display_name}
${viewer server} ${player server}
${viewer permission <permission>} ${player permission <permission>}
${viewer session_duration_hours} ${viewer session_duration_hours}
${viewer session_duration_minutes} ${viewer session_duration_minutes}
${viewer session_duration_seconds} ${viewer session_duration_seconds}
${viewer essentials_afk} ${viewer essentials_afk}
${viewer is_hidden} ${player is_hidden}

Server bound placeholders

  • TPS

    ${server:<server name> tps} Resolves the placeholder for a specific server. Example: ${server:factions tps}

    ${viewer server tps} Tps of the server the player viewing the tab list is connected to. Analogue there is ${player server tps}.

    ${server tps} for use in the serverHeader of the players by server component.

  • Online state

    ${server:<server name> online} checks whether a specific server is online. Player and viewer variants exist too but I don't think they are very useful.

    The ${server online} for use in the serverHeader of the players by server component is available too.

    The placeholder either evaluates to true or false so directly using it may not be what you want. Instead you probably want to use it as condition in the conditional component.

Special placeholders

  • ${time <format>}

    Displays the current time. Example: ${time HH:mm:ss}. You can find more information about the date format at https://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html.

  • ${server_player_count} for use in the serverHeader of the players by server component.

  • ${other_count} for use in the morePlayersComponent option of all components that add players to the tab list.

  • ${playerset:<name> size} number of players in a player set. See Player sets.