diff --git a/Placeholders.md b/Placeholders.md index 4039753..ce08254 100644 --- a/Placeholders.md +++ b/Placeholders.md @@ -1,17 +1,24 @@ Placeholders allow you to display data from any of BentoBox's addons and gamemodes on other plugins! -## Enable the placeholders +## How to use the placeholders? -### Download the placeholder api you need +### Download the placeholder API you need. As of 1.5.0, BentoBox supports both [**PlaceholderAPI**](https://www.spigotmc.org/resources/placeholderapi.6245/) and [**MVdWPlaceholderAPI**](https://www.spigotmc.org/resources/mvdwplaceholderapi.11182/). -### EssentialsChat +We **highly recommend that you use PlaceholderAPI**. However, plugins from MVdW (such as *Featherboard*) incite you heavily to use MVdWPlaceholderAPI. Yet, you should note that **MVdWPlaceholderAPI provides us less flexibility with our placeholders that PlaceholderAPI**. As such, we may provide **limited support** with issues related to MVdWPlaceholderAPI. + +### Launch the server and you're ready to go! + +Regardless of the placeholder API you're using, there are no more steps than just launching the server. There are **no expansions to download**: BentoBox handles everything else! + +## How to display a placeholder in the chat with EssentialsChat? If you're using **EssentialsChat** and **PlaceholderAPI**, you **must** install [**ChatInjector**](https://www.spigotmc.org/resources/chatinjector.38327/) in order for placeholders to show up in the chat. Although ASkyBlock was supporting this natively, it was at the cost of a support burden for us developers (it was unstable). That's why we decided not to port this feature into BentoBox. ## Default placeholders for gamemode addons -Each GameMode addon has some default placeholders that get automatically registered to them as of [BentoBox 1.4.0](https://github.com/BentoBoxWorld/BentoBox/releases/tag/1.4.0). + +As of [BentoBox 1.4.0](https://github.com/BentoBoxWorld/BentoBox/releases/tag/1.4.0), all gamemode addons get some default placeholders automatically registered to them. ### 1.4.0 | Placeholder | Description |