PlaceholderAPI 2.8.2

A resource that allows information from your favorite plugins be shown practically anywhere!

  1. clip
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    Contributors:
    Maximvdw, vk2gpz, many others
    [​IMG]
    We use Discord
    https://discordapp.com/
    If you would like to seek live support, feel free to join our discord server by entering the following code in your Discord app: 0utOOIYX82aY8rx7
    [​IMG]
    [​IMG]

    [​IMG]


    If you are a developer, a guide on how to use the API is below!

    [​IMG]
    Placeholders can be found here

    [​IMG]
    You can use PlaceholderAPI placeholders in any of the plugins listed here


    [​IMG]
    The config.yml contains the core plugin customization settings as well as a section specifically for expansions that wish to add configurable options too.

    Any settings an expansion may allow you to change will be added to the config.yml when that specific expansion is loaded.


    config.yml
    Code (YAML):

    # PlaceholderAPI version 2.8.1
    # Created by extended_clip

    check_updates
    : true
    cloud_enabled
    : true
    auto_install_expansions
    : true
    boolean
    :
      'true'
    : 'yes'
      'false'
    : 'no'
    date_format
    : MM/dd/yy HH:mm:ss
    expansions
    :
      pinger
    :
        offline
    : offline
        check_interval
    : 10
        online
    : online
      vault
    :
        formatting
    :
          thousands
    : k
          trillions
    : T
          quadrillions
    : Q
          billions
    : B
          millions
    : M
      bungee
    :
        check_interval
    : 30
      javascript
    :
        engine
    : javascript
     
    javascript_placeholders.yml
    If you have the javascript expansion enabled, the plugin will generate a javascript_placeholders.yml file where you can create your own placeholders.
    There are 2 ways you can create these javascript based placeholders. Either specify the javascript directly in the expression: section for each placeholder, or specify a file that the javascript will be loaded from by setting the expression to the following format -
    expression: 'file: <filename with extension>'


    When an expression starts with the "file: " keyword, a file will be created in the /plugins/PlaceholderAPI/javascripts folder with the name and file format specified if it does not exist.

    These placeholders are reloaded on /placeholderapi reload so no need to restart your server to make changes.
    Code (YAML):
    # javascript_placeholders.yml
    # You can create custom placeholders which utilize javascript to determine the result of the custom placeholder you create.
    # You can specify if the result is based on a boolean or the actual javascript.
    #
    # If you do not specify a type: the placeholder will default to a boolean type
    # A boolean type must contain a true_result: and false_result:
    #
    # A string type only requires the expression: entry
    #
    # Javascript placeholders can contain normal placeholders in the expression, true_result, or false_result
    # These placeholders will be parsed to the correct values before the expression is evaluated.
    #
    # Your javascript placeholders will be identified by: %javascript_<identifier>%
    #
    # Javascript placeholder format:
    #
    #     BOOLEAN TYPE
    # <identifier>:
    #   expression: <expression>
    #   type: 'boolean'
    #   true_result: <result if expression is true>
    #   false_result: <result if expression is false>
    #
    #     STRING TYPE
    # <identifier>:
    #   expression: <expression>
    #   type: 'string'
    #
    #
    #  ==== ADVANCED VARIABLES ====
    # DO NOT USE THESE VARIABLES UNLESS YOU KNOW WHAT YOU ARE DOING!
    #
    # You can access a few Bukkit API classes and methods using certain keywords:
    #
    # Using "BukkitServer" in your javascript will return Bukkit.getServer()
    # You can use any methods inside of the Server class:
    # [/COLOR]
    [COLOR=rgb(0, 0, 0)]# Example: BukkitServer.getBannedPlayers().size().toFixed()
    # Will return how many players are banned
    #
    # This variable is handy if you want to iterate through all online players.'
    #
    # Using "BukkitPlayer" in your javascript will return the Player object you are setting placeholders for.
    # You can use any methods inside of the Player class:
    #
    # Example: BukkitPlayer.hasPermission("some.permission")
    # Will return if the player has a specific permission
    # This variable is handy if you want to check a players permission node, or access other methods inside of
    # the player class for the specified player.
    #
    # More advanced variables are coming soon! Only use these variables if you know what you are doing!
    #
    #  ==================
    #
    #
    # Javascript placeholder examples:
    #
    # millionaire:
    #   expression: '%vaulteco_balance% >= 1000000'
    #   type: 'boolean'
    #   true_result: '&aMillionaire'
    #   false_result: '&cbroke'
    # is_staff:
    #   expression: '"%vault_group%" == "Moderator" || "%vault_group%" == "Admin" || "%vault_group%" == "Owner"'
    #   type: 'boolean'
    #   true_result: '&bStaff'
    #   false_result: '&ePlayer'
    # health_rounded:
    #   expression: 'Math.round(%player_health%)'
    #   type: 'string'
    # staff_online:
    #   expression: 'var i = 0; for (var p in BukkitServer.getOnlinePlayers()) { if (BukkitServer.getOnlinePlayers()[p].hasPermission("staff.online")) {i = i+1;};} i.toFixed();'
    #   type: 'string'
    #
    #
    # You can optionally specify a file that the javascript expression will be loaded from if your expression
    # is bigger than 1 line. To specify javascript be loaded from a file, follow this format:
    #
    # is_op:
    #   expression: 'file: is_op.js'
    #   type: 'string'
    #
    # The following placeholder will attempt to load javascript from the /plugins/PlaceholderAPI/javascripts/is_op.js file
    # if the folder/file exists. If the folder/file does not exist it will be created.
    # You must specify the file extension with the file name. Any file extension is accepted.

    millionaire
    :
      expression
    : '%vaulteco_balance% >= 1000000'
      type
    : boolean
      true_result
    : '&aMillionaire'
      false_result
    : '&cbroke'
    is_staff
    :
      expression
    : '"%vault_group%" == "Moderator" || "%vault_group%" == "Admin" || "%vault_group%"
        == "Owner"'
      type
    : boolean
      true_result
    : '&bStaff'
      false_result
    : '&ePlayer'
    staff_online
    :
      type
    : string

     
    [​IMG]
    Code (YAML):
    permissions:
        placeholderapi.admin
    :
            description
    : ability to use admin commands
            default
    : op

    [​IMG]
    Use /papi help in game for a full list of commands.​

    [​IMG]
    All information on how to use this API can be found
    here


    If you enjoy this resource,
    please be kind enough to leave a like and review!


    :)
    [​IMG]


    It is an honor to have you use this plugin regardless if you choose to click the button above!
    License
    Code (Text):

                                  LICENSE AND TERMS BY extended_clip

             APPLIES TO USAGE, DISTRIBUTION, AND MODIFICATION OF SOFTWARE AND ITS SOURCE

                                       -=-=-=-=-=-=-=-=-=-=-=-=-            
                                       *     PlaceholderAPI    *
                                       -=-=-=-=-=-=-=-=-=-=-=-=-

                                  Copyright (c) 2016 Ryan McCarthy, USA

                 All rights are reserved to change, modify, or update this license without
                                     any prior notice or disclosure.
                     Any such changes or modification shall be effective immediately
                    from the "Last revision" date located at the bottom of this license.

    YOU MAY:
       - Run this software on your server
       - Utilize this API as a library in your public/commercial plugins.
       - Modify the source code for personal use only

    YOU MAY NOT:
       - Claim this software or source code to be a work of your own
       - Distribute original or "official" versions of this software.
       - Distribute modified or "unofficial" versions of this software

                                       -=-=-=-=-=-=-=-=-=-=-=-=-
                        Every “expansion” or “add-on” that utilizes this API is
                                subject to its own license or terms.
                                       -=-=-=-=-=-=-=-=-=-=-=-=-

                                       Last revision: 01/06/2017
     

    This plugin utilizes bStats to collect anonymous statistics
    https://bstats.org/plugin/bukkit/PlaceholderAPI
    Capricho, _Le0_, hallo_doei and 43 others like this.

