PlaceholderAPI 2.2

Compatible API Versions
PlaceholderAPI adds support for placeholders, so you can easily use the information from all plugins supporting PlaceholderAPI such as (Holograms, CustomMessages or LuckPerms) anywhere else.

KotlinLib is required to use plugin

How to use

Placeholders in texts must be surrounded with percent signs.​


"this is a text with placeholder %time%"​
%time% will be replaced with the actual time​

You can use multiple placeholders in one text.​
since version 1.3 placeholders can contain parameters, which modify the final value, it can be a permission we want to check or the key of something and so on.​
parameters must be specified in the following format​
%placeholder<parameters>% - generic format​
%placeholder<param1=value1;param2=value2>% - PAPI supports named parameters which is usually used when you need to use multiple parameters, then it doesn't matter in what order you specifiy them. But it depends on the implementation of the plugin that provides the placeholders whether the naming is required or not. In general for single parameter the naming shouldn't be required.​
%has_permission<nukkit.command.time>% - checks if player has the permission nukkit.command.time​
%synapse_status<lobby;true=you can join;false=you can't join right now>% - returns synapse server status. When online then "you can join" otherwise "you can't join right now"
%player% - get the player's name
%player_displayname% - get the player's display name
%player_uuid% - get the player's UUID
%player_ping% - get the player's ping
%player_level% - get the player's level name
%player_can_fly% - Whether player is in the fly mode or not
%player_flying% - Whether player is flying or not
%player_health% - get the player's health
%player_max_health% - get the player's max health
%player_saturation% - get the player's saturation level
%player_food% - get the player's food level
%player_gamemode% - get the player's gamemdoe
%player_x% - get the player's x coordinate
%player_y% - get the player's y coordinate
%player_z% - get the player's z coordinate
%player_direction% - get the player's look direction
%player_exp% - get the player's cuurent experience
%player_exp_to_next% - get experience required to the player's next experience level
%player_exp_level% - get the player's experience level
%player_speed% - get the player's current speed
%player_max_air% - get the player's max air
%player_remaining_air% - get the player's remaining air
%player_item_in_hand% - get the item player hold

%server_online% - get current online players count
%server_max_players% - get max player count
%server_motd% - get the server motd
%server_ram_used% - get used memory
%server_ram_free% - get free memory
%server_ram_total% - get total memory
%server_ram_max% - get max memory
%server_cores% - get available processor cores
%server_tps% - get current TPS
%server_uptime% - get the current uptime


Developer documentation
First release
Last update
3.71 star(s) 7 ratings

More resources from CreeperFace

  • GAC
    Cheat protection plugin originally created for GameTeam network
  • KotlinLib
    Base kotlin library for all kotlin plugins
  • More Placeholders
    More Placeholders
    Placeholders from LuckPerms, Multipass, SynapseAPI, EconomyAPI and other plugins
  • Holograms
    Simple holograms
  • Residence
    Advanced area protection plugin

Latest updates

  1. Version 2.2

    - Fix bug casing formatters to return always `null` instead of actual formatted value
  2. Version 2.1.1

    - Fix KotlinLib
  3. Version 1.4

    - Add support for placeholder scopes - Rework API - Other fixes

Latest reviews

Works fine :) But in luckperms page in this plugin folder should be extensions folder but it isnth here so im not sure how to show user rank there
Sorry but I must change my Review.
Nothing works with this Version.
I hope you give support for older Plugins.
This Update has killed all.
This is a great plugin, but some plugins have issues using the latest version of PlaceholderAPI and by that i mean, most plugins that are not made by Creeperface himself. Most plugins won't even update to the latest PlaceholderAPI, so, it'd be great if you could add some kind of compatibility with older nukkit plugins that used the old PlaceholderAPI please. Thank you
Excuse me, it's a great plugin.
hmm i like it, can i share it to Chinese Forum MCBBS? I will mark the anthor and link.
It is a mostly well done re-creation of the original clip plugin, but it is lacking in almost every way. It does not have an expansion cloud, no support for plugin developers to include their placeholders (seamless) and no way to use javascript placeholders. These are just some of the things that it is lacking.
Hi thanks for your review, but I don't understand what do you mean you can contact me on discord
it can't auto udating info, you can update it auto update new info in few second
I love this Plugin!!! But could you please add "%player_itemid_in_hand%? It would be perfect for a creativ server with WorldEdit! Thank you for the plugin!