PlaceholderAPI Integration

Use dynamic placeholders to display island and player information

SuperiorSkyblock2 provides extensive PlaceholderAPI support with over 150 placeholders for displaying island statistics, player data, and leaderboard information.

Setup

1. Install PlaceholderAPI

   Download PlaceholderAPI from SpigotMC and place it in your plugins folder.

2. Restart Server

   Restart your server. SuperiorSkyblock2 will automatically detect and hook into PlaceholderAPI.

3. Verify Integration

   Check your console for:

   [SuperiorSkyblock2] Using PlaceholderAPI for placeholders support.
   

Placeholder Format

All SuperiorSkyblock2 placeholders use the %superior_ prefix:

%superior_<category>_<placeholder>%

Player Placeholders

Display information about the player viewing the placeholder.

Basic Player Info

Placeholder	Description	Example Output
%superior_player_role%	Player’s island role	Member
%superior_player_role_display%	Formatted role name	Island Member
%superior_player_locale%	Player’s language	en-US
%superior_player_texture%	Player’s skin texture value	eyJ0ZXh0dXJlcy...

Player Settings

Placeholder	Description	Example Output
%superior_player_bypass%	Bypass mode enabled	true / false
%superior_player_fly%	Island fly enabled	true / false
%superior_player_border_color%	World border color	Blue
%superior_player_world_border%	Border visibility	true / false
%superior_player_blocks_stacker%	Block stacking enabled	true / false
%superior_player_team_chat%	Team chat mode	true / false
%superior_player_panel%	Panel toggled	true / false
%superior_player_schematics%	Schematic mode	true / false
%superior_player_chat_spy%	Admin spy mode	true / false

Player Statistics

Placeholder	Description	Example Output
%superior_player_disbands%	Number of island disbands	3
%superior_player_missions_completed%	Total missions completed	15

Island Placeholders

Display information about a player’s island.

Basic Island Info

Placeholder	Description	Example Output
%superior_island_name%	Island name (raw)	SkyIsland
%superior_island_name_formatted%	Island name with colors	§6SkyIsland
%superior_island_name_stripped%	Island name without colors	SkyIsland
%superior_island_name_leader%	Name or owner’s name	SkyIsland
%superior_island_leader%	Island owner’s name	Notch
%superior_island_uuid%	Island unique ID	a1b2c3d4...
%superior_island_exists%	Player has island	true / false
%superior_island_description%	Island description	Welcome!
%superior_island_creation_time%	Creation date	Jan 1, 2024
%superior_island_schematic%	Schematic used	normal

Island Worth & Level

Placeholder	Description	Example Output
%superior_island_worth%	Formatted worth	1,234,567
%superior_island_worth_format%	Fancy formatted worth	1.23M
%superior_island_worth_int%	Worth as integer	1234567
%superior_island_worth_raw%	Raw worth value	1234567.89
%superior_island_level%	Formatted level	12,345
%superior_island_level_format%	Fancy formatted level	12.3K
%superior_island_level_int%	Level as integer	12345
%superior_island_level_raw%	Raw level value	12345.67
%superior_island_raw_worth%	Worth without bonuses	1,000,000
%superior_island_raw_level%	Level without bonuses	10,000
%superior_island_bonus_worth%	Bonus worth amount	234,567
%superior_island_bonus_level%	Bonus level amount	2,345

Island Location

Placeholder	Description	Example Output
%superior_island_center%	Center coordinates	0, 100, 0
%superior_island_center_x%	Center X coordinate	0
%superior_island_center_y%	Center Y coordinate	100
%superior_island_center_z%	Center Z coordinate	0
%superior_island_home%	Home location	5, 105, -3
%superior_island_home_x%	Home X coordinate	5
%superior_island_home_y%	Home Y coordinate	105
%superior_island_home_z%	Home Z coordinate	-3
%superior_island_world%	Island world name	SuperiorWorld

Island Size & Settings

Placeholder	Description	Example Output
%superior_island_radius%	Island radius	50
%superior_island_size%	Island dimensions	101 x 101
%superior_island_size_format%	Rounded dimensions	100 x 100
%superior_island_raw_radius%	Raw radius value	50
%superior_island_biome%	Island biome	Plains
%superior_island_locked%	Island is locked	false

Island Members

