Placeholders
note
If you are a project developer or simply want to document the placeholders for a project, make a pull request to this list!
LEGEND
(argument) = Optional
[argument] = Required
Index
- A
- B
- C
- D
- E
- F
- G
- H
- I
- J
- K
- L
- M
- N
- O
- P
- Q
- R
- S
- T
- U
- V
- W
- X
- Y
- Z
AldrTeams
<aldrteams_tag>
<aldrteams_prefix>
<aldrteams_suffix>
<aldrteams_color>
AuthmeVelocity
Built-in expansion
<authme_is_logged>
<authme_is_player_logger:[player name]>
AFKPlus
<afkplus_status>
<afkplus_afktime>
<afkplus_totaltimeafk>
<afkplus_playersafk>
AFKSystem
<afksystem_afk>
<afksystem_afk:yesno>
<afksystem_afk:truefalse>
<afksystem_indicator>
<afksystem_list>
beanstalk
Built-in expansion
<beanstalk_status>
<beanstalk_remaining>
Bending
Built-in expansion
<bending_elements>
<bending_element>
<bending_display_name>
<bending_selected_ability>
<bending_ability_info>
BetterChestShops
Carbon
Built-in expansion
<carbonchat_party>
<carbonchat_nickname>
<carbonchat_displayname>
<carbonchat_channelname>
ChatRegulator
Built-in expansion
<chatregulator_infractions_count:[infraction type]>
Chunky
<chunky_task_pregen_exists:<world>>
<chunky_task_pregen_running:<world>>
<chunky_task_pregen_cancelled:<world>>
<chunky_task_pregen_centerx:<world>>
<chunky_task_pregen_centerz:<world>>
<chunky_task_pregen_radiusz:<world>>
<chunky_task_pregen_radiusx:<world>>
<chunky_task_pregen_radius:<world>>
<chunky_task_pregen_count:<world>>
<chunky_task_pregen_pattern:<world>>
<chunky_task_pregen_shape:<world>>
<chunky_task_pregen_time:<world>>
<chunky_task_pregen_world:<world>>
<chunky_task_pregen_chunks:<world>>
<chunky_task_pregen_complete:<world>>
<chunky_task_pregen_percent:<world>>
<chunky_task_pregen_hours:<world>>
<chunky_task_pregen_minutes:<world>>
<chunky_task_pregen_seconds:<world>>
<chunky_task_pregen_rate:<world>>
<chunky_task_pregen_x:<world>>
<chunky_task_pregen_z:<world>>
Claimo
ClaimoYoutubeAddon
Built-in expansion
<claimoyt_linked>
<claimoyt_verified>
<claimoyt_handle>
<claimoyt_channel_id>
<claimoyt_channel_url>
<claimoyt_status>
<claimoyt_verifier>
ClientCatcher
Built-in expansion
<clientcatcher_client>
<clientcatcher_mods>
<clientcatcher_player_client:[player name]>
<clientcatcher_player_mods:[player name]>
Creative-faces
Built-in expansion
<faces_player>
Cobblemon
Duels
Built-in expansion
EpicGuard
Built-in expansion
Expressions
STANDALONE EXPANSION
<epicguard_attack_status>
<epicguard_connections_per_second>
Floodgate
ItemDisplay
STANDALONE EXPANSION
| Placeholder | Description |
|---|---|
<item_display_main_hand:(name)> | Displays the item that the player has in the main hand in chat. |
<item_display_off_hand:(name)> | Displays the item that the player has in the off hand in chat. |
Insights
Impactor
JoinProtection
Built-in expansion
LiteEco
Built-in expansion
LibertyBans
Audience Placeholders
<libertybans_is_muted>
<libertybans_is_warned>
Global Placeholders
<libertybans_is_player_muted:[ip/player/uuid]:[uuid,player name,or ip]>
<libertybans_is_player_banned:[ip/player/uuid]:[uuid,player name,or ip]>
<libertybans_has_been_kicked:[ip/player/uuid]:[uuid,player name,or ip]>
<libertybans_has_been_muted:[ip/player/uuid]:[uuid,player name,or ip]>
<libertybans_has_been_banned:[ip/player/uuid]:[uuid,player name,or ip]>
<libertybans_total_active_bans>
<libertybans_total_active_mutes>
LibsDisguises
<libsdisguises_disguise_name>
<libsdisguises_disguise_type>
<libsdisguises_player_disguise_name>
LuckPerms
`<luckperms_prefix>`*
`<luckperms_suffix>`*
`<luckperms_has_permission:permission>` (true/false)
`<luckperms_check_permission:permission>` (true/false/undefined)
`<luckperms_primary_group_name>`*
`<luckperms_inherits_group:group>` (true/false)
`<luckperms_meta:meta-key>`*
*By default these resolve to an isolated component that doesn't leak its styles to the rest of the string.
If you want them inserted as strings prior to parsing so they affect the output add the s or string option to the end. Like this: <luckperms_prefix:s>
Maintenance
<maintenance_status>
MultiProxySync
Built-in expansion
<multiproxysync_global_player_count>
NightAccelerator
<nightaccelerator_sleeping>
<nightaccelerator_max>
<nightaccelerator_time>
Noble Whitelist
Built-in expansion
PlaceholderAdapter
This expansion provides support for multiple placeholder plugins so that they can be used in MiniPlaceholders
Supported Placeholder Providers
- PlaceholderAPI (Bukkit/Paper)
- TextPlaceholderAPI (Fabric)
- PAPIProxyBridge (Velocity)
info
If you are using Velocity, in order to use PlaceholderAPI placeholders with MiniPlaceholders Velocity, you must install PAPIProxyBridge according to its installation guide
On Velocity there is an additional optional expiry parameter for how long the placeholder should be cached. This value is in milliseconds.
Placeholders
Global
<placeholder-adapter_global:(placeholder)>Velocity:<placeholder-adapter_global:(placeholder):(expiry)>
This placeholder does not require any player to work.
Its operation would be similar to running the command /papi parse --null (placeholders)
Audience
<placeholder-adapter_player:(placeholder)>Velocity:<placeholder-adapter_player:(placeholder):(expiry)>
This placeholder requires an online player to function.
Its operation would be similar to running the /papi parse me (placeholders) command
Relational
note
This type of placeholder is not supported by TextPlaceholderAPI, so it will only be available in Paper and Velocity
<placeholder-adapter_relational:(placeholder)>Velocity:<placeholder-adapter_relational:(placeholder):(expiry)>
This placeholder requires two online players to work. The functioning of this placeholder depends on whether the plugin in which it is used has relational placeholder support
Nesting
If you want to nest the result of the placeholder inside another placeholder, add the string argument. For example:
<placeholder-adapter_papi_player:%player_name%:string><placeholder-adapter_player:%player_name%:string:30000>
PlatformInfo
STANDALONE EXPANSION
Velocity Placeholders
| Placeholder | Description |
|---|---|
<platforminfo_online_players:(server)> | Returns the number of connected users. Optionally accepts a server value to show the number of connected users on that server |
<platforminfo_server_count> | Returns the number of registered servers |
<platforminfo_is_player_online:[player]> | Returns true if the player is connected, otherwise false |
<platforminfo_version> | Return version of Velocity |
Paper, Fabric, Sponge Placeholders
| Placeholder | Description |
|---|---|
<platforminfo_name> | Shows you the name of the server |
<platforminfo_version> | Shows you the server version |
<platforminfo_online> | Shows you the number of online users |
<platforminfo_max_players> | Shows you the maximum number of users that can enter the server |
<platforminfo_unique_joins> | Shows you the number of users who have ever logged in to the server Be careful with this placeholder, it can be quite heavy depending on the number of registered players |
<platforminfo_has_whitelist> | Returns true if the server has whitelist, otherwise false |
<platforminfo_total_chunks> | Returns the total number of chunks loaded | Not Implemented in Sponge yet |
<platforminfo_total_entities> | Returns the total number of loaded entities |
<platforminfo_datapack_list> | Returns the list of enabled datapacks | Not Implemented in Sponge yet |
<platforminfo_datapack_count> | Returns the number of enabled datapacks | Not Implemented in Sponge yet |
Player
STANDALONE EXPANSION
Velocity Placeholders
<player_name>
<player_client>
<player_ping>
<player_locale>
<player_current_server>
<player_mods>
<player_tab_header>
<player_tab_footer>
Paper, Fabric, Sponge Placeholders
<player_name>
<player_displayname>
<player_ping>
<player_client>
<player_world>
<player_team>
<player_tab_header>
<player_tab_footer>
PremiumVanish
<premiumvanish_isvanished>
<premiumvanish_vanishprefix>
<premiumvanish_vanishsuffix>
<premiumvanish_vanishedplayers>
<premiumvanish_playercount>
<premiumvanish_uselevel>
<premiumvanish_seelevel>
ProxyConnection
STANDALONE EXPANSION
<proxyconnection_player_count>
<proxyconnection_player_count:(server)>
ReallyFakePlayers
<rfp_fakeplayers_count>
<rfp_rfp_player_count_no_fakeplayers>
SayanVanish
Built-in expansion
SkinsRestorer
Built-in expansion
<skinsrestorer_skin_name_or_empty>
<skinsrestorer_skin_name_or_player_name>
<skinsrestorer_texture_url_or_empty>
<skinsrestorer_texture_url_or_steve>
<skinsrestorer_texture_url_or_alex>
<skinsrestorer_texture_id_or_empty>
<skinsrestorer_texture_id_or_steve>
<skinsrestorer_texture_id_or_alex>
SimplyRank
Built-in expansion
<simplyrank_code_color>
<simplyrank_prefix>
<simplyrank_primary_rank>
Spark
Statics
Built-in expansion
<statics_[placeholder]>
SuperMines
Built-in expansion
| Placeholder | Description |
|---|---|
<supermines_hasrank:rank:(player)> | Return whether the player has the rank |
<supermines_bestrank:(player)> | Return the most valued rank of the player |
<supermines_biggestranklevel:(player)> | Return the most valued rank's level of the player |
<supermines_mine_resettime:[mine]> | Return the remaining reset time of the mine |
<supermines_mine_blocksbroken:[mine]> | Return the broken blocks amount (will be 0 when the mine reset) |
<supermines_mine_blockspercent:[mine]> | Return the percentage of remaining blocks to total number of blocks |
<supermines_mine_minedpercent:[mine]> | Return the percentage of broken blocks to total number of blocks |
<supermines_mine_totalblocks:[mine]> | Return the total blocks of the mine |
tags
Built-in expansion
| Placeholder | Description |
|---|---|
<tags_current> | Displays the current player tag |
Treasury
Built-in expansion
UltimateMobCoins
unemojis
Built-in expansion
<unemoji_emoji:[id]>
unplugged-afk-paper
<unplugged-afk_is_unplugged>
<unplugged-afk_duration_mins>
<unplugged-afk_reason>
<unplugged-afk_started>
<unplugged-afk_expires>
<unplugged-afk_remaining_mins>
<unplugged-afk_is_fake>
<unplugged-afk_count>
Vault
<vault_prefix>
<vault_suffix>
<vault_has_permission:[permission]>
<vault_group>
<vault_groups>
<vault_group_prefix>
<vault_group_suffix>
<vault_in_group:[group]>
<vault_in_primary_group:[group]>
ViaVersion
<viaversion_player_protocol_version>
<viaversion_player_protocol_id>
Voxen
zHomes
Built-in expansion
Global Placeholders
<zhomes_version>
Audience Placeholders
<zhomes_set>
<zhomes_numberofhomes>
<zhomes_limit>
<zhomes_max>
<zhomes_homes>
<zhomes_set_max>
<zhomes_numberofhomes_limit>
<zhomes_has_home:[home name]>
<zhomes_home:[index]>
<zhomes_home_world:[index]>
<zhomes_home_x:[index]:(format)>
<zhomes_home_y:[index]:(format)>
<zhomes_home_z:[index]:(format)>
<zhomes_home_pitch:[index]:(format)>
<zhomes_home_yaw:[index]:(format)>
Player-Targeted Placeholders
<zhomes_p_set:[player]>
<zhomes_p_numberofhomes:[player]>
<zhomes_p_limit:[player]>
<zhomes_p_max:[player]>
<zhomes_p_homes:[player]>
<zhomes_p_set_max:[player]>
<zhomes_p_numberofhomes_limit:[player]>
<zhomes_p_has_home:[player]:[home name]>
<zhomes_p_home:[player]:[index]>
<zhomes_p_home_world:[player]:[index]>
<zhomes_p_home_x:[player]:[index]:(format)>
<zhomes_p_home_y:[player]:[index]:(format)>
<zhomes_p_home_z:[player]:[index]:(format)>
<zhomes_p_home_pitch:[player]:[index]:(format)>
<zhomes_p_home_yaw:[player]:[index]:(format)>