PlaceholderAPI
De Nefald
Autres actions
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.
Type
API
Développeur
extended_clip, Glare
Statut
Grade requis
Ressources
Documentation
Hangar
Modrinth
Spigot
Code source
Compatibilité
Dépendance(s)
Aucune
Compatible avec
Plus de 500 plugins
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 |
| |
Système d'extensions |
| |
Compatibilité |
| |
Performance |
| |
API développeur |
|
Documentation complète
|
Installation
Installation standard
- Téléchargez PlaceholderAPI depuis SpigotMC ou Modrinth
- Placez
PlaceholderAPI.jar
dansplugins/
- Redémarrez le serveur
- 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%
|