Placeholders

📋 Format des Placeholders

Le plugin utilise deux formats de placeholders :

  • Placeholders avec accolades {} — Utilisés dans les messages, chat, etc.

  • Placeholders avec pourcentages %% — Utilisés dans les hologrammes et PlaceholderAPI


🎮 Placeholders Globaux (Format {})

👤 Placeholders du Joueur

Placeholder
Description
Exemple

{player}

Nom du joueur

Steve

{displayname}

Nom d'affichage du joueur (avec préfixe/suffixe)

[Admin] Steve

{ping}

Ping du joueur en millisecondes

45

{health}

Santé du joueur (1 décimale)

20.0

{food}

Niveau de nourriture du joueur

20

{xp}

Niveau d'expérience du joueur

42

{gamemode}

Mode de jeu du joueur (en minuscules)

survival

{uuid}

UUID unique du joueur

123e4567-e89b-12d3-a456-426614174000

{ip}

Adresse IP du joueur

192.168.1.1

🌍 Placeholders du Monde/Serveur

Placeholder
Description
Exemple

{world}

Nom du monde actuel

world

{time}

Heure actuelle (HH:mm:ss)

14:30:45

{date}

Date actuelle (dd/MM/yyyy)

15/12/2023

{online}

Nombre de joueurs en ligne (exclut les joueurs vanish)

24

{maxplayer}

Nombre maximum de joueurs

100

📊 Placeholders de Score

Placeholder
Description
Exemple

{playerscore}

Score du joueur

1250

👥 Placeholders d'Équipe

Placeholder
Description
Exemple

{teamname}

Nom d'affichage de l'équipe du joueur

Rouge

{prefix}

Préfixe de l'équipe du joueur

[Rouge]

{suffix}

Suffixe de l'équipe du joueur

``

{teamcolor}

Couleur de l'équipe du joueur

RED

{teamscore}

Score de l'équipe du joueur

5000

💰 Placeholders d'Économie (Vault)

Placeholder
Description
Exemple
Condition

{balance}

Solde du joueur (2 décimales)

1250.50

Nécessite Vault

💎 Placeholders de Currency (Monnaie)

Placeholder
Description
Exemple
Alias

{currency_name}

Nom de la monnaie configurée

Emeralds

{currency}

{currency}

Alias pour {currency_name}

Emeralds

{currency_name}

📈 Placeholders de Scores Alternatifs

Ces placeholders sont dynamiques et dépendent des types de scores alternatifs enregistrés.

Format
Description
Exemple

{alt_<scoreType>_player}

Score alternatif du joueur pour un type donné

{alt_kills_player}150

{alt_<scoreType>_team}

Score alternatif de l'équipe du joueur pour un type donné

{alt_kills_team}450

📋 Placeholders de Liste

Placeholder
Description
Format

%team_list%

Liste de toutes les équipes (excluant les équipes staff), séparées par des virgules

Rouge, Bleu, Vert

Note: Ce placeholder utilise le format %% même dans le contexte des placeholders globaux.


🎯 Placeholders pour Hologrammes (Format %%)

Ces placeholders sont spécifiquement utilisés dans les hologrammes gérés par Horizons.

👥 Placeholders d'Équipe

Placeholder
Description
Exemple
Valeur par défaut

%team_name%

Nom de l'équipe associée à l'hologramme

Rouge

No Team

%team_display_name%

Nom d'affichage de l'équipe

&c&lRouge

No Team

%team_score%

Score de l'équipe associée

5000

0

👤 Placeholders de Joueur

Placeholder
Description
Exemple
Valeur par défaut

%player_name%

Nom du joueur (quand contexte joueur disponible)

Steve

Unknown Player

%player_score%

Score du joueur (quand contexte joueur disponible)

1250

0

💎 Placeholders de Currency

Placeholder
Description
Exemple
Alias

%currency_name%

Nom de la monnaie configurée

Emeralds

%currency%

%currency%

Alias pour %currency_name%

Emeralds

%currency_name%

🔌 Intégration avec PlaceholderAPI

Dans les hologrammes, tous les placeholders PlaceholderAPI sont également supportés.

  • Les placeholders serveur fonctionnent pour tous les joueurs.

  • Les placeholders joueur utilisent automatiquement le contexte du joueur qui regarde l'hologramme.

Exemple de placeholders PAPI utilisables : %server_online%, %player_name%, etc.


🔌 Placeholders PlaceholderAPI (Format %hz_...%)

Ces placeholders nécessitent PlaceholderAPI. Identifiant: hz

📊 Placeholders de Score du Joueur

Placeholder
Description
Exemple

%hz_player_score%

Score du joueur

1250

%hz_player_name%

Nom du joueur

Steve

👥 Placeholders d'Équipe du Joueur

Placeholder
Description
Exemple

%hz_team%

Nom de l'équipe du joueur

Rouge

%hz_team_display%

Nom d'affichage de l'équipe du joueur

&c&lRouge

%hz_team_score%

Score de l'équipe du joueur

5000

%hz_team_members%

Nombre de membres dans l'équipe du joueur

5

%hz_team_prefix%

Préfixe de l'équipe du joueur

[Rouge]

🎯 Placeholders d'Équipe Spécifique

Ces placeholders permettent d'obtenir des informations sur une équipe spécifique, même si le joueur n'en fait pas partie.

Format
Description
Exemple

%hz_<teamName>_score%

Score d'une équipe spécifique

%hz_Rouge_score%5000

%hz_<teamName>_display%

Nom d'affichage d'une équipe spécifique

%hz_Rouge_display%&c&lRouge

%hz_<teamName>_members%

Nombre de membres d'une équipe spécifique

%hz_Rouge_members%5

%hz_<teamName>_prefix%

Préfixe d'une équipe spécifique

%hz_Rouge_prefix%[Rouge]

Note: Remplacez <teamName> par le nom réel de l'équipe (sensible à la casse).

📈 Placeholders de Scores Alternatifs

Ces placeholders sont dynamiques et dépendent des types de scores alternatifs enregistrés.

Score alternatif du joueur

Format
Description
Exemple

%hz_player_alt_score_<scoreType>%

Score alternatif du joueur pour un type donné

%hz_player_alt_score_kills%150

Score alternatif de l'équipe du joueur

Format
Description
Exemple

%hz_team_alt_score_<scoreType>%

Score alternatif de l'équipe du joueur pour un type donné

%hz_team_alt_score_kills%450

Score alternatif d'une équipe spécifique

Format
Description
Exemple

%hz_<teamName>_alt_score_<scoreType>%

Score alternatif d'une équipe spécifique pour un type donné

%hz_Rouge_alt_score_kills%450

📋 Autres Placeholders

Placeholder
Description
Format

%hz_team_list%

Liste de toutes les équipes (excluant les équipes staff)

Rouge, Bleu, Vert

%hz_currency%

Nom de la monnaie

Emeralds

%hz_currency_name%

Nom de la monnaie

Emeralds


💡 Exemples d'Utilisation

Dans les Messages

{% code title="messages.yml" %}

Dans les Hologrammes