LuckPerms: Gruppen und Berechtigungen für Minecraft Schritt für Schritt

LuckPerms ist ein Plugin zur Verwaltung von Berechtigungen. Es entscheidet, wer welchen Befehl und welche Funktion nutzen darf, und teilt Spieler in Gruppen wie VIP, Moderator oder Admin ein, samt Präfix im Chat. Wir erklären, wie Berechtigungen funktionieren, und bauen dann Schritt für Schritt eine vollständige Gruppenstruktur für einen typischen Server auf.

So funktionieren Berechtigungen#

Die Namen von Berechtigungen finden Sie in der Dokumentation des jeweiligen Plugins. Auf Paper haben die Berechtigungen für die eigenen Befehle von Minecraft die Form minecraft.command.<befehl>, zum Beispiel minecraft.command.kick oder minecraft.command.teleport (Befehl /tp). Kennen Sie eine Berechtigung nicht, findet LuckPerms sie für Sie, siehe Prüfung und Fehlersuche.

Installation und Datenspeicher#

1. Suchen Sie in der Registerkarte Plugins › Durchsuchen nach LuckPerms und klicken Sie auf Installieren (oder laden Sie die Datei von luckperms.net/download (öffnet sich in einem neuen Fenster) in den Ordner plugins hoch, siehe Plugins installieren).
2. Starten Sie den Server neu.
3. Prüfen Sie in der Konsole, ob LuckPerms gestartet ist (die Zeile [LuckPerms] Enabling LuckPerms … ohne Fehler). Beim ersten Start lädt das Plugin seine Bibliotheken herunter; der Start kann daher etwas länger dauern.

LuckPerms legt einen Ordner plugins/LuckPerms mit den Einstellungen in config.yml an. Wo es Daten speichert, bestimmt die Option storage-method:

Für einen einzelnen Server behalten Sie h2. Die Einrichtung von MySQL beschreibt der Artikel MySQL für Plugins. Ändern Sie den Speicher später, ziehen die Daten nicht von selbst um:

1. Exportieren Sie sie mit lp export prevod. Es entsteht die Datei plugins/LuckPerms/prevod.json.gz.
2. Stoppen Sie den Server und ändern Sie storage-method in plugins/LuckPerms/config.yml (bei MySQL auch die Zugangsdaten).
3. Starten Sie den Server und laden Sie die Daten mit lp import prevod.json.gz. Geben Sie den Dateinamen einschließlich der Endung .json.gz ein.

Statt prevod können Sie einen beliebigen Namen ohne Leerzeichen und Sonderzeichen verwenden.

Volle Rechte für Sie selbst#

Nach der Installation kann außer der Konsole und den Operatoren niemand LuckPerms-Befehle verwenden. Operatoren dürfen LuckPerms-Befehle standardmäßig verwenden (Option commands-allow-op: true in plugins/LuckPerms/config.yml).

1. Verbinden Sie sich mit dem Server, damit LuckPerms Ihr Konto kennt.

2. Geben Sie in der Registerkarte Konsole ein:

   lp user <NICK> permission set luckperms.* true

   • lp – die Kurzform des LuckPerms-Befehls (die lange Form ist luckperms).
   • user <NICK> – wir bearbeiten einen Spieler. Ersetzen Sie <NICK> durch Ihren Namen im Spiel, zum Beispiel Steve.
   • permission set – wir setzen eine Berechtigung.
   • luckperms.* – alle Berechtigungen von LuckPerms, also Zugriff auf alle seine Befehle.
   • true – Berechtigung gewähren (false würde sie ausdrücklich verbieten).

Im Spiel verwenden Sie die Befehle dann mit Schrägstrich (/lp …), in der Konsole ohne.

Gruppen und Vererbung anlegen#

Wir bauen eine Struktur, die für die meisten Server passt:

default
├── vip
└── helper
    └── moderator
        └── admin
            └── owner

Jede Gruppe erbt alles von der Gruppe über ihr. Ein Admin kann also alles, was ein Moderator kann, ein Moderator alles, was ein Helper kann, und alle alles, was default kann. VIP ist ein eigener Zweig, damit VIPs keine Teamrechte bekommen.

