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 uses a comprehensive permission system to control access to commands and features. All permissions are defined in plugin.yml.
Permission Structure
Permissions follow a hierarchical structure:
superior.*
├── superior.island.*
│ ├── superior.island.create
│ ├── superior.island.invite
│ └── ...
└── superior.admin.*
├── superior.admin.add
├── superior.admin.bypass
└── ...
Wildcard Permissions
Grants all admin and island command permissions. Default: op
Grants all island command permissions (non-admin)
Grants all admin command permissions. Default: op
superior.island.stacker.*
Grants ability to stack all block types
Island Commands
Permissions for regular player island commands:
Basic Commands
Island Creation & Management
Disband your island permanently
Change the name of your island
superior.island.setteleport
Change the teleport location of your island
Re-calculate the island worth and level
Invite a player to your island
Accept an invitation from a player
Kick a player from your island
Promote a member in your island
Demote a member in your island
Change the role of a player in your island
Transfer your island’s leadership
Add a player as a co-op to your island
Remove a player from being a co-op in your island
Ban a player from your island
Unban a player from your island
Kick a visitor from your island
Open the island to the public
Close the island to the public
Island Features
Teleport to the visitors location of an island
Check the amount of money inside an island’s bank
Deposit money from your personal account into the island’s bank
Withdraw money from your island’s bank into your personal account
Island Settings & Permissions
superior.island.permissions
Get all permissions for an island role
Change the biome of the island
Change the border color of the islands
Additional Features
Use colors within island chat
Permission to use the /is toggle command
superior.island.toggle.border
Toggle island borders
superior.island.toggle.blocks
Toggle stacked blocks placements
Change your personal language
Get information about island members status
superior.island.setdiscord
Set the discord of the island for island payouts
superior.island.setpaypal
Set the paypal email of the island for island payouts
Admin Commands
Permissions for administrative commands:
Core Admin Commands
List of all admin commands
Reload all configurations and tasks of the plugin
Show stats about the plugin
Manage modules of the plugin
Toggle bypass mode (ignore island protection)
superior.admin.bypass.warmup
Bypass teleport warmup delays
Toggle chat spy mode (see all island chat)
Join an island without an invitation
Kick a player from his island
Disband another player’s island permanently
Purge islands from database
Island Value Modifications
Change another player’s island size
Expand another player’s island size
superior.admin.setteamlimit
Set members limit for another player’s island
superior.admin.addteamlimit
Increase members limit for another player’s island
superior.admin.setcooplimit
Set coop players limit for another player’s island
superior.admin.addcooplimit
Increase coop players limit for another player’s island
superior.admin.setwarpslimit
Set the warps limit of an island
superior.admin.addwarpslimit
Increase the warps limit of an island
superior.admin.setblocklimit
Set block limit for another player’s island
superior.admin.addblocklimit
Increase block limit for another player’s island
superior.admin.removeblocklimit
Remove a block limit for an island
superior.admin.setentitylimit
Set entity limit for another player’s island
superior.admin.addentitylimit
Increase entity limit for another player’s island
superior.admin.removeentitylimit
Remove an entity limit for an island
superior.admin.setcropgrowth
Set the crop growth multiplier for another player’s island
superior.admin.addcropgrowth
Increase the crop growth multiplier for another player’s island
superior.admin.setspawnerrates
Set the spawner rates multiplier for another player’s island
superior.admin.addspawnerrates
Increase the spawner rates multiplier for another player’s island
superior.admin.setmobdrops
Set the mob drops multiplier for another player’s island
superior.admin.addmobdrops
Increase the mob drops multiplier for another player’s island
superior.admin.setbanklimit
Set the bank limit for another player’s island
superior.admin.addbanklimit
Increase the bank limit for another player’s island
Deposit money into another player’s island bank
Withdraw money from another player’s island bank
Advanced Admin Commands
superior.admin.setgenerator
Change percentage of a material for the cobblestone generator
superior.admin.addgenerator
Add percentage of a material for the cobblestone generator
superior.admin.cleargenerator
Clear generator rates for a specific island
Set the island effect level of another player’s island
Add an island effect for another player’s island
superior.admin.setupgrade
Set the level of an upgrade for another player’s island
Rankup an upgrade for an island
superior.admin.syncupgrades
Sync upgrade values for an island
Grant a bonus to a player
Open the plugin settings editor
superior.admin.setsettings
Toggle settings for a specific island
superior.admin.resetsettings
Reset all island settings for a specific island
superior.admin.setpermission
Set a required role for a permission for all the islands
superior.admin.resetpermissions
Reset all island permissions for a specific island
Schematic & World Management
Create schematics for the plugin
superior.admin.setislandpreview
Set the preview location for an island
Unlock a world for an island
superior.admin.resetworld
Reset a world for an island
Set the biome of an island
Change the name of an island
Get information about an island
Teleport to other islands
Teleport to the spawn location
Set the spawn location of the server
Open island’s chest of another island
superior.admin.setchestrow
Set the chest rows for another player’s island
Check a block count on a specific island
superior.admin.setblockamount
Set the block amount in a specific location
Re-calculate the worth of an island
Send a player a message without any prefixes
Send to all island members a message without any prefixes
Open a custom menu for a player
Island Management (Admin)
Promote a member in another player’s island
Demote a member in another player’s island
Transfer an island to someone else
superior.admin.setrolelimit
Set role limit for another player’s island
Open an island to the public
Close an island to the public
Ignore an island from top islands
Unignore an island from top islands
Change the status of a mission for a player
Set the rating of another player
superior.admin.removeratings
Remove all ratings given by a player
Delete a warp for an island
Toggle island fly for another player
superior.admin.givedisbands
Give disbands to a player
superior.admin.setdisbands
Set a player’s amount of island disbands
Cooldown Bypass Permissions
Bypass specific command cooldowns:
superior.cooldown.bypass.recalc
Bypass the recalculate command cooldown (default: 30 seconds)
You can add custom cooldown bypass permissions in config.yml:
commands-cooldown :
recalc :
cooldown : 30000
bypass-permission : superior.cooldown.bypass.recalc
Permission Setup Examples
LuckPerms Examples
# Grant all island permissions to default group
lp group default permission set superior.island. * true
# Grant admin permissions to admin group
lp group admin permission set superior.admin. * true
# Grant specific schematic access
lp group vip permission set superior.island.create.mycel true
# Bypass teleport warmup for staff
lp group staff permission set superior.admin.bypass.warmup true
PermissionsEx Examples
groups :
default :
permissions :
- superior.island.*
vip :
permissions :
- superior.island.create.mycel
- superior.island.create.desert
admin :
permissions :
- superior.admin.*
- superior.admin.bypass.warmup
Custom Schematic Permissions
For custom schematics, the permission format is:
superior.island.create.<schematic-name>
Example:
superior.island.create.custom
superior.island.create.advanced
superior.island.create.premium
Schematic permissions are automatically checked when players try to select an island type during creation.
Best Practices
Organize permissions into logical groups:
Default - Basic island commands (create, teleport, invite)
VIP - Additional features (extra schematics, bypass cooldowns)
Staff - Moderation tools (bypass, teleport to islands)
Admin - Full admin permissions
Use wildcards carefully:
superior.island.* is safe for regular players
superior.admin.* should only be given to trusted staff
superior.* grants full access - use sparingly
Always test new permission configurations:
Create a test user with the permissions
Verify they can/cannot access specific features
Check for unintended access or restrictions
Troubleshooting
If players cannot use any island commands, verify they have at least superior.island.* permission.
Check for typos in permission nodes
Verify permission manager is loaded before SuperiorSkyblock2
Use /lp verbose (LuckPerms) to debug permission checks
Ensure wildcards are properly configured
Verify player has superior.admin.bypass permission
Check if bypass mode is toggled on with /is admin bypass
Bypass only works for island protection, not all restrictions