PlaceholderAPI placeholders - Historical
Applied By Andre_601: Oct 1, 2017 at 11:51 PM
PlaceholderAPI is a module based system where placeholders for a specific function/object/plugin are usually compiled into individual .jar files called "Expansions".
These expansions are similar to how actual plugins on your server work.
In order for an expansion to be loaded and enabled, the <expansion name>.jar file must be located in the /server/plugins/ folder and you must also have any to use Factions placeholders, you will obviously need the Factions plugin installed and running properly on your server).
This expansion system allows the core plugin of PlaceholderAPI to be as light and dependency free as possible while also allowing the expansion developer much flexibility as each set of placeholders is contained within its own environment. Updating is super easy, the code behind the placeholders can be organized neatly, and it doesn't bloat the actual plugin with tons of useless code or functions that are never used!
All official expansions can be downloaded either in game via the command - /papi ecloud, or by visiting my website.
If you are a developer and have expansions that you have made and would like to contribute to the official PlaceholderAPI expansion cloud for others to download and use, send me a message.
Some plugins may add placeholders to PlaceholderAPI other ways than the expansion system stated above such as include them with the plugin that the placeholders are associated with and load them into PlaceholderAPI when said plugin is enabled on your server.
These placeholders allow you to specify the format you want to use to get the current time / date / etc. These require you use valid date and time patterns. Once a valid pattern is used in a placeholder, it's cached for faster use later. Valid patterns can be found here: http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html
%server_online% Shows the player count of the server.
%server_online_(world)% Shows the player count of the world.
NOTE: %server_ram_total% and %server_ram_max% do the exact same thing.
Player sound placeholders
Play a sound to the player the placeholder values are being parsed for
Global sound placeholders
Play a sound to all players on the server when this placeholder is parsed
Sound names can be found here:
These placeholders require "warmup" time of around a minute or two after installing the expansion (Replace 'Testplugins.com:25565' with your server/ip).
NOTE: %pinger_online_testplugins.com:25565% and %pinger_isonline_testplugins.com:25565% do the exact same thing.
NMS Player placeholders
NewPing placeholders (1.11.x)
These placeholders are obsolete. Use Player expansion 1.1.0 or higher
%player_ping% - added in 1.1.0
%player_ping_<playername>% - added in 1.1.0
%statistic_mine_block% - total blocks broken
%statistic_use_item% - total item uses
%statistic_break_item% - total item breks
%statistic_craft_item% - total items crafted
%statistic_ticks_played% - total ticks played
(Requires MVdWPlaceholderAPI and one of Maxims placeholder plugins)
%mvdw_<placeholder without brackets>%
A list of his placeholders can be found here
These placeholders require a certain plugin be on your server to work
There are too many placeholders to fit one one wiki page!
Click a page below view placeholders for plugins:
Note: plugin placeholders are not listed in any specific order at the moment. I tried to keep it in alphabetical order at first but that failed by the time page 1 was full. Feel free to organize if you wish, just do not remove any placeholders accidentally!