⛺Placeholders

📋 Format des Placeholders

Le plugin utilise deux formats de placeholders :

1. Placeholders avec accolades {} - messages, chat, etc.

2. Placeholders avec pourcentages %% - Utilisés dans les hologrammes et PlaceholderAPI

🎮 Placeholders Globaux (Format {})

Ces placeholders sont disponibles partout où est utilisé (messages, chat, etc.).

👤 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.

👥 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%

📋 Placeholders de Liste (Hologrammes)

Ces placeholders génèrent plusieurs lignes dans les hologrammes.

%team_list%

Affiche une liste de toutes les équipes (excluant les équipes staff), triée par score décroissant. Chaque équipe est affichée sur une ligne séparée selon le format défini par team-format dans la configuration.

Format par défaut: %team_name%: %team_score%

Note: Nécessite une configuration dans holograms.yml avec team-format.

%player_list%

Affiche une liste de tous les joueurs de l'équipe associée à l'hologramme, triée par score décroissant. Chaque joueur est affiché sur une ligne séparée selon le format défini par player-format dans la configuration.

Format par défaut: %player_name%: %player_score%

Note:

• Nécessite qu'un hologramme soit associé à une équipe via /horizons hologram setteam

• Nécessite une configuration dans holograms.yml avec player-format

• Si aucun équipe n'est définie, la ligne est ignorée

🔌 Intégration avec PlaceholderAPI

Dans les hologrammes, tous les placeholders PlaceholderAPI sont également supportés. Les placeholders serveur fonctionnent pour tous les joueurs, tandis que les placeholders joueur utilisent automatiquement le contexte du joueur qui regarde l'hologramme.

Exemple: %server_online%, %player_name% (PAPI), etc.

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

Ces placeholders nécessitent PlaceholderAPI et sont disponibles partout où PlaceholderAPI est utilisé.

📊 Placeholders de Score du Joueur

Placeholder	Description	Exemple
%horizons_player_score%	Score du joueur	1250

👥 Placeholders d'Équipe du Joueur

Placeholder	Description	Exemple
%horizons_team%	Nom de l'équipe du joueur	Rouge
%horizons_team_display%	Nom d'affichage de l'équipe du joueur	&c&lRouge
%horizons_team_score%	Score de l'équipe du joueur	5000
%horizons_team_members%	Nombre de membres dans l'équipe du joueur	5
%horizons_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
%horizons_<teamName>_score%	Score d'une équipe spécifique	%horizons_Rouge_score% → 5000
%horizons_<teamName>_display%	Nom d'affichage d'une équipe spécifique	%horizons_Rouge_display% → &c&lRouge
%horizons_<teamName>_members%	Nombre de membres d'une équipe spécifique	%horizons_Rouge_members% → 5
%horizons_<teamName>_prefix%	Préfixe d'une équipe spécifique	%horizons_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
%horizons_player_alt_score_<scoreType>%	Score alternatif du joueur pour un type donné	%horizons_player_alt_score_kills% → 150

Score Alternatif de l'Équipe du Joueur

Format	Description	Exemple
%horizons_team_alt_score_<scoreType>%	Score alternatif de l'équipe du joueur pour un type donné	%horizons_team_alt_score_kills% → 450

Score Alternatif d'une Équipe Spécifique

Format	Description	Exemple
%horizons_<teamName>_alt_score_<scoreType>%	Score alternatif d'une équipe spécifique pour un type donné	%horizons_Rouge_alt_score_kills% → 450

Note:

• Remplacez <scoreType> par le type de score alternatif enregistré (ex: kills, deaths, etc.)

• Remplacez <teamName> par le nom réel de l'équipe pour les placeholders d'équipe spécifique

🏆 Placeholders de Challenges (Format %horizons_challenges_...%)

Ces placeholders nécessitent PlaceholderAPI et le système de challenges activé.

📊 Placeholders Généraux

