⛺ 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 (Formatfichier::npc, ex:shop::1)<item>: Identifiant de l'item- Interact :
DIAMOND,IRON_INGOT - Custom :
oraxen:my_sword,itemsadder:namespace:id
- Interact :
⏱️ 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