Placeholder	Description	Example Output
%superior_island_team_size%	Total members	5
%superior_island_team_size_online%	Online members	3
%superior_island_team_limit%	Member limit	10
%superior_island_raw_team_limit%	Raw member limit	10
%superior_island_team_list%	Member names	Notch, Jeb, Dinnerbone
%superior_island_is_leader%	Player is owner	true / false
%superior_island_is_member%	Player is member	true / false
%superior_island_is_coop%	Player is coop	false
%superior_island_is_visitor%	Player is visitor	false

Island Co-op

Placeholder	Description	Example Output
%superior_island_coop_size%	Number of coops	2
%superior_island_coop_limit%	Coop limit	5
%superior_island_raw_coop_limit%	Raw coop limit	5
%superior_island_coop_list%	Coop player names	Steve, Alex

Island Visitors & Bans

Placeholder	Description	Example Output
%superior_island_visitors_count%	Current visitors	4
%superior_island_visitors_list%	Visitor names	Player1, Player2
%superior_island_unique_visitors_count%	Total unique visitors	127
%superior_island_unique_visitors_list%	All unique visitors	Player1, Player2...
%superior_island_bans_count%	Banned players	1
%superior_island_bans_list%	Banned player names	Griefer123
%superior_island_players_count%	Players on island	3
%superior_island_players_list%	Player names on island	Notch, Steve, Alex

Island Bank

Placeholder	Description	Example Output
%superior_island_bank%	Bank balance	50,000
%superior_island_bank_format%	Fancy balance	50K
%superior_island_bank_int%	Balance as integer	50000
%superior_island_bank_raw%	Raw balance	50000.00
%superior_island_bank_limit%	Bank capacity	1,000,000
%superior_island_bank_limit_format%	Fancy capacity	1M
%superior_island_bank_next_interest%	Next interest time	5h 30m
%superior_island_bank_last_interest%	Last interest time	30m ago

Island Multipliers

Placeholder	Description	Example Output
%superior_island_crops_multiplier%	Crop growth rate	2.0
%superior_island_raw_crops_multiplier%	Raw crop multiplier	2.0
%superior_island_spawners_multiplier%	Spawner rate	1.5
%superior_island_raw_spawners_multiplier%	Raw spawner multiplier	1.5
%superior_island_drops_multiplier%	Mob drops rate	3.0
%superior_island_raw_drops_multiplier%	Raw drops multiplier	3.0

Island Warps

Placeholder	Description	Example Output
%superior_island_warps%	Number of warps	3
%superior_island_warps_limit%	Warp limit	5
%superior_island_raw_warps_limit%	Raw warp limit	5

Island Rating

Placeholder	Description	Example Output
%superior_island_rating%	Average rating	4.5
%superior_island_rating_amount%	Number of ratings	10
%superior_island_rating_stars%	Star representation	★★★★☆

Island Discord & PayPal

Placeholder	Description	Example Output
%superior_island_discord%	Discord (if permitted)	discord.gg/abc
%superior_island_discord_all%	Discord (always shown)	discord.gg/abc
%superior_island_paypal%	PayPal (if permitted)	[e-mail]
%superior_island_paypal_all%	PayPal (always shown)	[e-mail]

Island Storage

Placeholder	Description	Example Output
%superior_island_chest_size%	Chest rows	6

World Unlocks

Placeholder	Description	Example Output
%superior_island_normal_unlocked%	Normal world unlocked	true
%superior_island_nether_unlocked%	Nether unlocked	true
%superior_island_end_unlocked%	End unlocked	false

Timing

Placeholder	Description	Example Output
%superior_island_last_time_updated%	Last calculation	5m ago

Dynamic Placeholders

These placeholders require additional parameters.

Block Counts

%superior_island_block_count_<material>%
%superior_island_count_<material>%

Examples:

• %superior_island_block_count_diamond_ore% → 156
• %superior_island_count_stone% → 10543

Block Values

%superior_island_block_worth_<material>%
%superior_island_block_level_<material>%
%superior_island_block_total_worth_<material>%
%superior_island_block_total_level_<material>%

Examples:

• %superior_island_block_worth_diamond_block% → 1000
• %superior_island_block_level_emerald_ore% → 500

Block & Entity Limits

%superior_island_block_limit_<material>%
%superior_island_entity_limit_<entity>%
%superior_island_entity_count_<entity>%

Examples:

