Placeholders

Unterstützte Software

Servertyp	PlaceholderAPI	Dieses Plugin
Paper und Forks	Ja	Ja
Purpur	Ja	Ja
Folia	Ja	Ja
Spigot	Ja	Nein
Andere	Nein	Nein

Plugin installieren

Benötigte Plugins installieren

Lade Placeholders von GitHub und PlaceholderAPI herunter. Folia benötigt PlaceholderAPI 2.11.7 oder neuer.Lege beide JAR-Dateien im Ordner plugins/ des Server-Templates ab. Die Standard-Templates enthalten simplecloud-api bereits.Füge simplecloud-api bei einem eigenen Template über die Einstellung Plugins des Ziels oder über die CLI hinzu.

Passenden Server starten

Starte einen Server aus dem Template. Das Plugin registriert die Expansion simplecloud direkt bei PlaceholderAPI; du musst keine separate Expansion herunterladen.

Platzhalter testen

Betritt den Server und führe diesen Befehl aus:

/papi parse me %simplecloud_server_id%

Ein Gruppenserver gibt seine SimpleCloud-Server-UUID zurück. Verwende auf einem persistenten Server stattdessen einen Platzhalter mit persistent_server_*.

Die Expansion-ID ist simplecloud; alle Platzhalter beginnen deshalb mit %simplecloud_...%.

Server-Platzhalter

Diese Platzhalter werden über SIMPLECLOUD_UNIQUE_ID für den aktuellen SimpleCloud-Server aufgelöst.

Platzhalter	Beschreibung
`%simplecloud_server_id%`	Server-UUID
`%simplecloud_server_type%`	Servergruppentyp
`%simplecloud_server_host%`	Serverhost-ID
`%simplecloud_server_numerical_id%`	Numerische ID innerhalb der Gruppe
`%simplecloud_server_ip%`	Server-IP-Adresse
`%simplecloud_server_port%`	Server-Port
`%simplecloud_server_max_players%`	Maximale Spielerzahl
`%simplecloud_server_min_memory%`	Minimaler Arbeitsspeicher in MB
`%simplecloud_server_max_memory%`	Maximaler Arbeitsspeicher in MB
`%simplecloud_server_player_count%`	Aktuelle Spielerzahl
`%simplecloud_server_state%`	Aktueller Serverstatus

Gruppen-Platzhalter

Diese Platzhalter werden über SIMPLECLOUD_GROUP für die aktuelle SimpleCloud-Gruppe aufgelöst.

Platzhalter	Beschreibung
`%simplecloud_group_name%`	Gruppenname
`%simplecloud_group_type%`	Servergruppentyp
`%simplecloud_group_min_memory%`	Minimaler Speicher in MB
`%simplecloud_group_max_memory%`	Maximaler Speicher in MB
`%simplecloud_group_max_players%`	Maximale Spielerzahl pro Server
`%simplecloud_group_player_count%`	Gesamtzahl der Spieler auf allen Gruppenservern

Persistent-Server-Platzhalter

Diese Platzhalter werden über SIMPLECLOUD_UNIQUE_ID für den aktuellen persistenten Server aufgelöst.

Platzhalter	Beschreibung
`%simplecloud_persistent_server_id%`	Persistent-Server-UUID
`%simplecloud_persistent_server_name%`	Name des persistenten Servers
`%simplecloud_persistent_server_type%`	Servertyp
`%simplecloud_persistent_server_host%`	Zugewiesene Serverhost-ID
`%simplecloud_persistent_server_max_players%`	Maximale Spielerzahl
`%simplecloud_persistent_server_min_memory%`	Minimaler Speicher in MB
`%simplecloud_persistent_server_max_memory%`	Maximaler Speicher in MB
`%simplecloud_persistent_server_player_count%`	Aktuelle Spieleranzahl oder `0`, wenn keine Instanz läuft
`%simplecloud_persistent_server_is_active%`	Ob der persistente Server aktiv ist

Andere Ressource auswählen