1. Legen Sie die Gruppen samt Gewicht an. Geben Sie die Befehle nacheinander in die Konsole ein:

   lp creategroup vip 100
   lp creategroup helper 200
   lp creategroup moderator 300
   lp creategroup admin 400
   lp creategroup owner 500

   • creategroup <gruppe> – legt eine leere Gruppe an. Schreiben Sie Namen klein, ohne Sonderzeichen und Leerzeichen.
   • Die Zahl nach dem Namen ist das Gewicht. Ein höheres Gewicht hat Vorrang. Abstände von hundert lassen Platz für später ergänzte Gruppen (zum Beispiel vip-plus mit Gewicht 150).

2. Richten Sie die Vererbung ein:

   lp group vip parent add default
   lp group helper parent add default
   lp group moderator parent add helper
   lp group admin parent add moderator
   lp group owner parent add admin

   • group <gruppe> – wir bearbeiten eine Gruppe.
   • parent add <parent> – die Gruppe erbt ab jetzt die Berechtigungen der übergeordneten Gruppe. Die Vererbung verkettet sich, owner bekommt also die Berechtigungen aller Gruppen unter ihr.

3. Geben Sie den Gruppen Namen, die Spieler sehen (optional):

   lp group moderator setdisplayname Moderator

   Der angezeigte Name darf Sonderzeichen enthalten. So können Sie auch die Gruppe default als „Spieler“ anzeigen, ohne ihren tatsächlichen Namen zu ändern.

Berechtigungen für Gruppen#

Eine Berechtigung fügen Sie mit lp group <gruppe> permission set <berechtigung> [true|false] [kontext…] hinzu. Lassen Sie den Wert weg, wird true verwendet.

1. Die Grundausstattung für alle Spieler (Gruppe default), ein Beispiel für EssentialsX:

   lp group default permission set essentials.home
   lp group default permission set essentials.sethome
   lp group default permission set essentials.delhome
   lp group default permission set essentials.spawn
   lp group default permission set essentials.tpa
   lp group default permission set essentials.tpaccept
   lp group default permission set essentials.tpdeny
   lp group default permission set essentials.back
   lp group default permission set essentials.msg
   lp group default permission set essentials.warp
   lp group default permission set essentials.warp.list

   Damit bekommen Spieler Homes (/home, /sethome, /delhome), die Rückkehr zum Spawn, Teleportanfragen (/tpa, /tpaccept, /tpdeny), die Rückkehr zur letzten Position (/back), private Nachrichten und Warps.

2. VIPs mit mehr Homes und einer Werkbank überall:

   lp group vip permission set essentials.sethome.multiple
   lp group vip permission set essentials.sethome.multiple.vip
   lp group vip permission set essentials.workbench
   lp group vip permission set essentials.hat

   Die Anzahl der Homes für „vip“ legen Sie in plugins/Essentials/config.yml im Abschnitt sethome-multiple fest (standardmäßig 5), siehe Empfohlene Plugins.

3. Das Team (Helper, Moderator, Admin):

   lp group helper permission set essentials.mute
   lp group helper permission set essentials.kick
   lp group helper permission set coreprotect.inspect
   lp group helper permission set coreprotect.lookup
   lp group moderator permission set essentials.tempban
   lp group moderator permission set essentials.vanish
   lp group moderator permission set essentials.invsee
   lp group moderator permission set essentials.tp
   lp group moderator permission set coreprotect.rollback
   lp group moderator permission set coreprotect.restore
   lp group admin permission set essentials.ban
   lp group admin permission set essentials.unban
   lp group admin permission set essentials.gamemode
   lp group admin permission set essentials.fly
   lp group admin permission set worldedit.*
   lp group admin permission set worldguard.region.*
   lp group owner permission set luckperms.*
   lp group owner permission set essentials.*

   Die Berechtigungen von CoreProtect, WorldEdit und WorldGuard erklärt der Artikel Empfohlene Plugins. Der Platzhalter worldedit.* gewährt alle Berechtigungen von WorldEdit.