Recent Reviews

  1. luisqe22
    luisqe22
    5/5,
    Version: 2.8.2
    now is fixed %server_max_players% thx and i love this api :) =================================================
  2. SlagHoedje
    SlagHoedje
    5/5,
    Version: 2.8.2
    Really good for developers AND end users! Easy to use API, easy to download expansions, and for end users, just drag and drop and your done!
  3. Creyonix
    Creyonix
    5/5,
    Version: 2.8.2
    Awesome plugin!
    Works perfectly fine for me and the best thing is, that it's free! Thanks for making this plugin!
  4. BoomerArrow119
    BoomerArrow119
    3/5,
    Version: 2.8.2
    3 stars for the big amount of placeholders and expansions, but when I reload the server, the plugin generates an exception (according to the console) and stops the server
  5. Qian_ai
    Qian_ai
    5/5,
    Version: 2.8.2
    Good API plugin, but I think it need a value to display minecraft default world border info.It's like %world_border_size% %world_border_time%.
  6. Rander
    Rander
    4/5,
    Version: 2.8.2
    Need help with placeholders, no functional discord server, so I couldn't get help and in discussion the help is not gain.
  7. ppt4973
    ppt4973
    5/5,
    Version: 2.8.2
    Such a great plugin. Its totally free and working fine!
    Thanks for maintaining it
  8. SomeonePIX
    SomeonePIX
    5/5,
    Version: 2.8.2
    I like this API plugin its realy the best i like that per world online placeholder work thanks
  9. LoLMeCZ
    LoLMeCZ
    5/5,
    Version: 2.8.2
    %server_online_<world>% Now is working !!!!!!!! Thanks !!!!!! I like it.
    It´s a realy best plugin !
  10. 71f6g5871253
    71f6g5871253
    3/5,
    Version: 2.8.2
    This is good, but I used it for "%server_online_<worldname>" which no longer exists, when I return I value 5 stars!