Placeholders

Überblick

Das Placeholders Plugin integriert sich in PlaceholderAPI und registriert die simplecloud Expansion. Du kannst SimpleCloud-Werte in Scoreboards, Chatformaten, Hologrammen, Tablists und allen anderen Plugins verwenden, die PlaceholderAPI unterstützen.

Unterstützte Software

Servertyp	PlaceholderAPI	Dieses Plugin
Paper & Forks	Ja	Ja
Purpur	Ja	Ja
Spigot	Ja	Nein
Andere	Nein	Nein

Schnellstart

Lade das Plugin von GitHub herunter.
Installiere PlaceholderAPI.
Stelle sicher, dass das simplecloud-api Plugin auf dem Server installiert ist.
Lege alle drei Plugins im plugins/-Ordner deines Server-Templates ab.
Starte den 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 Spieler
`%simplecloud_server_min_memory%`	Minimaler Speicher in MB
`%simplecloud_server_max_memory%`	Maximaler Speicher in MB
`%simplecloud_server_player_count%`	Aktuelle Spieleranzahl
`%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 Spieler pro Server
`%simplecloud_group_player_count%`	Summierte Spieleranzahl aller Gruppenserver

Persistent-Server-Platzhalter

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

Platzhalter	Beschreibung
`%simplecloud_persistent_server_id%`	Persistent-Server-UUID
`%simplecloud_persistent_server_name%`	Name des Persistent Servers
`%simplecloud_persistent_server_type%`	Servertyp
`%simplecloud_persistent_server_host%`	Zugewiesene Serverhost-ID
`%simplecloud_persistent_server_max_players%`	Maximale Spieler
`%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 Persistent Server aktiv ist

Andere Ressource auswählen

Standardmäßig liefern die oben aufgeführten Platzhalter Informationen über den Server, auf dem das Plugin ausgeführt wird. Um Informationen über eine andere Ressource anzuzeigen, fügst du deren Selektor vor der Eigenschaft ein.

Ressource	Format
Gruppe	`%simplecloud_group_<gruppenname>_<eigenschaft>%`
Persistent Server	`%simplecloud_persistent_server_<persistent-server-name>_<eigenschaft>%`
Laufender Server über Gruppe und numerische ID	`%simplecloud_server_<gruppenname>:<numerische-id>_<eigenschaft>%`
Laufender Server über UUID	`%simplecloud_server_id:<server-id>_<eigenschaft>%`

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 zielgerichteter Platzhalter 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: "&bServer Status"
  lines:
    - "&7Server: &f%simplecloud_server_id%"
    - "&7Players: &f%simplecloud_server_player_count%/%simplecloud_server_max_players%"
    - "&7State: &f%simplecloud_server_state%"
    - ""
    - "&7Group: &f%simplecloud_group_name%"
    - "&7Total Players: &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 innerhalb von SimpleCloud läuft und die passende Umgebungsvariable verfügbar ist. Prüfe bei einem zielgerichteten Platzhalter zusätzlich den Ressourcennamen, die UUID oder die numerische ID.

Introduction

Setup

Configuration

Plugins

Überblick

Unterstützte Software

Schnellstart

Server-Platzhalter

Gruppen-Platzhalter

Persistent-Server-Platzhalter

Andere Ressource auswählen

Beispiel

​Überblick

​Unterstützte Software

​Schnellstart

​Server-Platzhalter

​Gruppen-Platzhalter

​Persistent-Server-Platzhalter

​Andere Ressource auswählen

​Beispiel

Überblick

Unterstützte Software

Schnellstart

Server-Platzhalter

Gruppen-Platzhalter

Persistent-Server-Platzhalter

Andere Ressource auswählen

Beispiel