Verbote und Ausnahmen#

Der Wert false verbietet eine Berechtigung ausdrücklich, auch wenn die Gruppe sie erbt. Beispiel: Auf Paper können Spieler standardmäßig mit /plugins die Plugins auflisten. Möchten Sie das verbergen:

lp group default permission set bukkit.command.plugins false

Der Befehl lp group <gruppe> permission unset <berechtigung> entfernt die Einstellung dagegen vollständig (die Berechtigung ist wieder „nicht gesetzt“).

Berechtigungen nur an bestimmten Orten: Kontexte#

Ans Ende des Befehls können Sie einen Kontext anhängen. Die Berechtigung gilt dann nur unter dieser Bedingung:

lp group vip permission set essentials.fly true world=world
lp group default permission set essentials.home false world=pvp_arena

• world=world – VIPs können nur in der Welt mit dem Ordner world fliegen (nicht im Nether, world_nether).
• world=pvp_arena – in der Arena funktioniert /home nicht.

Weitere Kontexte sind gamemode=creative oder für Servernetzwerke server=<SERVER_NAME> (den Namen des Servers legt die Option server in plugins/LuckPerms/config.yml fest).

Zeitlich begrenzte Berechtigungen#

lp user <NICK> permission settemp essentials.fly true 1d

settemp fügt eine Berechtigung für eine begrenzte Zeit hinzu. Die Dauer schreiben Sie als 30m (Minuten), 12h (Stunden), 7d (Tage), 1mo (Monat) oder kombiniert, zum Beispiel 1mo3d12h.

Präfixe im Chat#

Ein Präfix ist der Text vor dem Namen eines Spielers im Chat, zum Beispiel [Admin] Steve: hallo. LuckPerms speichert ihn nur. Angezeigt wird er von einem Plugin, das den Chat formatiert (zum Beispiel EssentialsX Chat) und ihn über das Plugin Vault liest. Ohne beide erscheint der Präfix nicht im Chat.

1. Legen Sie Präfixe für die Gruppen fest:

   lp group vip meta setprefix 100 "&6[VIP] "
   lp group helper meta setprefix 200 "&a[Helper] "
   lp group moderator meta setprefix 300 "&9[Moderator] "
   lp group admin meta setprefix 400 "&c[Admin] "
   lp group owner meta setprefix 500 "&4[Owner] "

   • meta setprefix – setzt einen Präfix und ersetzt den bisherigen Präfix der Gruppe.
   • Die Zahl (100 bis 500) ist die Priorität des Präfixes. Gehört ein Spieler zu mehreren Gruppen, wird der Präfix mit der höchsten Priorität angezeigt. Ein Moderator, der auch VIP ist, bekommt also den Präfix [Moderator].
   • Der Text in Anführungszeichen ist der Präfix. Die Anführungszeichen sind wegen des Leerzeichens am Ende nötig, das den Präfix vom Namen trennt.
   • &6, &a … sind Farbcodes (Tabelle unten).

2. Prüfen Sie, ob Ihr Chat-Plugin den Präfix liest: Geben Sie in der Konsole vault-info ein. In der Ausgabe muss LuckPerms als Quelle für Berechtigungen und Chat stehen.

Formatierungscodes (&l, &o, &n) setzen Sie hinter den Farbcode, zum Beispiel &c&l[Admin].

Einen Spieler einer Gruppe hinzufügen#

Der Spieler sollte sich mindestens einmal mit dem Server verbunden haben, damit LuckPerms sein Konto kennt.

lp user <NICK> parent add vip

• parent add <gruppe> – fügt dem Spieler eine Gruppe hinzu. Seine anderen Gruppen bleiben. Praktisch, um einem Teammitglied VIP zu geben.

lp user <NICK> parent set moderator

• parent set <gruppe> – gibt dem Spieler nur diese Gruppe und entfernt die anderen. Praktisch, um jemandes Rang zu ändern.

lp user <NICK> parent remove vip

• parent remove <gruppe> – entfernt die Gruppe. Hat der Spieler keine andere Gruppe, kehrt er zu default zurück.

