Skip to content

Permissions

Crypto Morin edited this page Oct 29, 2020 · 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 config.yml -> command -> disabled

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.
/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.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.nexus.remove Permission to remove nexus structure even if
kingdoms.protection-signs.open Open any protected blocks.
kingdoms.protection-signs.break Break any protected blocks or signs.
kingdoms.debug Permission to view debug messages. Debug messages are quite rare in the plugin.
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.lands.<amount> Players with this permission will give <amount> extra lands if they join a kingdom.
kingdoms.chat.colors Use color codes in the chat.