Skip to main content

PlaceholderAPI (PAPI) Integration

GWorld v2 bietet eine native Unterstützung für die PlaceholderAPI. Das bedeutet, dass du keine zusätzliche Expansion über die PAPI-eCloud herunterladen musst. Sobald PlaceholderAPI auf deinem Server installiert ist, registriert GWorld seine Platzhalter automatisch.

Verfügbare Platzhalter

Alle GWorld-Platzhalter nutzen das Präfix %gworld_.

Platzhalter

Beschreibung

Beispiel-Ausgabe

%gworld_alias%

Der formatierte Anzeigename (Alias) der Welt, in der sich der Spieler aktuell befindet.

§6Survival

%gworld_alias_<weltname>%

Der formatierte Anzeigename einer spezifisch benannten Welt.

%gworld_alias_world_the_end%

§5Das Ende

%gworld_name%

Der technische Ordnername der Welt, in der sich der Spieler aktuell befindet.

world_survival_v2

%gworld_name_<weltname>%

Gibt den technischen Namen der angefragten Welt zurück. Nützlich für Skripte oder Validierungen.

%gworld_name_lobby%

lobby

Info zum Fallback: Hat eine Welt keinen Alias gesetzt, wird automatisch der technische Weltname zurückgegeben.
Ist der Spieler offline oder wird der Platzhalter fehlerhaft aufgerufen, wird ein leerer Text ("") ausgegeben, um das Layout deiner Tabliste oder deines Scoreboards nicht zu zerstören.

Wird die Welt von GWorld nicht verwaltet, wird ebenfalls ein leerer Text ("") ausgegeben!


Beispiele

Hier sind einige Beispiele, wie du die Platzhalter in anderen Plugins nutzen kannst:

1. In der Tabliste / im Scoreboard

Du möchtest deinen Spielern anzeigen, wo sie sich gerade befinden. Nutze dafür den Alias-Platzhalter, da dieser Farbcodes (z.B. &a) unterstützt: Aktuelle Welt: %gworld_alias%

2. In Chat-Formaten

Füge den Platzhalter in dein Chat-Format ein, um die Welt als Präfix vor dem Spielernamen anzuzeigen: chat-format: "[%gworld_alias%] %player_name%: %message%"

3. In GUI-Menüs

Wenn du ein Welten-Menü baust, kannst du den schönen Alias für das Item-Icon nutzen, musst aber den technischen Namen für den Teleport-Befehl im Hintergrund verwenden:

items:
  survival_world:
    material: GRASS_BLOCK
    display_name: 'Teleport nach: %gworld_alias_farmwelt%'
    left_click_commands:
      - '[player] gtp %gworld_name_farmwelt%'