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.

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

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.

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.

If you don't have permissions by default, it's possible that:

  • You negated * or kingdoms.* permission from the default group.
  • You turned off Bukkit default permissions for LuckPerms.
  • Your permission plugin doesn't support default groups.

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.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.
⚠️ **GitHub.com Fallback** ⚠️