diff --git a/wiki/FAQ.md b/wiki/FAQ.md index 5fef6e1..f15fc47 100644 --- a/wiki/FAQ.md +++ b/wiki/FAQ.md @@ -1,16 +1,30 @@ +[readme]: https://github.com/PlaceholderAPI/PlaceholderAPI/blob/docs/wiki/wiki/README.md + Here are frequently asked questions about stuff related to PlaceholderAPI. -## It only shows %placeholder% and not the variable -Make sure, that you've tried the following steps: -- PlaceholderAPI is installed and running (Shows green in `/pl` and responds to the `/papi` command) -- You downloaded the expansion with `/papi ecloud download [expansion]` -A list of available expansions and their placeholders can be found [[here|Placeholders]]! -Also note that not all placeholders are in a seperate expansion. Some are "hardcoded" into a plugin. -- You reloaded PlaceholderAPI with `/papi reload` after downloading an expansion. -- Any possible dependency for the expansion (Plugin) is installed and running. -- The placeholder doesn't contain any typos. -- The plugin that should use the placeholder actually supports PlaceholderAPI. -For a list of plugins supporting PlaceholderAPI go [[here|Plugins-using-PlaceholderAPI]]. +## It only shows `%placeholder%` and not the variable +When a plugin or `/papi parse me %placeholder%` only returns the placeholder itself and no value should you check for the following things: + +### The expansion is actually installed. +In many cases is the cause that the expansion of the placeholder is missing. +Just execute `/papi ecloud download ` followed by `/papi reload` to activate it. You can find a list of Expansions and their Placeholders [[on this page|Placeholders]]. + +**NOTE!** +Not all placeholders come in their own expansion. Some plugins *hardcode* them in and load them on startup, when hooking into PlaceholderAPI. + +### Plugin actualls supports PlaceholderAPI +It can happen that the plugin you use to display the placeholder in doesn't support PlaceholderAPI. In such a case check, if the parse command returns the actual value of a placeholder. +If that is the case while the plugin is still displaying the placeholder, can this be an indicator of the plugin not supporting PlaceholderAPI. + +You can find a list of plugins supporting PlaceholderAPI [[here|Plugins-using-PlaceholderAPI]]. +Just make sure that "Supports placeholders" has a check mark in front of it. + +### No typo in the placeholder +Double-check that the placeholder you set doesn't contain a typo. You can use `/papi ecloud placeholders ` (replace `` with the name of the expansion) to get a list of all the placeholders the expansion may have. +Keep in mind that this only works for separate expansions on the eCloud and not for those that are loaded by plugins. + +### Plugin is enabled +If an expansion depends on a plugin, make sure you have the plugin installed and that it is enabled (Shows green in `/pl`). ## I can't download the expansion Make sure, that the connection to the cloud (https://api.extendedclip.com) isn't blocked by a firewall or similar. @@ -19,4 +33,8 @@ Next step would be to check if the expansion actually exists on the cloud. Not a If both checks failed, go to the cloud-page and download the jar manually. Put it then in the `expansions` folder of PlaceholderAPI (`/plugins/PlaceholderAPI/expansions`) ## How can other plugins use my placeholders with PlaceholderAPI? -A tutorial can be found [[here|Hook into PlaceholderAPI]]! \ No newline at end of file +A tutorial can be found [[here|Hook into PlaceholderAPI]]! + +## Can I help on this wiki? +You sure can! +We welcome contributions to our wiki by everyone. If you found a typo or want to improve this wiki in another way, head over to the [Wiki's readme file][readme] to find out about how you can contribute towards this wiki.