Documentation
Powered by

# ⛺ Placeholders

Ce document référence l'intégralité des placeholders disponibles dans Horizons. Le plugin utilise deux systèmes distincts : le système Interne (natif) et PlaceholderAPI (PAPI).

# 📋 Référence Rapide des Formats

Système Syntaxe Contexte Exemple
Interne {placeholder} Chat, Menus (GUI), Titres, Scoreboard interne. {player}
PAPI %hz_placeholder% Plugins externes (TAB, FeatherBoard, etc.). %hz_player_score%
Hologrammes %placeholder% Hologrammes natifs Horizons. %team_score%

# 🛠 1. Placeholders Internes (Format {})

Ces placeholders fonctionnent partout dans le plugin Horizons (messages.yml, menus, etc.).

# 👤 Joueur

Placeholder Description Exemple
{player} Nom réel du joueur Steve
{displayname} Nom d'affichage (avec grades) [Admin] Steve
{uuid} UUID unique 123e45...
{ping} Latence en ms 23
{health} Vie (formatée 0.0) 20.0
{food} Niveau de nourriture 20
{xp} Niveau d'expérience 42
{gamemode} Mode de jeu survival
{ip} Adresse IP 192.168.1.1

# 🌍 Serveur & Monde

Placeholder Description Exemple
{world} Nom du monde actuel world
{time} Heure du serveur (HH:mm:ss) 14:30:00
{date} Date du serveur (dd/MM/yyyy) 01/01/2024
{online} Joueurs connectés (sans vanish) 24
{maxplayer} Slots maximum du serveur 100

# 👥 Équipes

Placeholder Description Exemple
{teamname} Nom de l'équipe du joueur Rouge
{prefix} Préfixe de l'équipe &c[R]
{suffix} Suffixe de l'équipe
{teamcolor} Couleur de l'équipe RED
{teamscore} Score de l'équipe 1500
{playerscore} Score personnel du joueur 120
%team_list% Liste des équipes non-staff Rouge, Bleu

# 💰 Économie (Vault)

Placeholder Description Exemple
{balance} Solde du joueur 1250.50
{currency} Nom de la monnaie Emeraudes
{currency_name} Alias pour {currency} Emeraudes

# 🏪 Shops & Économie Dynamique

Ces placeholders permettent d'afficher les données en temps réel des items.

Syntaxe Globale : {shop_<type>_<shopId>_<item>}

  • <shopId> : Identifiant du shop (Format fichier::npc, ex: shop::1)
  • <item> : Identifiant de l'item
    • Interact : DIAMOND, IRON_INGOT
    • Custom : oraxen:my_sword, itemsadder:namespace:id

# ⏱️ Temps

Placeholder Description Exemple
{shop_next_reset} Temps avant reset (formaté) 15m 30s
{shop_next_reset_seconds} Temps avant reset (secondes) 930

# 📦 Données Items

Remplacer <shopId> et <item> dans les exemples ci-dessous :

Type Description Exemple Résultat
type Type de prix (STATIC, TIERED...) TIERED
price Prix actuel 150.0
min_price Prix minimum 50.0
max_price Prix maximum 500.0
base_price Prix de base 100.0
previous_price Prix avant update 145.0
sold Ventes totales (Global) 1542
period_sold Ventes sur la période 42
tier_index Palier actuel 2
next_tier_price Prix du prochain palier 180.0
next_tier_sold Ventes pour prochain palier 2000
supply_threshold Seuil Supply/Demand 100
stock_left Stock avant baisse prix 58

# 🔌 2. PlaceholderAPI (Format %hz_...%)

Utilisables dans les plugins tiers (TAB, FeatherBoard...).

# 👤 Joueur

Placeholder Description
%hz_player_name% Nom du joueur
%hz_player_score% Score personnel
%hz_currency% Nom de la monnaie

# 👥 Équipe du Joueur

Placeholder Description
%hz_team% Nom de l'équipe
%hz_team_display% Nom d'affichage (&cRouge)
%hz_team_prefix% Préfixe ([R])
%hz_team_score% Score de l'équipe
%hz_team_members% Nombre de membres
%hz_team_list% Liste des équipes

# 🏆 Équipe Spécifique

Permet d'afficher les infos d'une équipe précise (utile pour les classements). Remplacer <team> par le nom de l'équipe (sensible à la casse).

Placeholder Description Exemple
%hz_<team>_score% Score de l'équipe %hz_Rouge_score%
%hz_<team>_display% Nom affiché %hz_Rouge_display%
%hz_<team>_members% Nombre de membres %hz_Rouge_members%
%hz_<team>_prefix% Préfixe %hz_Rouge_prefix%

# 🏪 Shops (Via PAPI)

Tous les placeholders de shop internes sont accessibles via PAPI en ajoutant %hz_.

Format : %hz_shop_<type>_<shopId>_<item>%

  • %hz_shop_price_shop::1_DIAMOND%
  • %hz_shop_stock_left_shop::1_DIAMOND%
  • %hz_shop_next_reset%
  • (Voir tableau "Données Items" ci-dessus pour tous les types)

# 🎯 3. Hologrammes Natifs (Format %%)

Ces placeholders sont spécifiques aux hologrammes gérés par Horizons et dépendent souvent du contexte (bloc regardé, entité liée).

Placeholder Description Contexte
%team_name% Nom de l'équipe Propriétaire du bloc/hologramme
%team_display_name% Nom affiché de l'équipe Propriétaire du bloc/hologramme
%team_score% Score de l'équipe Propriétaire du bloc/hologramme
%player_name% Nom du joueur Joueur qui regarde
%player_score% Score du joueur Joueur qui regarde
%currency% Nom de la monnaie Global

# 📈 4. Scores Alternatifs (Extensions)

Si des modules ajoutent des types de scores supplémentaires (ex: kills, wins).

# Format Interne

  • {alt_<type>_player} : Score du joueur
  • {alt_<type>_team} : Score de l'équipe du joueur

# Format PAPI

  • %hz_player_alt_score_<type>% : Score du joueur
  • %hz_team_alt_score_<type>% : Score de l'équipe du joueur
  • %hz_<team>_alt_score_<type>% : Score d'une équipe précise

© Copyright 2026 Horizons