Permissions
Basic plugin permissions needed for players are all given by default.
All command permissions use the format: kingdoms.command.[groups...].<name>, where <name> is the main command name (not its aliases) and [groups...] are the main command names of the command groups.
Examples
Format: kingdoms.command.[groups...].<name>
/k fly = kingdoms.command.fly
└┬┘ └┬┘
└────(command name)────┘
/k nation spawn = kingdoms.command.nation.spawn
└─┬──┘ └─┬─┘ └──┬─┘ └─┬─┘
└──────│─────(command group)─────┘ │
└────────(command name)─────────┘
/k admin nation disband = kingdoms.command.admin.nation.disband
└─┬─┘ └─┬──┘ └──┬──┘ └─┬─┘ └──┬─┘ └──┬──┘
└─────│───────│─────(command group)─────┘ │ │
└───────│────────(command group)─────────┘ │
└────────────(command name)─────────────┘
Notice how the permission for /k info and /k show in the table above is the same. This is because /k info is just an alias for the command /k show. Even if you renamed it in config.yml, it still wouldn't accept kingdoms.command.info as a valid permission.
Keep in mind that some of the words in a command are not "command groups", but rather arguments.
For example in /k invade ransack command, the word ransack is an optional command argument. It still has its own permission, which is kingdoms.command.invade.ransack, but this is not always the case for all other arguments of other commands. It depends on the command.
To make things easier, the plugin has an admin command called /k admin command that quickly lets you get and copy the permission of a specific command, just by specifying 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. This is also called negating a 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 negate the 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 from the plugin, go to the config.yml → commands section. See this FAQ for a more in-depth tutorial.
If you don't have permissions to use basic Kingdoms commands 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.
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 KingdomsX's permissions.
As a security measure, this mode will automatically get disabled when you disconnect from the server. You can change this behavior in config.yml → keep-admin-mode.
Remember to always make sure that your admin mode is turned off before reporting bugs as it removes nearly 99% of the restriction. Some of these restrictions are extremely game breaking and can cause unexpected behavior, which may seem as a "bug".
)