PlaceholderAPI : placeholders
Installer PlaceholderAPI, charger les expansions, une liste de placeholders utiles et le débogage lorsque le placeholder lui-même s'affiche au lieu de la valeur.
Mis à jour le 13 août 2026
PlaceholderAPI est une bibliothèque de placeholders. Elle permet à un plugin d'afficher les données d'un autre : solde dans le chat, région sur le scoreboard, clan dans la liste des joueurs.
Installation
Installez le plugin depuis le catalogue, puis les expansions correspondant aux sources de données dont vous avez besoin :
papi ecloud download Vault
papi ecloud download Player
papi ecloud download Server
papi reload
Installez les expansions une par une, une pour chaque source de données.
Placeholders utiles
| Placeholder | Signification |
|---|---|
%player_name% | Pseudo |
%player_ping% | Ping |
%player_world% | Monde |
%server_online% | Joueurs en ligne |
%server_tps_1% | TPS sur la dernière minute |
%vault_eco_balance_formatted% | Solde |
%luckperms_prefix% | Préfixe du groupe |
%worldguard_region_name% | Région où se trouve le joueur |
Test
papi parse me %vault_eco_balance%
La commande affiche ce qui est réellement substitué. Si vous voyez le texte brut %vault_eco_balance%, cela signifie que :
- l'expansion n'est pas installée ;
- la source de données est absente (aucun plugin d'économie) ;
- le plugin dans lequel vous avez inséré le placeholder ne prend pas en charge PlaceholderAPI.
La dernière cause est la plus fréquente : tous les plugins ne prennent pas en charge les placeholders externes, même s'ils ont les leurs.
Performances
Les placeholders sont recalculés à chaque rafraîchissement. Un scoreboard avec dix valeurs, rafraîchi à chaque tick, représente 200 calculs par seconde et par joueur : Scoreboard.
