Permissions - CryptoMorin/KingdomsX GitHub Wiki
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.
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 |
Notice how the permission for /k info
and /k show
are the same, since the former is an alias of the latter command. It wouldn't accept kingdoms.command.info
even if you changed its name in commands.yml
Note that some names are not command groups, they're command arguments.
For example in /k invade ransack command, the ransack
is an optional command argument, however you can still use a permission for it, which is kingdoms.command.invade.ransack, but that is not the same for all the other arguments of other commands.
To make this easier, the plugin has an admin command named /k admin command that lets you get and copy permission of a specific command using its main name or alias.
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.
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.yml
config.
If you don't have permissions by default, it's possible that:
- You negated
*
orkingdoms.*
permission from the default group. - You turned off Bukkit default permissions for LuckPerms.
- Your permission plugin doesn't support default groups.
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.
Permission | Description |
---|---|
kingdoms.command.<command>.bypass.cooldown |
Bypass cooldown of a specific command. |
kingdoms.command.<command>.bypass.disabled-worlds |
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.bypass.creative |
Allow players to walk in lands that are owned by kingdoms without CEASEFIRE relationship attribute. |
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.sneak.others |
Permission for /k sneak |
kingdoms.see.others.holograms |
When holograms are enabled to be seen only by friendly players, this feature allows admins to bypass this. |