⛺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" %}

messages:
  welcome: "&aBienvenue {player} ! Vous êtes dans l'équipe {teamname} avec un score de {playerscore}."
  team-info: "Équipe: {teamname} | Score: {teamscore} | Membres: {online} en ligne"

Dans les Hologrammes

holograms.yml

holograms:
  team_info:
    team: Rouge
    lines:
      - '&c&l%team_display_name%'
      - '&fScore: &e%team_score%'
      - '&fJoueurs: &e%player_list%'
    player-format: '&7%player_name%: &f%player_score%'