Home

What it is about

This plugin lets you configure your very own, custom, fixed PAPI (PlaceholderAPI) placeholders, that you can then use everywhere in plugin configurations with the prefix %custompapi_.

A typical example would be that you have a URL of a webpage with content about your Minecraft server. You want to display that URL in various places, like in the chat when entering a custom command, in a link in a custom book, in a link in a scoreboard etc. For all these things you usually use different plugins, and each plugin has its own configuration file where you would enter that. So instead of having to configure that URL in multiple different places, you configure just one custom static placeholder with a property like this:

homepage=http://www.acme.com

and then use it in all the plugin configuration file (assuming most plugins support PAPI) with the placeholder %custompapi_homepage%.

Configuration

For details about how to use the configuration property file, read the Configuration page.

Testing

To test your configuration, you can always manually resolve your custom placeholders by running the command papi parse me <placeholder>. For the example above, it would look like this (prefix for all custom placeholders is always %custompapi_):

/papi parse me %custompapi_homepage%

Known Issues / Limitations

• There are parts in the plugin that are currently not very efficiently written (String parsing operations). So it may not be advised to use placeholder values with internal references (${...}) in places where they are resolved several times per second, e.g. a scoreboard.
• Also, currently the placeholder values are fix (apart from using other placeholders). In the future, some kind of dynamic scripting functionality may be introduced (possibly using Apache JEXL) to allow to apply string operations, mathematical functions etc. to the values.