AEONHOST / WISSEN

LuckPerms-Berechtigungen mit Welt- und Serverkontexten

Mit LuckPerms kannst du eine Berechtigung auf einen Server, eine Welt oder eine Kombination aus beidem begrenzen. Ein Eintrag ohne passenden Kontext ist global. Bei einer Kombination wie server=survival world=world_nether muss der Spieler beide Bedingungen erfüllen. Prüfe vor dem Setzen die tatsächlichen Server- und Weltnamen und teste danach mit einem normalen, nicht als Operator geführten Konto.

Aktualisiert am 07.10.2026

Mit LuckPerms kannst du eine Berechtigung auf einen Server, eine Welt oder eine Kombination aus beidem begrenzen. Ein Eintrag ohne passenden Kontext ist global. Bei einer Kombination wie server=survival world=world_nether muss der Spieler beide Bedingungen erfüllen. Prüfe vor dem Setzen die tatsächlichen Server- und Weltnamen und teste danach mit einem normalen, nicht als Operator geführten Konto.

Voraussetzung und Begriffe

LuckPerms muss bereits auf einer dazu passenden Minecraft-Serverplattform installiert und aktiv sein. Für diese Anleitung brauchst du ausserdem Zugriff auf die Serverkonsole oder ein Konto, das die jeweilige LuckPerms-Verwaltungsberechtigung besitzt. In der Panel- oder Serverkonsole schreibst du Befehle ohne führenden Schrägstrich. Im Spielchat steht / davor; dort muss dein Konto den LuckPerms-Befehl ausführen dürfen. Verwechsle eine Plugin-Berechtigung nicht mit einem Operator-Status: Die Operator-Rechte sind ein anderes, weiter reichendes System.

Eine Kontextangabe besteht aus Schlüssel und Wert: world=... oder server=.... LuckPerms dokumentiert diese Form für einzelne Berechtigungen und Gruppen. Ohne Kontext speichert der Set-Befehl einen globalen Eintrag (LuckPerms: Context, Permission Commands).

Eine Berechtigung gezielt begrenzen

Lies zuerst in der offiziellen Dokumentation des Plugins nach, welcher Knoten genau die gewünschte Funktion steuert. <plugin.permission.node> ist im folgenden Beispiel nur ein Platzhalter. Verwende weder einen geratenen Namen noch eine breite Wildcard wie *:

lp group <gruppe> permission set <plugin.permission.node> true server=survival world=world_nether

Ersetze <gruppe> durch eine bereits eingerichtete LuckPerms-Gruppe und den Permission-Platzhalter durch den echten Knoten. survival und world_nether sind ebenfalls Beispiele: Entscheidend sind die Werte, die deine LuckPerms-Instanz tatsächlich für Server und Welt meldet. Für ein Konto statt einer Gruppe lautet der dokumentierte Befehl entsprechend lp user <Spielername> permission set <plugin.permission.node> true server=survival world=world_nether. Im Chat setzt du vor den jeweiligen Befehl einen Schrägstrich; in der Konsole lässt du ihn weg. Für das Ändern einer Gruppe oder eines Nutzers braucht dein Konto die passende LuckPerms-Berechtigung (LuckPerms: Permission Commands).

Bei nur einem Schlüssel beschränkt server=survival den Eintrag auf diesen Server; world=world_nether beschränkt ihn auf diese Welt. Mit beiden Schlüsseln zusammen muss der Spieler Server und Welt gleichzeitig erfüllen. Der Wert für server stammt aus der Einstellung server in der LuckPerms-Konfiguration. Benenne deshalb die Instanzen konsistent: Wenn zwei Instanzen denselben Servernamen verwenden, teilen sie auch diesen Kontext. Bei LuckPerms auf einem BungeeCord- oder Velocity-Proxy bezeichnet der dokumentierte world-Kontext den verbundenen Unterserver; prüfe daher, auf welcher Instanz die Berechtigung verwaltet wird (LuckPerms: Context, Configuration).

Globale Rechte und Vererbung auseinanderhalten

