PlaceholderAPI placeholders

Oct 16, 2017
PlaceholderAPI placeholders
  • [​IMG]
    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.

    Date placeholders(top)

    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:

    Javascript placeholders(top)

    %javascript_<your placeholder identifier>%

    Server placeholders(top)

    %server_online% Shows the player count of the server.

    Shows the player count of the world.
    %server_countdown_<SimpleDateFormat>_<time>% ex. %server_countdown_MM/dd/yyyy-HH:mm_10/11/2019-06:30%

    NOTE: %server_ram_total% and %server_ram_max% do the exact same thing.

    Player sound placeholders(top)

    Play a sound to the player the placeholder values are being parsed for

    Global sound placeholders(top)

    Play a sound to all players on the server when this placeholder is parsed

    Sound names can be found here:(top)

    Pinger placeholders(top)

    These placeholders require "warmup" time of around a minute or two after installing the expansion (Replace '' with your server/ip).
    NOTE: and do the exact same thing.

    BungeeCord placeholders(top)


    RedisBungee placeholders(top)


    NMS Player placeholders(top)

    NewPing placeholders (1.11.x)(top)

    These placeholders are obsolete. Use Player expansion 1.1.0 or higher

    ListPlayer placeholders(top)


    Player placeholders(top)

    %player_ping% - added in 1.1.0
    %player_ping_<playername>% - added in 1.1.0
    %player_hasitem-mat:<MATERIAL>-amt:<amount>-data:<data value>%

    Scoreboard Objectives placeholders(top)


    Statistic placeholders(top)

    ex: %statistic_mine_block_DIAMOND_BLOCK%

    %statistic_use_item_<Item Material>%
    %statistic_break_item_<Item Material>%
    %statistic_craft_item_<Item Material>%
    ex: %statistic_craft_item_DIAMOND_SWORD%

    ex: %statistic_kill_entity_CREEPER%

    ex: %statistic_entity_killed_by_CREEPER%

    %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

    MVdW placeholders(top)

    (Requires MVdWPlaceholderAPI and one of Maxims placeholder plugins)

    %mvdw_<placeholder without brackets>%
    A list of his placeholders can be found here

    Plugin placeholders(top)

    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:

    Next page:(top)

    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!
  • Loading...
  • Loading...