Island Privileges
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.
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 Shear
Gives access to shear 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
Horse Interact
Gives access to interact with horses inside the island
Ignite Creeper
Gives access to ignite creppers (using a flint and steal) inside 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
Name Entity
Gives access to nametag entities 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 Axolotl
Gives access to pick up axolotls using a water bucket inside the island
Pickup Drops
Gives access to pick up drops inside the island
Pickup Fish
Gives access to pick up fish using a water bucket 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
Turtle Egg Tramping
Gives access to break turtle eggs when standing on them 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
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.
public final class BeaconPlacePermission implements Listener {
private static IslandPrivilege BEACON_BREAK;
@EventHandler
public void onPluginInit(PluginInitializeEvent e){
IslandPrivilege.register("BEACON_BREAK");
BEACON_BREAK = IslandPrivilege.getByName("BEACON_BREAK");
}
}
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!
public final class BeaconPlacePermission implements Listener {
private static IslandPrivilege BEACON_BREAK;
@EventHandler
public void onPluginInit(PluginInitializeEvent e){
IslandPrivilege.register("BEACON_BREAK");
BEACON_BREAK = IslandPrivilege.getByName("BEACON_BREAK");
}
@EventHandler
public void onBlockBreak(BlockBreakEvent e){
//Checking for beacons only.
if(e.getBlock().getType() != Material.BEACON)
return;
Island island = SuperiorSkyblockAPI.getIslandAt(e.getBlock().getLocation());
// Making sure the block was broken inside an island.
if(island == null)
return;
if(!island.hasPermission(e.getPlayer(), BEACON_BREAK)){
e.setCancelled(true);
e.getPlayer().sendMessage("" + ChatColor.RED + ChatColor.BOLD + "Error | " + ChatColor.GRAY + "This island is protected.");
}
}
}
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 2mo ago