lp user <NICK> parent addtemp vip 30d

• parent addtemp <gruppe> <dauer> – eine Gruppe für eine begrenzte Zeit (hier 30 Tage), zum Beispiel ein Monat VIP. Nach Ablauf entfernt LuckPerms sie automatisch.

Der Webeditor#

Statt mit Befehlen können Sie alles im Browser bearbeiten.

1. Geben Sie in der Konsole lp editor ein.

2. LuckPerms gibt einen Link aus. Öffnen Sie ihn im Browser.

3. Wählen Sie links eine Gruppe oder einen Spieler. Berechtigungen fügen Sie im Feld Add Permission hinzu (der Editor schlägt bekannte Berechtigungen vor), Werte ändern Sie per Klick in der Tabelle. Einen Kontext ergänzen Sie mit der Schaltfläche Add Contexts.

4. Klicken Sie auf Save (oder Strg+S).

5. Der Editor zeigt einen Befehl in der Form /lp applyedits <CODE>. Klicken Sie darauf, um ihn zu kopieren.

6. Fügen Sie ihn ohne den Schrägstrich am Anfang in die Konsole ein und drücken Sie Enter.

   Die Konsole gibt eine Zusammenfassung der Änderungen aus. Erst jetzt sind sie gespeichert.

Im Editor werden Gewicht, Präfix und Parent als spezielle Berechtigungen geschrieben: weight.400, prefix.400.&c[Admin] und group.moderator.

Beförderung auf einer Leiter (Tracks)#

Ein Track ist eine Leiter von Gruppen, auf der Sie Spieler mit einem einzigen Befehl bewegen. Auf die Vererbung hat er keinen Einfluss.

1. Legen Sie einen Track an und fügen Sie die Gruppen in der richtigen Reihenfolge hinzu:

   lp createtrack tym
   lp track tym append helper
   lp track tym append moderator
   lp track tym append admin

2. Befördern und degradieren:

   lp user <NICK> promote tym
   lp user <NICK> demote tym

   • promote – verschiebt den Spieler eine Stufe nach oben und entfernt seine vorherige Gruppe auf dem Track. Ist er noch nicht auf dem Track, bekommt er die erste Gruppe (helper).
   • demote – verschiebt den Spieler eine Stufe nach unten.

Prüfung und Fehlersuche#

Wenn Sie nicht wissen, welche Berechtigung ein Befehl braucht, verwenden Sie verbose:

1. Geben Sie in der Konsole lp verbose record <NICK> ein.
2. Lassen Sie den Spieler im Spiel den Befehl ausführen, der nicht funktioniert.
3. Geben Sie lp verbose upload ein. LuckPerms gibt einen Link zu einer Übersicht aller Berechtigungsprüfungen aus. Suchen Sie die Zeilen mit dem Ergebnis false.

Empfohlene Struktur für einen gewöhnlichen Server#

Grundsätze: Geben Sie nur die Berechtigungen, die eine Gruppe wirklich braucht. Fügen Sie neue Berechtigungen der niedrigsten Gruppe hinzu, die sie haben soll; die höheren Gruppen erben sie. Ausnahmen lösen Sie mit dem Wert false oder einem Kontext, nicht durch Kopieren von Berechtigungen in mehrere Gruppen.

LuckPerms auf Fabric, Forge und NeoForge#

LuckPerms gibt es auch als Mod. Die Befehle sind dieselben, die Datei gehört in den Ordner mods, und die Einstellungen liegen im Ordner config im Unterordner LuckPerms. Ein Unterschied: Fabric prüft keine Berechtigungen für die eigenen Befehle von Minecraft; Berechtigungen wie minecraft.command.gamemode funktionieren auf Fabric daher nicht ohne einen weiteren Mod. Befehle von Mods, die LuckPerms unterstützen, funktionieren normal.

Schnelle Rezepte#

Ersetzen Sie <NICK> durch den Namen des Spielers im Spiel. Im Spiel geben Sie die Befehle mit Schrägstrich ein (/lp …).

