Skip to main content

PlaceholderAPI

CocoFFA integrates with PlaceholderAPI to provide useful placeholders for scoreboards, holograms, and other plugins.

Requirements​


Available Placeholders​

PlaceholderDescription
%cocoffa_wins%Player's total wins
%cocoffa_toplist_1%Player at position 1 in wins leaderboard
%cocoffa_toplist_2%Player at position 2 in wins leaderboard
%cocoffa_toplist_3%Player at position 3 in wins leaderboard
%cocoffa_toplist_<place>%Player at specified position

Customizing Placeholders​

Configure placeholder output in config.yml:

plugins/CocoFFA/config.yml
placeholders:
  prefix: "cocoffa"
  
  toplist_wins:
    placeholder: "toplist_<place>"
    value: "&#f5c400#%place% &f%player% &7» &#FF3737%wins% wins"
    none: "&#f5c400#%place% &f- &7» &#FF3737- wins"
  
  wins:
    placeholder: "wins"
    value: "&f%value%"
    none: "&c0"

Arena-Specific Placeholders​

These placeholders work within arena scoreboards and messages:

PlaceholderDescription
{arena_name}Current arena display name
{kills}Player's kills in current arena
{alive_players}Number of players still alive
{start_seconds}Seconds until arena starts
{current}Current player count
{max}Maximum player count

Example Usage​

Leaderboard Sign/Hologram​

Top FFA Winners:
%cocoffa_toplist_1%
%cocoffa_toplist_2%
%cocoffa_toplist_3%
%cocoffa_toplist_4%
%cocoffa_toplist_5%

Player Stats Display​

Your Wins: %cocoffa_wins%

Leaderboard Update Interval​

The leaderboard updates asynchronously. Configure the update interval in config.yml:

# How often should leaderboards update? (in seconds)
leaderboard-update-seconds: 180