Plugin Placeholders

Using the placeholders

With the power of PlaceholderAPI, HeadsPlus provides several placeholders that can be used in holograms, signs, and scoreboards.

Personal placeholders

%headsplus_xp%

Displays how much XP (from HeadsPlus) you currently have.

%headsplus_completed_challenges_total%

Displays the number of challenges that you've completed.

%headsplus_level%

Displays the current level you're at.

%headsplus_hunting_[Mob type]%

Displays the total number of heads dropped from hunting, where [Mob type] is a selected type of mob.

Examples include:

• total
• pig
• cavespider
• irongolem

%headsplus_crafting_[Mob type]%

Displays the total number of heads retrieved from crafting, where [Mob type] is a selected type of mob.

Examples include:

• total
• pig
• cavespider
• irongolem

%headsplus_selling_[Mob type]%

Displays the total number of heads sold by the player, where [Mob type] is a selected type of mob.

Examples include:

• total
• pig
• cavespider
• irongolem

Rankings placeholders

%headsplus_top_CATEGORY_entity=ENTITY,HP#HEAD_ID_NUMBER_player%

Displays the top player's name in a specific category, a specific mob type, and the position. Keywords are as follows:

• Valid CATEGORY inputs: SELLING, HUNTING, CRAFTING
• Valid ENTITY inputs include: PIG, CAVE_SPIDER and any mob name (a full list from Spigot is here, but mob names may vary from version, and not all EntityTypes are used in HeadsPlus)
• Valid HEAD_ID that is in the heads.yml file.
• NUMBER is the position on the scoreboard, which starts at 0 (so 0 is 1st, 1 is 2nd, etc.)
• player can also be replaced with score to return the player's score.

Examples:

%headsplus_top_CRAFTING_0_player% - %headsplus_top_CRAFTING_0_score% (Thatsmusic99 - 236)  
%headsplus_top_HUNTING_entity=ZOMBIE_3_player% - %headsplus_top_HUNTING_zombie_3_score% (Basher372 - 42)
%headsplus_top_HUNTING_HP#iron_golem_0_player%  
%headsplus_top_HUNTING_HP#iron_golem,entity=IRON_GOLEM_0_player%