Skip to content

Permissions

Crypto Morin edited this page Feb 11, 2022 · 53 revisions

Plugin basic permissions needed for players are all given by default.
All the command permissions use the following format: kingdoms.command.[groups...].<name>
Where <name> is the main command name (not their aliases) and [groups...] are the group's main command names.

Examples:

Command Permission
/k fly kingdoms.command.fly
/k show kingdoms.command.show
/k info kingdoms.command.show
/k nation spawn kingdoms.command.nation.spawn
/k admin disband kingdoms.command.admin.disband
/k admin unclaim kingdoms.command.admin.unclaim
/k admin nation disband kingdoms.command.admin.nation.disband

Note that some names are not command groups, they're command arguments.
For example in /k visualize permanent command, the permanent is a command argument, however you can still use a permission for it, which is kingdoms.command.visualize.permanent but that is not the same for all the other arguments of other commands.

If your permission plugin supports wildcards * you can use that as well. For example kingdoms.command.admin.*
An ideal permission plugin suitable for any server is LuckPerms.

Removing Default Permissions

To take away the default permissions given to players, you have to give them a negative permission. Different permission plugins have different ways of doing this. It's always recommended to use the plugin's commands to do these.
For example, to take kingdoms.command.home permission using LuckPerms, you need to do /lp group <group> permission set kingdoms.command.home false (which in LuckPerms context, the group is default in most cases) Please only use this if you want to disable the command for a certain group. If you want to completely remove a command go to commands.ymlconfig.

Admin Mode

The plugin has an easy way to access everything in the plugin with just a single command. You'll be able to bypass all the limitations and requirements such as the resource points or money needed for something, or the blacklisted/whitelisted names. This mode will even bypass some limitations that even opped players can't.
/k admin toggle will toggle admin mode and you'll be able to access all the kingdom permissions.
This mode will not stay after logins. You can change this in config.yml -> keep-admin-mode
Note: Remember to always make sure that your admin mode is turned off before reporting bugs as it removes almost 99% of the restrictions which some are extremely game breaking.



Other Permissions

Permission Description
kingdoms.commands.bypass.cooldown.<command> Bypass cooldown of a specific command.
kingdoms.commands.bypass.disabled-worlds.<command> Bypass disabled worlds for a certain command.
kingdoms.land.build.place Place blocks in other kingdom's lands.
kingdoms.land.build.break Break blocks in other kingdom's lands.
kingdoms.land.interact Interact and use blocks in other kingdom's lands.
kingdoms.(structures | turrets).build.place Place structures/turrets in any (claimed) land.
kingdoms.(structures | turrets).build.break Break structures/turrets in any land.
kingdoms.(structures | turrets).interact Interact with structures/turrets in any land.
kingdoms.structures.warppad.bypass.countdown Warp Pad teleport countdown bypass.
kingdoms.inventory.bypass Prevents players from using kingdom items as vanilla items (e.g. fuel in furnace)
kingdoms.command.claim.chunk Claim using /k claim command. Note this is required for claiming from /k map
kingdoms.command.show.others View another kingdom's info for /k show
kingdoms.command.show.admin View the full info of another kingdom using /k show
kingdoms.command.nation.show.others View another nation's info.
kingdoms.command.nation.show.admin View the full info of another nation.
kingdoms.command.teleport.bypass.timer Bypass the /k tp teleportation timer for not moving.
kingdoms.command.home.bypass.timer Bypass the /k home teleportation timer for not moving.
kingdoms.command.nation.home.bypass.timer Bypass the /k nation spawn teleportation timer for not moving.
kingdoms.command.admin.execute.console Permission for executing /k admin execute console ... This is disabled by default even for OPs as a security measure.
kingdoms.nexus.remove Permission to remove nexus structure even if
kingdoms.protection-signs.use Permission to use protection signs. Enabled by default.
kingdoms.protection-signs.use.creative Permission to use protection signs in creative mode. Enabled by default.
kingdoms.protection-signs.open Open any protected blocks.
kingdoms.protection-signs.break Break any protected blocks or signs.
kingdoms.command.visualize.details /k visualize Shows almost every detail of the current land.
kingdoms.debug Permission to view debug messages. Debug messages are quite rare in the plugin.
kingdoms.updates Sends a message to the player if the update checker is enabled and the plugin is outdated.
kingdoms.creative.pickup Pickup structures and turrets in creative mode.
kingdoms.silent.leave Leave the server without the leave message.
kingdoms.silent.join Join the server without the join message.
kingdoms.flight.damage Player flight will not be disabled after taking damage.
kingdoms.flight.lands Player flight will not be disabled while entering lands other than the player's kingdom.
kingdoms.flight.nearby-enemies Player flight will not be disabled if an enemy is nearby.
kingdoms.chat.colors Use color codes in the chat.
kingdoms.chat.tag Permission to tag players in chat.
kingdoms.chat.bypass.ranged Allow players to use the prefix defined in the config to bypass the ranged channel and send the message to everyone.
kingdoms.inactivity.disband Prevents the kingdom that the player is in being disbanded due to inactivity.
kingdoms.markers.default Allow players to use /k visualize markers to set their markers type to default.
kingdoms.markers.blocks Allow players to use /k visualize markers to set their markers type to block visualizers.
kingdoms.markers.<particle> Allow players to use /k visualize markers to set their markers type to one of the particle types (by default horizontal and vertical) Note if you added or removed a particle marker type, these permission names may be outdated when auto-completing them in a permission plugin. You need to restart the server to fix this.
kingdoms.command.vault.others Permission for /k vault
kingdoms.command.pvp.others Permission for /k pvp
kingdoms.command.seak.others Permission for /k seak