Plugin Integrations

Integrations with third party plugins to extend BattleArena functionality.

Placeholder API

Within BattleArena, there is support to display arena info through a plugin called PlaceholderAPI. If you are unfamiliar with the plugin, it allows for you to show information with certain placeholders (e.g. %player_name% will return the player name) in plugins that have support for PlaceholderAPI. An example usage of this is displaying the number of players in a competition on a hologram through PlaceholderAPI.

Placeholders

These are the placeholders for BattleArena. They are split into three sections: general placeholders, map placeholders and competition placeholders. General placeholders are not tied to a specific competition and show general information about arenas. Map placeholders pull information from a specific map. Competition placeholders will only resolve for players in a competition and will vary from player to player depending on which competition they are in.

General Placeholders

These placeholders show statistics for the arena specified. This information will look the same to each player seeing it in-game. <arena> is a placeholder for the arena to display information on (i.e. arena, battlegrounds, skirmish, etc.)

Map Placeholders

These placeholders show statistics for the arena and map specified. This information will look the same to each player seeing it in-game. <arena> is a placeholder for the arena to display information on (i.e. arena, battlegrounds, skirmish, etc.), and <map> is the name of the map.

Competition Placeholders

These placeholders resolve for the current competition the player is in. 

Custom Items

BattleArena has support for a number of plugins with custom items. This means that anywhere an item can be defined, if one of these plugins is installed, you can use an item from there.

Plugins Supported

Defining Items

In order to use items from these plugins, the same format of <namespace>:<key> for Minecraft items is used, with the namespace being the lowercase name of the plugin. For example: