Skip to main content

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.
LuckPerms-Zuordnung Wenn source auf LUCKPERMS steht, kommt jeder Wert aus der LuckPerms-Gruppe:

Platzhalter

Hier findest du alle verfügbaren Platzhalter.
Verwende <color>, anstatt denselben Hex-Code in jeden Wert zu schreiben. Die Farbe wird als Formatierung angewendet, sodass alle folgenden Inhalte die Gruppenfarbe übernehmen.

Funktionsschalter

Unter features aktivierst oder deaktivierst du die lokalen Funktionen des Plugins:
  • chat formatiert lokale Chat-Nachrichten mit dem chat-format der Gruppe
  • tablist wendet Prefix, Suffix, Farbe und Priorität der Gruppe auf die Tablist an
  • display-name wendet den konfigurierten display-name an; 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
Mit 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:
  • CURRENT empfängt Aktualisierungen aus der aktuellen Servergruppe oder, bei einem persistenten Server, nur von diesem Server
  • ALL empfä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
Du kannst mehrere Gruppennamen und persistente Server-IDs kombinieren. Damit zwei Server Aktualisierungen in beide Richtungen austauschen, muss jeder beteiligte Server Aktualisierungen aus der Gruppe oder von der ID des jeweils anderen empfangen.

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

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:
Die Anzeigewerte eines Spielers holen:
Prüfen, ob ein Spieler in einer bestimmten Gruppe ist:

Gruppen verwalten

Alle Gruppen auflisten, höchste Priorität zuerst:
Eigene Gruppe registrieren:
Übergib beim Registrieren die UUIDs der Gruppenmitglieder. Wenn sich die Mitgliedschaft zur Laufzeit ändert, ersetze das kopierte Set durch den threadsicheren Mitgliederspeicher deines Plugins.

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> in display-name und chat-format, anstatt Hex-Codes zu wiederholen
  • Lass default-group auf eine Gruppe mit leerer permission zeigen, damit jeder Spieler eine Gruppe bekommt