Skip to content

PlaceholderAPI

Aurora Lahtela edited this page Oct 30, 2022 · 19 revisions

Plan Header

PlaceholderAPI

Plan has some placeholders.

📢 Important

Plan fetches data from database for the placeholders - if server thread is used, the values are cached on the first run and so the placeholder needs to be replaced twice before it appears.
This is to not crash the server.

If placeholder doesn't appear with your plugin right away, but works a bit later, you can add it to Plugins.PlaceholderAPI.Load_these_placeholders_on_join setting in the Plan config and it will work better.

Page version: 5.4 build 1690

List of Placeholders

Use placeholders like this: %plan_<placeholder>%

  • All placeholders with _day, _week and _month show data for last 24h, 7d and 30d respectively.

Player

These placeholders are about the player who sees the placeholder.

You can add :player to the end of the placeholder to show data about specific player, for example %player_activity_group:AuroraLS3% or %player_activity_group:ed568cd3-f5ab-4893-996b-90fa3b9a9e64%. If the player is not found the placeholder is not replaced.

player_activity_group
player_activity_index
player_banned
player_current_session_length
player_current_session_length_raw
player_death_count
player_deaths
player_favorite_server
player_is_afk
player_is_afk_badge
player_kdr
player_kick_count
player_kill_death_ratio
player_lastseen
player_latest_session_length
player_latest_session_length_raw
player_mob_caused_deaths
player_mob_kdr
player_mob_kill_count
player_operator
player_ping_average_day
player_ping_average_month
player_ping_average_week
player_player_caused_deaths
player_player_kill_count
player_previous_session_length
player_previous_session_length_raw
player_recent_death_{n}
player_recent_kill_{n}
player_registered
player_server_time_active
player_server_time_active_raw
player_server_time_afk
player_server_time_afk_raw
player_server_time_day
player_server_time_day_raw
player_server_time_month
player_server_time_month_raw
player_server_time_total
player_server_time_total_raw
player_server_time_week
player_server_time_week_raw
player_sessions_count
player_time_active
player_time_active_raw
player_time_afk
player_time_afk_raw
player_time_day
player_time_day_raw
player_time_month
player_time_month_raw
player_time_total
player_time_total_raw
player_time_week
player_time_week_raw
  • {n}: replace this with 1-10

World

These placeholders are about a specific world

worlds_playtime_total_%worldname%

Change %worldname% with the name of the world like world_nether

Server

These placeholders are about the server the placeholder is used on.

You can add :server to the end of the placeholder to show data about specific server, for example %plan_server_tps_day:Lobby% or %plan_tps_day:ed568cd3-f5ab-4893-996b-90fa3b9a9e64% (Use plan servers command for list of servers)

network_players_registered_day
network_players_registered_month
network_players_registered_total
network_players_registered_week
network_players_unique_day
network_players_unique_month
network_players_unique_total
network_players_unique_week
operators_total
ping_day
ping_month
ping_total
ping_week
server_average_free_disk_day
server_average_free_disk_month
server_average_free_disk_week
server_chunks_day
server_chunks_month
server_chunks_week
server_cpu_day
server_cpu_month
server_cpu_week
server_entities_day
server_entities_month
server_entities_week
server_max_free_disk_day
server_max_free_disk_month
server_max_free_disk_week
server_min_free_disk_day
server_min_free_disk_month
server_min_free_disk_week
server_name
server_players_registered_day
server_players_registered_month
server_players_registered_total
server_players_registered_week
server_players_unique_day
server_players_unique_month
server_players_unique_total
server_players_unique_week
server_ram_day
server_ram_month
server_ram_week
server_tps_day
server_tps_month
server_tps_week
server_uuid
sessions_active_time_day
sessions_active_time_day_raw
sessions_active_time_month
sessions_active_time_month_raw
sessions_active_time_total
sessions_active_time_total_raw
sessions_active_time_week
sessions_active_time_week_raw
sessions_afk_time_day
sessions_afk_time_day_raw
sessions_afk_time_month
sessions_afk_time_month_raw
sessions_afk_time_total
sessions_afk_time_total_raw
sessions_afk_time_week
sessions_afk_time_week_raw
sessions_average_session_length_day
sessions_average_session_length_month
sessions_average_session_length_total
sessions_average_session_length_week
sessions_average_unique_players_day
sessions_average_unique_players_month
sessions_average_unique_players_total
sessions_average_unique_players_week
sessions_mob_kill_day
sessions_mob_kill_month
sessions_mob_kill_total
sessions_mob_kill_week
sessions_new_players_day
sessions_new_players_month
sessions_new_players_total
sessions_new_players_week
sessions_peak_count
sessions_peak_date
sessions_play_time_day
sessions_play_time_day_raw
sessions_play_time_month
sessions_play_time_month_raw
sessions_play_time_total
sessions_play_time_total_raw
sessions_play_time_week
sessions_play_time_week_raw
sessions_players_death_day
sessions_players_death_month
sessions_players_death_total
sessions_players_death_week
sessions_players_kill_day
sessions_players_kill_month
sessions_players_kill_total
sessions_players_kill_week
sessions_recent_peak_count
sessions_recent_peak_date
sessions_unique_players_day
sessions_unique_players_month
sessions_unique_players_today
sessions_unique_players_total
sessions_unique_players_week
top_active_playtime_day_{n}
top_active_playtime_day_{n}_value
top_active_playtime_month_{n}
top_active_playtime_month_{n}_value
top_active_playtime_total_{n}
top_active_playtime_total_{n}_value
top_active_playtime_week_{n}
top_active_playtime_week_{n}_value
top_playtime_day_{n}
top_playtime_day_{n}_value
top_playtime_month_{n}
top_playtime_month_{n}_value
top_playtime_total_{n}
top_playtime_total_{n}_value
top_playtime_week_{n}
top_playtime_week_{n}_value
worlds_playtime_total
worlds_playtime_total_{worldname}
  • {n}: replace this with 1-10
Clone this wiki locally