Permissions

Permissions sind ein sehr wichtiges Thema, fast jedes Plugin oder Feature braucht sie. Damit Permissions einheitlich und übersichtlich zu verwalten sind, gelten folgende Regeln für die Vergabe von Permissions:

• Bitte sehe von der Verwendung der *-Rechte ab. *-Rechte sorgen für Permissions, die nur durch einen Spieler mit _ allen_ Rechten ausgeführt werden können und somit jegliche anderweitige Zuweisung untersagen.

• Grundsätzlich sollte jede Permission dem Schema wandoria.<namespace>.<permission> folgen. Der Namespace ist in diesem Fall der Name des Plugins, in dem diese Permission verwendet wird. Ein Beispiel wäre zum Beispiel wandoria.ban.kick, also eine Permission Spieler zu kicken in einem Plugin mit dem Namen ban.

  • Für Subkategorien gelten dementsprechend dieselben Regeln: wandoria.ban.kick.admins.

• Um die Übersichtlichkeit zu erhöhen, sollten Permissions als Konstanten in einer Klasse unter dem Package net.wandoria.<namespace>.Permissions vorliegen und im Code diese Konstanten verwendet werden. Dementsprechend sollte die Permission durch einen Kommentar dokumentiert werden, in dem die Verwendung angegeben ist. Ein Beispiel hierfür wäre:

  package net.wandoria.ban; public class Permissions { /** * The Permission required to kick a player */ public static String KICK = "wandoria.ban.kick"; /** * The permission required to kick an admin */ public static String KICK_ADMINS = "wandoria.ban.kick.admins"; }