Unterstützte Software
Plugin installieren
1
Server-Plugins installieren
Lade Prefixes von GitHub herunter und lege die JAR-Datei im Ordner
plugins/ des Paper-Server-Templates ab. Die Standard-Templates enthalten simplecloud-api bereits. Füge es bei einem eigenen Template über die Einstellung Plugins des Ziels oder über die CLI hinzu.Installiere zusätzlich LuckPerms, wenn du general.source: LUCKPERMS verwenden möchtest.2
Konfiguration erzeugen
Starte einen passenden Server. Prefixes legt
config.yml und messages.yml unter plugins/simplecloud-prefixes/ an.3
Konfiguration ins Template übernehmen
Kopiere bei einem Gruppenserver
plugins/simplecloud-prefixes/ vor dem Stoppen an denselben Pfad im Template. Bearbeite anschließend die Kopie im Template.Unter Templates findest du den vollständigen Ablauf.4
Konfiguration anwenden und prüfen
Führe nach Änderungen an Dateien eines laufenden Servers
/scprefix reload aus. Starte stattdessen einen neuen Server, wenn du das Template bearbeitet hast.Betritt den Server und prüfe für jede aktivierte Funktion, ob dein Gruppenpräfix im Chat, in der Tablist und im Anzeigenamen erscheint.
Konfiguration
Prefixes ordnet jeden Spieler einer Gruppe zu. Die Gruppen stammen entweder aus der Plugin-Konfiguration oder aus LuckPerms.config.yml
Die Hauptkonfigurationsdatei steuert die Gruppenquelle, Gruppendefinitionen, einzelne Funktionen und die Synchronisierung zwischen Servern.source auf LUCKPERMS steht, kommt jeder Wert aus der LuckPerms-Gruppe:
Platzhalter
Hier findest du alle verfügbaren Platzhalter.Funktionsschalter
Unterfeatures aktivierst oder deaktivierst du die lokalen Funktionen des Plugins:
chatformatiert lokale Chat-Nachrichten mit demchat-formatder Gruppetablistwendet Prefix, Suffix, Farbe und Priorität der Gruppe auf die Tablist andisplay-namewendet den konfiguriertendisplay-namean; bei deaktivierter Funktion wird der normale Minecraft-Name verwendet
Synchronisierung zwischen Servern
Über das SimpleCloud-Netzwerk können zwei Dinge geteilt werden:- Chat: formatierte Chat-Nachrichten von Spielern auf anderen Servern
- Tablist: Tablist-Einträge von Spielern auf anderen Servern
sync.enabled: false deaktivierst du die gesamte Kommunikation zwischen Servern, ohne die lokale Formatierung auszuschalten. Unter channels wählst du, ob Chat, Tablist-Einträge oder beides synchronisiert werden. Ein Kanal funktioniert nur, wenn die zugehörige Option unter features ebenfalls aktiviert ist.
Die Liste sources legt fest, von welchen Servern dieser Server Aktualisierungen empfängt:
CURRENTempfängt Aktualisierungen aus der aktuellen Servergruppe oder, bei einem persistenten Server, nur von diesem ServerALLempfängt Aktualisierungen von jedem Server im Netzwerk und muss der einzige Listeneintrag sein- Ein Servergruppenname oder eine persistente Server-ID empfängt Aktualisierungen aus genau dieser Quelle
Befehle
API
Mit der API liest du die Präfixdaten eines Spielers aus und registrierst eigene Gruppen.Abhängigkeit hinzufügen
Zugriff auf die API
- Paper
Die folgenden kurzen Beispiele setzen die oben erzeugte Instanz
api und einen Plattformspieler namens player voraus. Füge sie in die Methoden deines Plugins ein. Das Beispiel für eine eigene Gruppe zeigt eine vollständige Klasse.Spieler verwalten
Die Gruppe eines Spielers holen:Gruppen verwalten
Alle Gruppen auflisten, höchste Priorität zuerst:Bewährte Vorgehensweisen
- Vergib eindeutige Prioritäten, damit die Reihenfolge in der Tablist vorhersehbar bleibt
- Nutze für alle Gruppen dasselbe
chat-format, außer ein Rang soll im Chat bewusst auffallen - Verwende
<color>indisplay-nameundchat-format, anstatt Hex-Codes zu wiederholen - Lass
default-groupauf eine Gruppe mit leererpermissionzeigen, damit jeder Spieler eine Gruppe bekommt