BG-Software
Search…
Island Permissions
Permissions that can be assigned to members or roles, that give access to certain things in the island. You can remove permissions from being given by not having them inside the permissions menu.

Built-in Permissions

All Gives access to all the permissions. Recommendation: Should only be given to island leaders.
Animal Breed Gives access to breed animals inside the island.
Animal Damage Gives access to damage animals inside the island
Animal Spawn Gives access to spawn animals inside the island
Ban Member Gives access to ban members from the island
Break Gives access to break blocks inside the island
Build Gives access to build inside the island
Change Name Gives access to change the name of the island
Chest Access Gives access to access chests inside the island
Close Bypass Gives bypass to the lock island status
Close Island Gives access to close (lock) the island to the public
Coop Member Gives access to add a player as a coop-member to the island
Delete Warp Gives access to delete island warps
Demote Members Gives access to demote island members
Deposit Money Gives access to deposit money into the island's bank
Disband Island Gives access to disband the island
Discord Show Gives access to see the discord of the island
Drop Items Gives access to drop items inside the island
Ender Pearl Gives access to use ender pearls inside the island
Expel Bypass Gives bypass from being expelled from the island
Expel Players Gives the ability to expel players from the island
Farm Tramping Gives access to destroy farms (jump on them) inside the island
Fertilize Gives access to fertilize blocks around the island
Fish Gives access to fish inside the island
Fly Gives access to fly around the island
Interact Gives access to interact with blocks inside the island. The interactable blocks are configurable and can be found under the interactables.yml file.
Invite Member Gives access to invite new players into the island
Island Chest Gives access to the community chest of the island
Item Frame Gives access to break and interact with item frames inside the island
Kick Member Gives access to kick members from the island
Leash Gives access to leash mobs inside the island
Minecart Damage Gives access to damage vehicles inside the island
Minecart Enter Gives access to enter vehicles inside the island
Minecart Open Gives access to open vehicles inside the island
Minecart Place Gives access to place vehicles inside the island
Monster Damage Gives access to damage monsters inside the island
Monster Spawn Gives access to spawn monsters inside the island
Open Island Gives access to open (unlock) the island to the public
Painting Gives access to break paintings inside the island
Paypal Show Gives access to see the paypal of the island
Pickup Drops Gives access to pick up drops inside the island
Pickup Fish Gives access to pickup fish with buckets inside the island
Promote Members Gives access to promote members inside the island
Rankup Gives access to rankup upgrade levels
Rating Show Gives access to see the ratings that were given to the island
Set Biome Gives access to change the biome of the island
Set Discord Gives access to set the discord of the island
Set Home Gives access to set the teleport location of the island
Set Paypal Gives access to set the paypal of the island
Set Permission Gives access to change the permissions of the island
Set Role Gives access to set roles to members of the island
Set Settings Gives access to change the settings of the island
Set Warp Gives access to set new warps inside the island
Sign Interact Gives access to interact with signs inside the island
Spawner Break Gives access to break spawners inside the island
Uncoop Member Gives access to remove members from being coop from the island
Use Gives access to use blocks inside the island
Valuable Break Gives access to break valuable blocks inside the island
Villager Trading Gives access to trade with villagers inside the island
Withdraw Money Gives access to withdraw money from the island's bank

Create your own permission

In order to create your own permission, you must have knowledge in Java and the Spigot API. Alongside of these, you'll also need the SuperiorSkyblock's API, which can be found here. Island permissions are represented as a class called "IslandPrivilege", and it's really easy to register custom ones! In this tutorial, I will make a custom permission for breaking beacons inside islands. First, I register the custom permission by listening to the PluginInitializeEvent, and there I am calling the IslandPrivilege.register() method.
1
public final class BeaconPlacePermission implements Listener {
2
3
private static IslandPrivilege BEACON_BREAK;
4
5
@EventHandler
6
public void onPluginInit(PluginInitializeEvent e){
7
IslandPrivilege.register("BEACON_BREAK");
8
BEACON_BREAK = IslandPrivilege.getByName("BEACON_BREAK");
9
}
10
11
}
Copied!
PluginInitializeEvent is called in the onEnable() method of SuperiorSkyblock. Therefore, you must have your plugin enabling before SuperiorSkyblock, which can be done by adding "SuperiorSkyblock2" as a depend/softdepend plugin.
After registering the custom permission, we can simply implement the restriction for breaking beacons!
1
public final class BeaconPlacePermission implements Listener {
2
3
private static IslandPrivilege BEACON_BREAK;
4
5
@EventHandler
6
public void onPluginInit(PluginInitializeEvent e){
7
IslandPrivilege.register("BEACON_BREAK");
8
BEACON_BREAK = IslandPrivilege.getByName("BEACON_BREAK");
9
}
10
11
@EventHandler
12
public void onBlockBreak(BlockBreakEvent e){
13
//Checking for beacons only.
14
if(e.getBlock().getType() != Material.BEACON)
15
return;
16
17
Island island = SuperiorSkyblockAPI.getIslandAt(e.getBlock().getLocation());
18
19
// Making sure the block was broken inside an island.
20
if(island == null)
21
return;
22
23
if(!island.hasPermission(e.getPlayer(), BEACON_BREAK)){
24
e.setCancelled(true);
25
e.getPlayer().sendMessage("" + ChatColor.RED + ChatColor.BOLD + "Error | " + ChatColor.GRAY + "This island is protected.");
26
}
27
}
28
29
}
Copied!
That's it! Now players must have the BEACON_BREAK permission in order to mine beacons. You can simply add the new permission to the permissions menu, and edit it's display icon there, the same as the regular permissions.
Last modified 1mo ago