Standardmäßig liefern die oben aufgeführten Platzhalter Informationen über den Server, auf dem das Plugin läuft. Für eine andere Ressource fügst du deren Selektor vor der Eigenschaft ein.

Ressource	Format
Gruppe	`%simplecloud_group_<group-name>_<property>%`
Persistenter Server	`%simplecloud_persistent_server_<persistent-server-name>_<property>%`
Laufender Server über Gruppe und numerische ID	`%simplecloud_server_<group-name>:<numerical-id>_<property>%`
Laufender Server über UUID	`%simplecloud_server_id:<server-id>_<property>%`

Zum Beispiel:

%simplecloud_group_Lobby_player_count%
%simplecloud_persistent_server_MainLobby_is_active%
%simplecloud_server_Lobby:1_state%
%simplecloud_server_id:550e8400-e29b-41d4-a716-446655440000_player_count%

Verwende dieselben Eigenschaften, die in den Tabellen oben nach dem Ressourcenpräfix stehen. Aus server_player_count wird beispielsweise server_Lobby:1_player_count und aus group_max_players wird group_Lobby_max_players.

Gruppen- und Persistent-Server-Namen dürfen Unterstriche enthalten. Der Doppelpunkt in einem Selektor für laufende Server trennt den Gruppennamen von der numerischen Server-ID.

Ein Platzhalter mit explizitem Ziel kann nicht aufgelöst werden, wenn die ausgewählte Ressource nicht existiert, der laufende Server offline oder der Selektor ungültig ist.

Beispiel

scoreboard:
  title: "&bServerstatus"
  lines:
    - "&7Server: &f%simplecloud_server_id%"
    - "&7Spieler: &f%simplecloud_server_player_count%/%simplecloud_server_max_players%"
    - "&7Status: &f%simplecloud_server_state%"
    - ""
    - "&7Gruppe: &f%simplecloud_group_name%"
    - "&7Spieler gesamt: &f%simplecloud_group_player_count%"
    - ""
    - "&7Lobby-1: &f%simplecloud_server_Lobby:1_player_count% Spieler"

Wenn ein Platzhalter für die aktuelle Ressource keinen Wert liefert, prüfe, ob der Server über SimpleCloud läuft und die passende Umgebungsvariable verfügbar ist. Kontrolliere bei einem expliziten Ziel außerdem den Ressourcennamen, die UUID oder die numerische ID.

Fehlerbehebung

PlaceholderAPI lässt den Platzhalter unverändert

Prüfe, ob PlaceholderAPI, simplecloud-api und simplecloud-placeholder auf demselben Paper-Server aktiviert sind. Suche danach im Serverprotokoll nach Fehlern beim Laden der Abhängigkeiten oder beim Registrieren der Expansion.

Ein Platzhalter für den aktuellen Server bleibt leer

Starte den Server über SimpleCloud. Diese Platzhalter benötigen die Umgebungsvariable SIMPLECLOUD_UNIQUE_ID oder SIMPLECLOUD_GROUP, die SimpleCloud beim Start setzt.

Ein Platzhalter mit explizitem Ziel bleibt leer

Prüfe Ressourcenname, UUID oder numerische ID. Das Ziel muss existieren; ein gezielt ausgewählter laufender Server muss außerdem online sein.

Introduction

Setup

Configuration

Plugins

Unterstützte Software

Plugin installieren

Server-Platzhalter

Gruppen-Platzhalter

Persistent-Server-Platzhalter

Andere Ressource auswählen

Beispiel

Fehlerbehebung

​Unterstützte Software

​Plugin installieren

​Server-Platzhalter

​Gruppen-Platzhalter

​Persistent-Server-Platzhalter

​Andere Ressource auswählen

​Beispiel

​Fehlerbehebung

Unterstützte Software

Plugin installieren

Server-Platzhalter

Gruppen-Platzhalter

Persistent-Server-Platzhalter

Andere Ressource auswählen

Beispiel

Fehlerbehebung