Skip to content

TextplaceholderAPI

CleverNucleus edited this page Sep 20, 2021 · 4 revisions

Starting from PlayerEx version 3.0.2, TextplaceholderAPI is being supported. This means that PlayerEx natively comes shipped with some placeholders, ready for use:

  • %playerex:level
    • This displays a player's level (provided they have the Level attribute, else displays 0).
  • %playerex:name_top/x%
    • This displays the player's name whose level is the highest; where the argument x represents the position of the player in terms of level relative to everyone else. For example: x = 1 represents the player with the highest level; x = 2 represents the next highest level, and so on. The specific implementation is GameProfile#getName.
  • %playerex:level_top/x%
    • This displays the player's level whose level is the highest; where the argument x represents the position of the player in terms of level relative to everyone else. For example: x = 1 represents the player with the highest level; x = 2 represents the next highest level, and so on.

Notes

  • These placeholders include online and offline players, so long as they have joined the server at some point. This is done by implementing a persistent player cache. The cache can be cleared, or a single player can be removed from it. See Commands.