Placeholder	Description	Exemple
%horizons_challenges_total%	Nombre total de challenges	25
%horizons_challenges_completed%	Nombre de challenges complétés par le joueur	15
%horizons_challenges_remaining%	Nombre de challenges restants pour le joueur	10
%horizons_challenges_active%	Nombre de challenges actifs (en cours) pour le joueur	5
%horizons_challenges_completion_percentage%	Pourcentage de completion des challenges	60.0

🔄 Placeholders par Type de Répétition

Ces placeholders filtrent les challenges par type de répétition (DAILY, WEEKLY, UNLIMITED, UNIQUE).

Format	Description	Exemple
%horizons_challenges_daily_<property>%	Challenges quotidiens	%horizons_challenges_daily_total% → 5
%horizons_challenges_weekly_<property>%	Challenges hebdomadaires	%horizons_challenges_weekly_completed% → 3
%horizons_challenges_unlimited_<property>%	Challenges illimités	%horizons_challenges_unlimited_active% → 2
%horizons_challenges_unique_<property>%	Challenges uniques	%horizons_challenges_unique_completion_percentage% → 100.0

Propriétés disponibles: total, completed, remaining, active, completion_percentage

🎯 Placeholders par Type de Challenge

Ces placeholders filtrent les challenges par type (PLAYER, TEAM, GLOBAL).

Format	Description	Exemple
%horizons_challenges_player_<property>%	Challenges de joueur	%horizons_challenges_player_total% → 10
%horizons_challenges_team_<property>%	Challenges d'équipe	%horizons_challenges_team_completed% → 5
%horizons_challenges_global_<property>%	Challenges globaux	%horizons_challenges_global_active% → 2

Propriétés disponibles: total, completed, remaining, active, completion_percentage

🎮 Placeholders pour un Challenge Spécifique

Ces placeholders fournissent des informations détaillées sur un challenge spécifique.

Format	Description	Exemple
%horizons_challenges_<challengeId>_name%	Nom du challenge	%horizons_challenges_kill_10_zombies_name% → Tuer 10 Zombies
%horizons_challenges_<challengeId>_description%	Description du challenge	%horizons_challenges_kill_10_zombies_description% → Tuez 10 zombies
%horizons_challenges_<challengeId>_type%	Type du challenge (player/team/global)	%horizons_challenges_kill_10_zombies_type% → player
%horizons_challenges_<challengeId>_target%	Objectif du challenge	%horizons_challenges_kill_10_zombies_target% → 10
%horizons_challenges_<challengeId>_progress%	Progression actuelle du joueur	%horizons_challenges_kill_10_zombies_progress% → 7
%horizons_challenges_<challengeId>_progress_percentage%	Pourcentage de progression	%horizons_challenges_kill_10_zombies_progress_percentage% → 70.0
%horizons_challenges_<challengeId>_remaining%	Objectif restant	%horizons_challenges_kill_10_zombies_remaining% → 3
%horizons_challenges_<challengeId>_completed%	Si le challenge est complété (true/false)	%horizons_challenges_kill_10_zombies_completed% → false
%horizons_challenges_<challengeId>_status%	Statut du challenge (not_started/in_progress/completed)	%horizons_challenges_kill_10_zombies_status% → in_progress
%horizons_challenges_<challengeId>_trigger%	Déclencheur du challenge	%horizons_challenges_kill_10_zombies_trigger% → kill_entity
%horizons_challenges_<challengeId>_repetition%	Type de répétition	%horizons_challenges_kill_10_zombies_repetition% → daily

Note: Remplacez <challengeId> par l'ID réel du challenge (ex: kill_10_zombies).

💡 Exemples d'Utilisation

Dans les Messages

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:
  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%'

Dans PlaceholderAPI

%horizons_team_display% - Affiche le nom d'affichage de l'équipe
%horizons_player_score% - Affiche le score du joueur
%horizons_challenges_completed% - Affiche le nombre de challenges complétés