• %superior_island_block_limit_hopper% → 50
• %superior_island_entity_limit_cow% → 100
• %superior_island_entity_count_zombie% → 23

Island Effects

%superior_island_effect_<effect>%

Example:

• %superior_island_effect_speed% → 2

Island Upgrades

%superior_island_upgrade_<upgrade>%

Example:

• %superior_island_upgrade_crop_growth% → 5

Role Information

%superior_island_role_count_<role>%
%superior_island_role_limit_<role>%

Examples:

• %superior_island_role_count_member% → 3
• %superior_island_role_limit_officer% → 2

Permissions

%superior_island_permission_<permission>%
%superior_island_permission_role_<permission>%

Examples:

• %superior_island_permission_break% → Member
• %superior_island_permission_role_use% → Coop

Island Flags

%superior_flag_<flag>%

Examples:

• %superior_flag_pvp% → true
• %superior_flag_mob_spawning% → false

Generator Rates

%superior_island_generator_percentage_<dimension>_<material>%
%superior_island_generator_amount_<dimension>_<material>%

Examples:

• %superior_island_generator_percentage_normal_diamond_ore% → 5
• %superior_island_generator_amount_nether_quartz_ore% → 150

Dimensions: normal, nether, end

Missions

%superior_island_mission_status_<mission>%
%superior_island_missions_completed_<category>%
%superior_player_missions_completed_<category>%

Examples:

• %superior_island_mission_status_mine_diamonds% → true
• %superior_island_missions_completed_farming% → 8

Member Information

%superior_member_<index>%

Example:

• %superior_member_1% → Notch
• %superior_member_2% → Jeb

Visitor Information

%superior_visitor_last_join_<player>%

Example:

• %superior_visitor_last_join_Steve% → Dec 25, 2024

Island Data

%superior_island_data_<key>%

Retrieves custom persistent data stored on the island.

Location-Based Placeholders

Use location_ prefix to get island info at player’s current location instead of their own island:

%superior_island_location_<placeholder>%

Example:

• %superior_island_location_leader% → Returns owner of island at player’s location

Leaderboard Placeholders

Top Islands

%superior_island_top_<sorting>_<position>_<data>%

Sorting Types: worth, level, rating, players

Data Types:

• value - Formatted value
• value_format - Fancy formatted value
• value_raw - Raw value
• leader - Island owner name
• Any island placeholder

Examples:

• %superior_island_top_worth_1_leader% → Notch
• %superior_island_top_level_1_value_format% → 1.2M
• %superior_island_top_rating_5_value% → 4.8
• %superior_island_top_worth_1_name% → Best Island

Global Placeholders

Placeholder	Description	Example Output
%superior_island_total_count%	Total islands	1,234
%superior_island_total_worth%	Combined worth	1,234,567,890
%superior_island_total_level%	Combined level	987,654

Usage Examples

Scoreboard

lines:
  - '&6Island: &e%superior_island_name%'
  - '&6Level: &e%superior_island_level_format%'
  - '&6Worth: &e%superior_island_worth_format%'
  - '&6Members: &e%superior_island_team_size%/%superior_island_team_limit%'
  - '&6Bank: &e$%superior_island_bank_format%'

Chat Format

format: '[%superior_player_role_display%] {PLAYER}: {MESSAGE}'

Holograms

&6Top Island
%superior_island_top_worth_1_leader%
&eWorth: %superior_island_top_worth_1_value_format%

Tab List

header: '&6&lSUPERIOR SKYBLOCK\n&7Islands: %superior_island_total_count%'
footer: '&7Your Level: &e%superior_island_level_format%'

Troubleshooting

Placeholders showing as text

• Ensure PlaceholderAPI is installed and running
• Check that SuperiorSkyblock2 detected PAPI (check console)
• Use /papi parse me %superior_island_name% to test

Placeholders showing empty or null

• Verify the player has an island for island placeholders
• Check placeholder spelling (they’re case-sensitive)
• Ensure the requested data exists (e.g., upgrade names, material types)

External plugin not showing placeholders

• Confirm the plugin supports PlaceholderAPI
• Some plugins require {placeholder} format instead of %placeholder%
• Check the external plugin’s documentation

Testing Placeholders

Use PlaceholderAPI’s parse command to test:

/papi parse me %superior_island_level%

Use the /papi ecloud download Superior command if the expansion isn’t automatically registered.