Minecraft Servers HQ

Plugin Minecraft PlaceholderAPI

Informations sur PlaceholderAPI et les serveurs où il a été trouvé

🔌 À propos de PlaceholderAPI

PlaceholderAPI est un plugin Minecraft qui expose un système centralisé de placeholders et un écosystème d’extensions (l’eCloud). Il permet aux autres plugins de lire et de remplacer des milliers de placeholders dynamiques (données de joueur, valeurs d’économie, valeurs spécifiques à un plugin, etc.) sans nécessiter d’intégration directe ni de dépendances fortes.

🎯 Objectif

Le plugin résout les difficultés d’intégration entre plugins en fournissant une API de placeholders unique et extensible. Les auteurs de plugins publient des extensions qui fournissent des placeholders nommés ; les administrateurs de serveur installent ces extensions afin que les plugins orientés serveur (scoreboards, chat, hologrammes, GUIs) puissent afficher des données en direct avec une syntaxe cohérente.

⚙️ Fonctionnalités

  • API centrale d’analyse des placeholders pour permettre aux autres plugins de s’y connecter.
  • Système d’extensions : extensions empaquetées séparément ou incluses dans des plugins.
  • eCloud (cloud d’extensions) pour trouver et télécharger des extensions vérifiées en jeu.
  • Commandes de gestion à chaud pour lister, enregistrer, désenregistrer et recharger les extensions.
  • Commandes de debug/analyse pour évaluer des placeholders pour un joueur ou diffuser le résultat, utile pour le dépannage.
  • Utilitaires comme la commande dump pour partager les extensions installées et l’état du plugin lors d’une demande de support.

🧩 À qui s’adresse ce plugin

  • Administrateurs de serveur qui ont besoin d’un texte dynamique unifié entre plusieurs plugins (scoreboards, tablists, hologrammes, GUIs).
  • Développeurs de plugins qui veulent exposer ou consommer des placeholders sans imposer de dépendances fortes.
  • Serveurs Survival, mini-jeux et réseaux qui combinent de nombreux plugins et ont besoin d’une syntaxe de placeholders cohérente.

🏗️ Exemples d’utilisation

  • Un serveur installe une extension Vault afin que des placeholders d’économie comme le solde du joueur puissent être utilisés dans les plugins de scoreboard et de chat.
  • Un administrateur télécharge une extension spécifique à un plugin depuis l’eCloud pour qu’un plugin d’hologramme puisse afficher des données d’objectif en direct.
  • Un développeur expose des données de plugin via une PlaceholderExpansion pour que d’autres serveurs puissent afficher ces données sans dépendre directement du plugin.

⌨️ Commandes

CommandeDescriptionPermissionAccès
`/papi parse <playerme> `Analyse les placeholders dans une chaîne et affiche le résultat pour le débogage.non spécifié
`/papi bcparse <playerme> `Analyse les placeholders et diffuse le résultat à tous les joueurs.non spécifié
`/papi cmdparse <playerme> `Analyse les placeholders et exécute la commande résultante.non spécifié
/papi parserel <player1> <player2> <text>Analyse les placeholders relationnels en comparant deux joueurs.non spécifiéAdmin
/papi listListe les extensions actives/enregistrées.non spécifiéAdmin
/papi info <expansion>Affiche des informations sur une extension enregistrée.non spécifiéAdmin
/papi register <filename>Enregistre un jar d’extension depuis le dossier expansions sans redémarrage.non spécifiéAdmin
/papi unregister <filename>Désenregistre/supprime une extension enregistrée.non spécifiéAdmin
/papi reloadRecharge la configuration de PlaceholderAPI et enregistre les extensions nouvellement téléchargées.non spécifiéAdmin
/papi versionAffiche la version du plugin et les auteurs.non spécifiéAdmin
/papi dumpAffiche les informations du plugin, de la version et des extensions pour le support (service de collage).non spécifiéAdmin
/papi ecloud download <expansion> [version]Télécharge une extension vérifiée depuis l’eCloud vers le serveur.non spécifiéAdmin
`/papi ecloud list [allinstalled]`Liste les extensions disponibles sur l’eCloud ou les extensions installées.
/papi ecloud placeholders <expansion>Liste les placeholders fournis par une extension eCloud.non spécifiéAdmin
/papi ecloud statusAffiche la connexion/le statut du service eCloud.non spécifiéAdmin

(À noter : les commandes ci-dessus sont documentées dans la référence officielle des commandes PlaceholderAPI. Les nœuds de permission pour les commandes individuelles ne sont pas listés dans la documentation de commandes référencée.)

⚙️ Installation

📥 Configuration

  • Téléchargez le jar officiel de PlaceholderAPI et placez-le dans le répertoire plugins/ de votre serveur.
  • Démarrez ou redémarrez le serveur et vérifiez dans la console que PlaceholderAPI se charge.
  • Installez les extensions soit en déposant les jars d’extension dans plugins/PlaceholderAPI/expansions/, soit en utilisant les commandes eCloud en jeu (pour les extensions vérifiées).

📦 Dépendances

  • PlaceholderAPI lui-même n’a pas besoin d’une dépendance de plugin générale pour fonctionner. Certains placeholders fournis par des extensions dépendent d’autres plugins (par exemple, une extension qui affiche les valeurs d’économie nécessitera le plugin d’économie correspondant). Ces exigences dépendent de l’extension spécifique.

🧠 Notes techniques

  • PlaceholderAPI est fourni pour les serveurs basés sur Spigot et est également couramment utilisé sur Paper. Il expose une API permettant aux développeurs de plugins d’enregistrer des PlaceholderExpansions.
  • Les extensions peuvent être distribuées sous forme de fichiers jar autonomes ou intégrées à d’autres plugins ; les extensions autonomes sont généralement installées dans plugins/PlaceholderAPI/expansions/.
  • La fonctionnalité eCloud permet de découvrir et télécharger des extensions vérifiées en jeu ; les serveurs doivent autoriser le HTTPS sortant pour que les téléchargements eCloud fonctionnent.
  • Le plugin inclut des commandes de debug et d’analyse pour aider les administrateurs à vérifier que les placeholders sont résolus correctement.

🤝 Quand ce plugin est utile

Si votre serveur utilise plusieurs plugins qui doivent afficher des données dynamiques entre plugins (chat, tab, hologrammes, scoreboards ou GUIs), PlaceholderAPI est utile car il centralise la résolution des placeholders et vous permet d’ajouter la prise en charge de plugins supplémentaires via des extensions modulaires sans modifier chaque plugin consommateur.

Serveurs avec le plugin PlaceholderAPI

La page du plugin PlaceholderAPI montre sur quels serveurs le monitoring a trouvé ce plugin, ainsi qu'avec quelles plateformes et versions il apparaît.

Les plugins peuvent ajouter des commandes, une économie, une protection, des droits d'accès, des mini-jeux, des intégrations ou d'autres mécaniques. Le rôle réel de PlaceholderAPI dépend de la configuration du serveur concerné.

Les données sont formées automatiquement à partir des réponses techniques des serveurs. Si un serveur masque la liste des plugins, il peut ne pas apparaître dans cette section, même s'il utilise PlaceholderAPI.

Utilisez la liste des serveurs avec PlaceholderAPI pour comparer des projets, vérifier les versions compatibles ou trouver des exemples d'utilisation du plugin sur des serveurs publics.