Documentation Index Fetch the complete documentation index at: https://mintlify.com/BG-Software-LLC/SuperiorSkyblock2/llms.txt
Use this file to discover all available pages before exploring further.
SuperiorSkyblock2 provides extensive PlaceholderAPI support with over 150 placeholders for displaying island statistics, player data, and leaderboard information.
Setup
Install PlaceholderAPI
Download PlaceholderAPI from SpigotMC and place it in your plugins folder.
Restart Server
Restart your server. SuperiorSkyblock2 will automatically detect and hook into PlaceholderAPI.
Verify Integration
Check your console for: [SuperiorSkyblock2] Using PlaceholderAPI for placeholders support.
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) email@example.com%superior_island_paypal_all%PayPal (always shown) email@example.com
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
%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 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, endMissions %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
%superior_member_<index>%
Example:
%superior_member_1% → Notch%superior_member_2% → Jeb
%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, playersData Types:
value - Formatted valuevalue_format - Fancy formatted valuevalue_raw - Raw valueleader - Island owner nameAny 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%'
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.