PlaceholderAPI — le plugin de substitution de données dynamiques dans Minecraft

PlaceholderAPI — le plugin de substitution de données dynamiques dans Minecraft

• Version de Minecraft sur laquelle l'article a été testé et rédigé : 26.1.2

• Plage de versions prises en charge : 1.8.x – 26.1.x

PlaceholderAPI (abrégé PAPI) est un plugin serveur pour Minecraft qui insère dans le texte des valeurs dynamiques à la place de marqueurs spéciaux. À lui seul, il n'affiche rien : c'est un moteur qui recherche dans une chaîne un marqueur du type %player_name% et le remplace par la valeur actuelle — le nom du joueur, son solde, son rang, le nombre de joueurs en ligne. Les données elles-mêmes sont fournies par des modules distincts — les extensions —, tandis que PAPI ne fait qu'exécuter le remplacement. Grâce à cela, les plugins de chat, de scoreboard, de tab-list et de menus lisent les valeurs dans un format unique, sans syntaxe propre.

Format des placeholders

Un placeholder s'écrit entre deux signes pourcentage : %<розширення>_<параметр>%. La première partie, avant le tiret bas, est le nom de l'extension ; vient ensuite le paramètre précis. Par exemple, %player_name% renvoie le nom du joueur, et %server_online% le nombre de joueurs en ligne.

Le remplacement ne s'effectue que là où le plugin destinataire l'appelle lui-même. Si un plugin ne prend pas en charge PAPI, les marqueurs qu'il contient resteront du texte brut dans ses messages. Il est possible de tester un placeholder précis avec la commande d'analyse :

/papi parse me %player_name%

Si la réponse renvoie le texte du marqueur lui-même plutôt qu'une valeur, c'est que l'extension nécessaire est absente ou que le plugin source est désactivé.

Extensions et eCloud

PlaceholderAPI ne contient nativement aucun placeholder — ils proviennent tous d'extensions. Certaines sont intégrées au plugin source et s'enregistrent automatiquement au démarrage du serveur ; d'autres se présentent comme des fichiers jar séparés, disponibles dans le cloud d'extensions (eCloud), et s'installent dans le dossier /plugins/PlaceholderAPI/expansions/.

L'extension souhaitée peut être téléchargée directement depuis le jeu :

/papi ecloud download <розширення>

/papi reload

Seules les extensions vérifiées peuvent être téléchargées via la commande — c'est une protection contre le code malveillant. Les extensions non vérifiées s'installent manuellement : on télécharge le jar depuis le site puis on le place dans le dossier des extensions.

Commandes

Toutes les commandes commencent par /papi. Par défaut, elles ne sont accessibles qu'aux opérateurs ; des droits spécifiques sont accordés via les nœuds placeholderapi.*.

Configuration

Dans config.yml, seuls quelques paramètres sont utiles à modifier :

Les autres valeurs du fichier sont d'ordre technique (protection des extensions, mode de remplacement dans les composants Adventure, débogage) et ne sont pas modifiées par défaut.

Conclusion

PlaceholderAPI offre un format unique de substitution de données que comprennent des centaines de plugins : au lieu d'une intégration distincte pour chaque plugin, une seule ligne avec un placeholder suffit. Il est utile aux administrateurs de serveurs Minecraft dont le chat, la tab-list, le scoreboard ou les menus reposent sur des données dynamiques ; pour le jeu solo, il n'a pas d'utilité.