PlaceholderAPI 2.10.9

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

  1. 2.10.7 The Expansion update

    clip
    2.10.7

    Developers: This update has the potential to break your hooks / current placeholder providers if you are using outdated methods that are no longer supported. All placeholders being registered must now be registered in the form of a PlaceholderExpansion whether provided as a standalone jar or included with your plugin. The PlaceholderHook class should no longer be used and is scheduled to be removed next update. You must now register / unregister placeholders through PlaceholderExpansion#register() / unregister() .

    Our wiki will provide you with an example of updated API usage.


    Community: This update could possibly break some things for you depending on the expansions you use for placeholders or the plugins you use that parse PlaceholderAPI placeholders. So far with the expansions and hooks we have tested, the issue should be minimal but there is no guarantee... If you find a bug with a certain expansion or plugin that sets placeholders, please reach out to the developer and ask them to update.

    This update brings many improvements and new features to the plugin including, but not limited to:


    • API access simplifications
    • Placeholder parser performance improvements
    • Command system rewritten, some commands have changed, use /papi
    • Tab completions on everything
    • Support for 1.16

    Updates to the permissions:

    Code (Text):
      placeholderapi.*:
        description: "Ability to use all PAPI commands"
      placeholderapi.admin:
        description: "Ability to use all PAPI commands"
      placeholderapi.ecloud.*:
        description: "Ability to use all PAPI ecloud commands"
      placeholderapi.help:
        default: "op"
        description: "Allows you to view the list of PAPI commands"
      placeholderapi.info:
        default: "op"
        description: "Allows you to view expansion information"
      placeholderapi.list:
        default: "op"
        description: "Allows you to list active expansions"
      placeholderapi.ecloud:
        default: "op"
        description: "Allows you to access PAPI eCloud"
      placeholderapi.parse:
        default: "op"
        description: "Allows you to parse placeholders"
      placeholderapi.reload:
        default: "op"
        description: "Allows you to reload PAPI and its configuration"
      placeholderapi.version:
        default: "op"
        description: "Allows you to view the version of PAPI installed"
      placeholderapi.register:
        default: "op"
        description: "Allows you to register expansions"
      placeholderapi.unregister:
        default: "op"
        description: "Allows you to unregister expansions"
      placeholderapi.updatenotify:
        default: "op"
        description: "Notifies you when there is a PAPI update"
      placeholderapi.ecloud.info:
        default: "op"
        description: "Allows you to view cloud expansion information"
      placeholderapi.ecloud.list:
        default: "op"
        description: "Allows you to list eCloud expansions"
      placeholderapi.ecloud.clear:
        default: "op"
        description: "Allows you to clear the local eCloud expansion cache"
      placeholderapi.ecloud.toggle:
        default: "op"
        description: "Allows you to toggle/enable/disable the eCloud manager"
      placeholderapi.ecloud.status:
        default: "op"
        description: "Allows you to view the status of eCloud expansions"
      placeholderapi.ecloud.update:
        default: "op"
        description: "Allows you to update registered eCloud expansions"
      placeholderapi.ecloud.refresh:
        default: "op"
        description: "Allows you to refresh the local eCloud expansion cache"
      placeholderapi.ecloud.download:
        default: "op"
        description: "Allows you to download an expansion from the eCloud"
      placeholderapi.ecloud.placeholders:
        default: "op"
        description: "Allows you to view the placeholders of a eCloud expansion"

    Updates to the API include:
    Code (Text):
    PlaceholderHook
      => PlaceholderExpansion

    PlaceholderExpansion#onPlaceholderRequest(Player, String)
      => PlaceholderExpansion#onRequest(OfflinePlayer, String)

    PlaceholderExpansion#getPlugin
      => PlaceholderExpansion#getRequiredPlugin

    PlaceholderExpansion#getDescription
      => N/A (use the expansion cloud for this)

    PlaceholderExpansion#getLink
      => N/A (use the expansion cloud for this)

    PlaceholderAPI.setPlaceholders {Any version of this method}
      => PlaceholderAPI.setPlaceholders(OfflinePlayer, String)
      => PlaceholderAPI.setPlaceholders(OfflinePlayer, List<String>)

    PlaceholderAPI.register {Any version of this method}
      => PlaceholderExpansion#register

    PlaceholderAPI.unregister {Any version of this method}
      => PlaceholderExpansion#unregister

    PlaceholderAPI.getPlaceholders
      => PlaceholderAPIPlugin.getInstance().getLocalExpansionManager().getIdentifiers() // identifiers
      => PlaceholderAPIPlugin.getInstance().getLocalExpansionManager().getExpansions()  // expansions
      => PlaceholderAPIPlugin.getInstance().getLocalExpansionManager().findExpansionByName(String)       // lookup by name
      => PlaceholderAPIPlugin.getInstance().getLocalExpansionManager().findExpansionByIdentifier(String) // lookup by identifier

    You can view all of the changes we made for this update directly on GitHub


    You can request help for issues either on GitHub or our Discord server

    Have a good day! :)
Return to update list...