PlaceholderAPI

Logo de PlaceholderAPI

PlaceholderAPI

Type

API

Développeur

extended_clip, Glare

Statut

Installé

Grade requis

Scriptomancien

Ressources

Documentation

Documentation

Hangar

Hangar

Modrinth

Modrinth

Spigot

Spigot

Code source

GitHub

Compatibilité

Dépendance(s)

Aucune

Compatible avec

Plus de 500 plugins

PlaceholderAPI (PAPI) est une bibliothèque API permettant d'utiliser des placeholders dynamiques dans n'importe quel plugin compatible. Elle permet d'afficher des informations en temps réel comme le nom du joueur, son argent, ses statistiques, etc.

Description

PlaceholderAPI est devenue la solution standard pour les placeholders sur serveurs Bukkit/Spigot/Paper. Elle fournit un système d'extensions modulaire permettant d'ajouter des placeholders pour pratiquement n'importe quel plugin populaire. Plus de 500 plugins sont compatibles avec PAPI.

Fonctionnalités

Catégorie	Fonctionnalités
Placeholders intégrés	Informations joueur (nom, displayname, UUID) Statistiques Minecraft (kills, deaths, playtime) Informations serveur (TPS, joueurs en ligne) Mathématiques et calculs Variables JavaScript
Système d'extensions	Plus de 250 extensions disponibles Installation en jeu : /papi ecloud download [nom] Création d'extensions custom Auto-update des extensions Gestion des dépendances
Compatibilité	Support de 500+ plugins Chat, tablist, scoreboard Holograms, signs, books GUIs et menus Titres et action bars
Performance	Cache intelligent Update asynchrone Parsing optimisé Impact minimal sur TPS Gestion mémoire efficace
API développeur	Création d'expansions custom	Documentation complète Hooks faciles Support Maven/Gradle Exemples et tutoriels

Installation

Installation standard

1. Téléchargez PlaceholderAPI depuis SpigotMC ou Modrinth
2. Placez PlaceholderAPI.jar dans plugins/
3. Redémarrez le serveur
4. Installez les extensions nécessaires : /papi ecloud download [extension]

Installation d'extensions

# Lister les extensions disponibles
/papi ecloud list all

# Rechercher une extension
/papi ecloud search vault

# Télécharger et installer
/papi ecloud download Vault
/papi reload

# Voir les extensions installées
/papi list

Configuration

Fichier config.yml

# Vérifier les mises à jour
check_updates: true

# Utiliser le cloud d'extensions
cloud_enabled: true

# URL du cloud (ne pas modifier)
cloud_url: 'https://api.extendedclip.com/v2/'

# Sorting pour /papi list
list_placeholders_by_plugin: true

# Format date/time
date_format: 'dd/MM/yyyy'
time_format: 'HH:mm:ss'

# Préfixe des messages
prefix: '&7[&bPlaceholderAPI&7] '

# Autoriser Javascript (désactivé par défaut pour sécurité)
javascript:
  enabled: false

# Debug mode
debug: false

# Boolean (vrai/faux)
boolean:
  'true': 'yes'
  'false': 'no'

Configuration avancée

# config.yml optimisé
check_updates: true
cloud_enabled: true
list_placeholders_by_plugin: true

# Formats personnalisés
date_format: 'dd/MM/yyyy'
time_format: 'HH:mm:ss'

# Boolean en français
boolean:
  'true': 'Oui'
  'false': 'Non'

# Javascript (attention : risque sécurité)
javascript:
  enabled: false
  engine: 'nashorn'

Commandes

Commande	Description	Permission
/papi	Menu principal	placeholderapi.admin
/papi info <placeholder>	Informations sur un placeholder	placeholderapi.info
/papi parse <joueur> <text>	Teste un placeholder	placeholderapi.parse
/papi parserel <joueur1> <joueur2> <text>	Teste placeholder relationnel	placeholderapi.parse
/papi list	Liste les placeholders actifs	placeholderapi.list
/papi reload	Recharge PAPI	placeholderapi.reload
/papi register <file>	Enregistre une expansion	placeholderapi.register
/papi unregister <expansion>	Désenregistre une expansion	placeholderapi.unregister
Commandes eCloud
/papi ecloud	Menu eCloud	placeholderapi.ecloud
/papi ecloud list <all/installed>	Liste extensions	placeholderapi.ecloud.list
/papi ecloud search <query>	Recherche extension	placeholderapi.ecloud.search
/papi ecloud download <nom>	Télécharge extension	placeholderapi.ecloud.download
/papi ecloud update <nom>	Met à jour extension	placeholderapi.ecloud.update
/papi ecloud refresh	Rafraîchit le cache	placeholderapi.ecloud.refresh
/papi ecloud info <nom>	Info sur extension	placeholderapi.ecloud.info
/papi ecloud placeholders <nom>	Liste placeholders d'une extension	placeholderapi.ecloud.placeholders

Placeholders

Placeholders intégrés

Placeholder	Description	Exemple
Joueur
%player_name%	Nom du joueur	Notch
%player_displayname%	Nom affiché (avec couleurs)	§6Notch
%player_uuid%	UUID du joueur	069a79f4-44e9...
%player_ip%	Adresse IP	127.0.0.1
%player_ping%	Latence (ms)	42
%player_locale%	Langue client	fr_FR
%player_gamemode%	Mode de jeu	SURVIVAL
%player_world%	Monde actuel	world
%player_x%	Coordonnée X	123
%player_y%	Coordonnée Y	64
%player_z%	Coordonnée Z	-456
%player_health%	Vie	20.0
%player_health_rounded%	Vie arrondie	20
%player_max_health%	Vie maximale	20.0
%player_food_level%	Nourriture	20
%player_level%	Niveau XP	30
%player_exp%	XP totale	825
%player_exp_to_level%	XP pour level up	62
%player_total_exp%	XP totale cumulée	123456
%player_item_in_hand%	Item en main	DIAMOND_SWORD
%player_item_in_offhand%	Item main secondaire	SHIELD
Serveur
%server_name%	Nom du serveur (server.properties)	MonServeur
%server_online%	Joueurs en ligne	42
%server_max_players%	Slots maximum	100
%server_unique_joins%	Connexions uniques	9999
%server_tps%	TPS actuel	20.0
%server_ram_used%	RAM utilisée (MB)	2048
%server_ram_free%	RAM libre (MB)	4096
%server_ram_total%	RAM totale (MB)	6144
%server_ram_max%	RAM max (MB)	8192
Temps
%server_time%	Heure serveur	14:30:25
%server_time_<format>%	Heure formatée	%server_time_HH:mm%
%player_first_join_date%	Première connexion	01/01/2024
%player_last_join_date%	Dernière connexion	15/01/2024
Statistiques Minecraft
%statistic_deaths%	Morts	42
%statistic_time_played%	Temps joué (ticks)	123456
%statistic_player_kills%	Kills joueurs	15
%statistic_mob_kills%	Kills mobs	999
%statistic_jump%	Sauts	5000
%statistic_mine_block_<type>%	Blocs minés	%statistic_mine_block_stone%