Skip to content

Definitions

This page describes the key definitions and the structure of DKPerms. It is very important that you understand these things before you start using DKPerms.

Permissions

Every plugin installed on your server usually brings its own permissions, these permissions are required to restrict commands and features to different users and groups. These permissions allow you to control which user has access to a command or feature.

The permission node is a sequence of letters and is provided by the respective plugin author. For example, to ban (/ban dkrieger hacking) a user with DKBans the permission dkbans.ban is required.

Meta

The meta is a key value based information that can be set to groups and users. Unlike permissions, the meta contains a value that can be read by another plugin.

For example, you might want to display a prefix before the player name in the tab list, so you can set a meta entry with the key prefix and your value.

Groups (Permission groups)

Usually different players have the same permission. In this case DKPerms has groups, which you can give permissions, metas and other groups, later on you can assign this group to different players.

For example, you can create a moderator group, which contains permissions for banning, kicking and teleport. When now a new moderator joins your team, you can easily assign the moderator group to him/her, and he/she will automatically get necessary permissions.

Server Groups

A server group is a collection of different servers, every server is automatically in a server group the name of the group is the first part of the group separator (-) defined in the configuration

For example, you have a different SkyWars servers called: * SkyWars-1 * SkyWars-2 * SkyWars-3

The server group for these servers is called SkyWars, if you now need the same permissions on all skywars servers, it is much easier to assign the permission to the server group instead to each server.

Scope

DKPerms is based on a tree structure, everything in DKPerms (Objects, permissions, groups etc.) belongs to a scope and is only valid for this and all subordinate scopes.

This example shows how a tree can look like:

  • Namespace=Minecraft
    • ServerGroup=Lobby
      • Server=Lobby-1
        • World=World-1
      • Server=Lobby-2

If the permission dkbans.ban is assigned to a player on the scope Namespace=Minecraft\\ServerGroup=Lobby the permission is valid on Lobby-1 and Lobby-2.

Permission Object

A PermissionObject holds permission data and can be a group, user or a custom type. Objects are registered in DKPerms and assigned to a third-party resource.


Last update: 2021-03-01