LuckPerms in einem Servernetzwerk (Velocity)#

Betreiben Sie mehrere Server, die über einen Velocity-Proxy verbunden sind, möchten Sie meist überall dieselben Gruppen. Das Vorgehen in Kürze:

1. Installieren Sie LuckPerms auf jedem Server und auf dem Proxy (die Velocity-Version). Auf dem Proxy geben Sie die Befehle als lpv statt lp ein.
2. Legen Sie eine MariaDB- oder MySQL-Datenbank an, mit der sich alle Instanzen verbinden, siehe MySQL für Plugins.
3. Bearbeiten Sie auf jeder Instanz plugins/LuckPerms/config.yml (bei gestopptem Server):

4. Starten Sie alle Server und den Proxy neu. Eine Änderung auf einem Server zeigt sich dann auch auf den anderen.

Die Einrichtung des Netzwerks selbst beschreibt der Artikel Ein Servernetzwerk mit Velocity.

Überprüfung#

1. Geben Sie für einen Testspieler lp user <NICK> info ein. Die Ausgabe zeigt seine Gruppen und seinen Präfix.
2. Verbinden Sie sich als gewöhnlicher Spieler (ohne Operator-Status, deop <NICK>) und probieren Sie Befehle aus, die die Gruppe nutzen darf, und solche, die sie nicht darf.
3. Schreiben Sie eine Nachricht in den Chat und prüfen Sie den Präfix.

Fehlerbehebung#

Nach Eingabe von /lp erscheint nur die Version des Plugins#

Sie haben für keinen LuckPerms-Befehl eine Berechtigung. Geben Sie sie sich aus der Konsole mit lp user <NICK> permission set luckperms.* true.

Berechtigungen funktionieren nicht, obwohl der Spieler in der Gruppe ist#

• Auf dem Server ist ein weiteres Berechtigungs-Plugin (PermissionsEx, GroupManager und Ähnliche). LuckPerms muss das einzige sein; entfernen Sie die anderen.
• Sie testen als Operator. Operatoren bekommen Plugin-Berechtigungen automatisch, was das Ergebnis verfälscht. Testen Sie ohne OP.
• Ein Tippfehler im Namen der Berechtigung. Prüfen Sie ihn mit lp verbose (oben).
• Die Berechtigung ist irgendwo auf false gesetzt. lp user <NICK> permission check <berechtigung> zeigt, woher der Wert kommt.

Der Präfix wird im Chat nicht angezeigt#

Es fehlt Vault oder ein Plugin für das Chatformat. Installieren Sie Vault (oder VaultUnlocked) und EssentialsX Chat und starten Sie den Server neu. In EssentialsX Chat muss das Chatformat {DISPLAYNAME} oder {PREFIX} enthalten. Sieht ein Spieler einen anderen Präfix als erwartet, vergleichen Sie die Prioritäten in lp user <NICK> meta info.

Änderungen aus dem Webeditor wirken nicht#

Sie haben den nach dem Speichern erzeugten Befehl lp applyedits <CODE> nicht ausgeführt. Speichern Sie erneut und führen Sie den Befehl aus.

lp user findet den Spieler nicht#

Der Spieler war noch nicht auf dem Server, daher kennt LuckPerms sein Konto nicht. Lassen Sie ihn sich verbinden oder verwenden Sie statt des Namens seine UUID.

Ein Spieler in einer Gruppe hat nach dem Hinzufügen mit parent set weder Präfix noch Berechtigungen#

Prüfen Sie den Namen der Gruppe (lp listgroups). parent set mit einer nicht existierenden Gruppe endet mit einem Fehler und fügt dem Spieler nichts hinzu.

Weiterführende Links#

• LuckPerms-Wiki: erste Schritte (öffnet sich in einem neuen Fenster)
• LuckPerms-Wiki: Befehlsübersicht (öffnet sich in einem neuen Fenster)
• LuckPerms-Wiki: Präfixe und Meta (öffnet sich in einem neuen Fenster)
• Paper: Berechtigungen für Befehle (öffnet sich in einem neuen Fenster)