# Rank permissions

# 1 Permissies

The permission system of KingdomCraft is pretty similar to most permission plugins. First you create a permission group and then you can connect this group to a kingdom rank. All players with this rank will have the permissions of the connected group. You can of course connect more than 1 group to a rank and use inheritance with the groups.

Edit groups in the **permissions.yml** file.

```yaml
# players without a kingdom will get this permission
default:
  permissions:
  - kingdom.join
  
# these groups can be linked to ranks
kingdom-lead:
  permissions:
  - kingdom.kick
  - kingdom.setspawn
  inheritances:
  - kingdom-moderator
  ranks:
  - king
  - queen

kingdom-moderator:
  permissions:
  - kingdom.setrank
  - kingdom.invite
  externals:
  - luckperms-kd-moderator
  ranks:
  - duke
```

## 1.1 inheritances

Enter the names of other groups to inherit their permissions. This handy feature makes sure you don’t have to define permissions twice.

## 1.2 ranks

Enter the name of all ranks that should be connected to this group automatically. You can still connect more groups to ranks using commands.

## 1.3 worlds

Enter the worlds in which the permissions of this group will apply. If you remove this option, the listed permissions will apply in all worlds.

## 1.4 externals

If you want players to automatically join a permission group of other plugins like GroupManager, LuckPerms, zPermissions… you can enter those group names here. This requires that you have [Vault](https://dev.bukkit.org/projects/vault) installed.

# 2 Commands

## 2.1 List of groups

Show a list of groups.

| /k groups | kingdom.groups |
|-----------|----------------|

## 2.2 List of groups for a rank

Show a list of groups that belogns to a rank.

| /k groups list <rank> | kingdom.groups.list |
|-----------------------|---------------------|
| /k groups list <kingdom> <rank> | kingdom.groups.list.other |

## 2.3 Connect a rank and a group

With this command you can connect a group with a rank.

| /k groups add <rank> <group> | kingdom.groups.add |
|------------------------------|--------------------|
| /k groups add <kingdom> <rank> <group> | kingdom.groups.add.other |

## 2.4 Disconnect a rank and and a group

With this command you can disconnect a group from a rank.

| /k groups remove <rank> <group> | kingdom.groups.remove |
|---------------------------------|-----------------------|
| /k groups remove <kingdom> <rank> <group> | kingdom.groups.remove.other |

---

**Documents**

- [Getting started](https://wiki.guflimc.com/s/kingdomcraft/doc/getting-started-D6nO7R93ys)
- [Configuration](https://wiki.guflimc.com/s/kingdomcraft/doc/configuration-DMcGaWt85O)
- [Kingdom setup](https://wiki.guflimc.com/s/kingdomcraft/doc/kingdom-setup-ZDcgXrOKXu)
- [Ranks setup](https://wiki.guflimc.com/s/kingdomcraft/doc/ranks-setup-8ZxHwOcwuN)
- [Players guide](https://wiki.guflimc.com/s/kingdomcraft/doc/players-guide-52cG3r3F9w)
- [Chat system](https://wiki.guflimc.com/s/kingdomcraft/doc/chat-system-BI5h4CO5nK)
- [Relations](https://wiki.guflimc.com/s/kingdomcraft/doc/relations-DWqWWHEum8)
- [Admin mode](https://wiki.guflimc.com/s/kingdomcraft/doc/admin-mode-XiPDZwgCU9)
- [Translations](https://wiki.guflimc.com/s/kingdomcraft/doc/translations-P1RH2hwYjp)
- [Rank permissions](https://wiki.guflimc.com/s/kingdomcraft/doc/rank-permissions-pJn6oSjLYI)
- [All permissions](https://wiki.guflimc.com/s/kingdomcraft/doc/all-permissions-abZLW9OAkb)
- [Database](https://wiki.guflimc.com/s/kingdomcraft/doc/database-XlNdVs86Jz)