Ein Eintrag ohne Server- oder Weltkontext ist global. Eine kontextgebundene Berechtigung ersetzt nicht automatisch alle globalen Einträge: Die Optionen include-global und include-global-world steuern, ob globale Berechtigungen in die Auswertung einfliessen. Die verwandten Optionen apply-global-groups und apply-global-world-groups betreffen die Gruppenvererbung. Ändere diese Schalter nicht als schnellen Reparaturversuch; sie können die Rechteauswertung auf einer ganzen Instanz verändern. Prüfe zuerst die bestehende Konfiguration und den betroffenen Gruppenpfad (LuckPerms: Configuration).

Nutzer können Berechtigungen von ihren Gruppen erben, und Gruppen können weitere Gruppen als Eltern haben. Diese Vererbung läuft rekursiv. Eine direkte Berechtigung des Nutzers kann einen geerbten Eintrag übersteuern; auch eine speziellere Server- oder Weltberechtigung kann Vorrang vor einem allgemeinen Eintrag haben. Schau deshalb nicht nur auf den sichtbaren Rang. /lp user <Spielername> info zeigt unter anderem Eltern und aktuelle Kontexte. /lp user <Spielername> permission check <plugin.permission.node> prüft den effektiven Knoten und nennt Faktoren, die das Ergebnis beeinflusst haben (LuckPerms: Usage, Context, Permission Commands).

Wirkung mit einem normalen Konto prüfen

  1. Notiere den tatsächlichen Servernamen, die Zielwelt und den exakten Permission-Knoten aus der Plugin-Dokumentation. Prüfe in LuckPerms, dass das Testkonto gerade auf dieser Instanz online ist und seine aktuellen Kontexte angezeigt werden.

  2. Setze nur den benötigten Knoten mit dem passenden Kontext. Verwende ein bestehendes Gruppenkonzept, wenn die Rechte für mehrere Personen gelten; lege nicht nebenbei eine neue Adminrolle an.

  3. Teste die Funktion mit einem nicht als OP geführten Testkonto, das nur die vorgesehenen Gruppen besitzt. Prüfe die Funktion zuerst auf dem Zielserver und in der Zielwelt. Wiederhole den Test anschliessend in einer Welt oder auf einem Server ausserhalb des Kontexts.

  4. Kontrolliere bei Bedarf mit permission check, welche direkten, geerbten oder kontextgebundenen Einträge zur Entscheidung beitragen. Ein erfolgreicher Test als Operator reicht nicht aus, weil Operator-Rechte die Prüfung verfälschen können.

  5. Entferne die Änderung mit demselben Knoten und denselben Kontextwerten, falls sie nicht wie beabsichtigt wirkt:

    lp group <gruppe> permission unset <plugin.permission.node> server=survival world=world_nether
    

Das unset entfernt nur den passenden Eintrag in diesem Kontext. Bleibt die Funktion danach verfügbar, suche nach einer weiteren globalen oder geerbten Zuweisung, statt pauschal andere Gruppen zu löschen.

Wenn die Berechtigung nicht passt

  • Sie gilt in der Zielwelt nicht: Vergleiche die Werte mit den aktuellen Kontexten des online Testkontos. Ein Tippfehler im Servernamen oder eine andere Weltbezeichnung genügt, damit die Bedingung nicht zutrifft.
  • Sie gilt auch ausserhalb des Ziels: Suche nach einer globalen Zuweisung oder einem anderen Elternrang. Prüfe zudem die include-global- und Gruppenoptionen, ohne sie ungeprüft umzuschalten.
  • Die Aktion bleibt gesperrt: Bestätige den Permission-Knoten in der Plugin-Dokumentation. Prüfe dann den effektiven Ergebnisbericht mit permission check. Für den nächsten Diagnoseschritt kannst du mit LuckPerms verbose eine fehlende Berechtigung untersuchen.

LuckPerms ist ein optionales Plugin; die Befehle setzen eine kompatible und bereits aktive Installation voraus. Für allgemeine Plattform- und Pluginvoraussetzungen hilft Minecraft-Server-Plugins installieren. Die Anleitung verspricht keine automatische LuckPerms-Installation bei AeonHost.

Quellen