Ränge

Präfix, Suffix und Permissions für Spieler im ganzen Netzwerk, ohne zusätzliches Permission-Plugin.

MuteCloud bringt ein eigenes, einfaches Rechtesystem für Spieler mit. Ränge haben ein Präfix, ein Suffix, eine Priorität und Permissions, Spieler bekommen Ränge und bei Bedarf zusätzlich einzelne Permissions. Die Bridge setzt das auf jedem Server und auf dem Proxy um, ohne weiteres Plugin. Nutzt du schon LuckPerms, brauchst du das nicht und lässt die ranks.toml leer.

Nicht zu verwechseln mit der access.toml: Diese Datei regelt, wer die Cloud selbst bedienen darf, siehe Sicherheit.

Ein Beispiel

rank create vip 10
rank prefix vip &6VIP &7
rank grant vip essentials.fly
rank create team 50
rank inherit team vip
rank prefix team &cTeam &7
rank grant team mutecloud.maintenance.bypass
rank give MuteBefehl team
rank user MuteBefehl

Jeder Spieler hat stillschweigend den Rang default, den die Cloud beim ersten Start anlegt und der sich nicht löschen lässt. Ein neuer Rang erbt default automatisch.

Befehle

BefehlWirkung
rankalle Ränge nach Priorität
rank info <rank>Felder eines Rangs
rank create <name> [priority]neuer Rang, ohne Angabe mit Priorität 0
rank delete <rank>entfernt ihn auch bei Spielern und aus der Vererbung
rank prefix <rank> <text>, rank suffix <rank> <text>Text mit Leerzeichen und &-Farben
rank priority <rank> <number>Reihenfolge
rank inherit <rank> <parent>erbt die Permissions eines anderen Rangs, ein zweiter Aufruf nimmt das zurück
rank grant <rank> <permission>, rank revoke <rank> <permission>Permission geben oder nehmen, -permission verweigert
rank give <player> <rank>, rank take <player> <rank>Rang zuweisen oder entfernen
rank allow <player> <permission>einzelne Permission für einen Spieler
rank deny <player> <permission>einzelne Verweigerung, schlägt den Rang
rank clear <player> <permission>entfernt den einzelnen Eintrag wieder
rank user <player>Ränge, Anzeige und wirksame Permissions eines Spielers
rank check <player> <permission>ja oder nein

Jede Änderung wird sofort gespeichert und an die betroffenen Spieler verteilt, auch während sie online sind. Einen Rang können nur Spieler bekommen, die das Netzwerk mindestens einmal betreten haben.

Wie Permissions ausgewertet werden

Die Permissions aller Ränge eines Spielers, geerbte eingeschlossen, werden nach aufsteigender Priorität aneinandergereiht, danach folgen die einzelnen Permissions des Spielers. Der letzte passende Eintrag entscheidet. Ein Rang mit höherer Priorität gewinnt also gegen einen niedrigeren, und eine einzelne Permission gewinnt gegen alle Ränge.

* passt auf jede Permission, essentials.* passt auf essentials selbst und alles darunter. Ein vorangestelltes - verweigert. Groß- und Kleinschreibung spielt keine Rolle.

Präfix und Suffix kommen vom direkt zugewiesenen Rang mit der höchsten Priorität, geerbte Ränge zählen dafür nicht. Auf den Servern erscheinen sie in der Tab-Liste vor und hinter dem Namen, im Chat nur mit eingeschaltetem [chat] in der network.toml. Auf Servern bis 1.20.4 kürzt Minecraft den Namen in der Tab-Liste auf 16 Zeichen.

Mit LuckPerms

Auf dem Proxy fragt die Bridge zuerst MuteCloud. Hat ein Eintrag dort etwas zur angefragten Permission zu sagen, gilt er, ansonsten antwortet das vorhandene Permission-Plugin. Auf den Servern setzen beide ihre Permissions unabhängig voneinander. Sauberer ist es, sich für eines zu entscheiden.

Die Datei

ranks.toml
[ranks.vip]
prefix = "&6VIP &7"
suffix = ""
priority = 10
inherits = ["default"]
grants = ["essentials.fly"]

[players.mutebefehl]
name = "MuteBefehl"
uuid = "..."
ranks = ["team"]
grants = []

Die ranks.toml wird nur beim Start der Cloud gelesen, und die Cloud schreibt sie bei jedem Betreten eines Spielers neu. Bearbeite sie nur von Hand, solange die Cloud gestoppt ist, sonst gehen deine Änderungen verloren. Im laufenden Betrieb sind die rank-Befehle der richtige Weg.

Auf dieser Seite