Hiob : Création

2025-10-08T21:31:38Z

Création

Nouvelle page

{{SHORTDESC:Gestionnaire de permissions}}
{{Infobox Plugin
|nom=LuckPerms
|image=LuckPerms_Logo.png
|legende=Logo de LuckPerms
|type=Administration
|dev=Luck (lucko)
|status=
|grade=
|spigot=28140
|modrinth=luckperms
|hangar=LuckPerms/LuckPerms
|sources=https://github.com/LuckPerms/LuckPerms
|dépendance=Aucune
|compatibilité=1.8.8 à 1.21+
}}

'''LuckPerms''' est le système de gestion de permissions le plus avancé et le plus utilisé pour serveurs Minecraft. Il remplace les anciens systèmes comme PermissionsEx et GroupManager avec une approche moderne, performante et multi-plateforme.

== Description ==

LuckPerms est un plugin de permissions open-source supportant [https://www.spigotmc.org Bukkit/Spigot], [https://papermc.io Paper], [https://www.spongepowered.org Sponge], [https://fabricmc.net Fabric], [https://neoforged.net NeoForge] et [https://www.velocitypowered.com Velocity]/[https://www.spigotmc.org/wiki/bungeecord/ BungeeCord].

== Fonctionnalités ==

{| class="wikitable"
! Catégorie !! Fonctionnalités
|-
| '''Gestion des permissions'''
|
* Permissions par joueur et par groupe
* Héritage multiple de groupes
* Permissions temporaires (expiration)
* Permissions contextuelles (monde, serveur, gamemode...)
* Wildcards et négation (<code>-permission</code>)
* Regex et patterns avancés
* Meta-données custom
|-
| '''Groupes'''
|
* Création illimitée de groupes
* Héritage multiple et priorité
* Groupes temporaires
* Tracks (progression de grades)
* Préfixes et suffixes
* Weights (poids/priorités)
* Groupes par défaut
|-
| '''Interface'''
|
* **Web Editor** : éditeur en ligne intuitif
* **Verbose mode** : debug permissions en temps réel
* Commandes in-game complètes
* Interface visuelle pour tracks
* Import/Export de configurations
* API complète pour développeurs
|-
| '''Stockage'''
|
* MySQL, MariaDB, PostgreSQL
* MongoDB
* SQLite (fichier local)
* H2 (fichier local)
* Configuration YAML/JSON
* Support multi-serveurs (réseau)
* Synchronisation temps réel
|-
| '''Performance'''
|
* Cache agressif et intelligent
* Requêtes async
* Impact minimal (< 1% CPU)
* Optimisé pour gros serveurs
* Support Redis pour sync
* Pas de lag aux changements
|-
| '''Contextes'''
|
* Par monde (<code>world=world_nether</code>)
* Par serveur (<code>server=lobby</code>)
* Par gamemode (<code>gamemode=survival</code>)
* Contextes custom via API
* Combinaisons logiques (AND/OR)
* Negation de contextes
|-
| '''Intégrations'''
|
* [[Vault]] (permissions, chat, economy)
* [[PlaceholderAPI]]
* Tous plugins majeurs
* API native extensible
* Hooks pour formats chat
* Export vers autres systèmes
|-
| '''Multi-plateforme'''
|
* Spigot/Paper (Bukkit)
| Sponge
* Fabric
* NeoForge
* Velocity (proxy)
* BungeeCord (proxy)
* Configuration unifiée
|}

== Installation ==

=== Installation serveur unique ===

# Téléchargez LuckPerms depuis [https://luckperms.net/download LuckPerms.net], [https://modrinth.com/plugin/luckperms Modrinth] ou [https://www.spigotmc.org/resources/28140/ SpigotMC]
# Placez <code>LuckPerms-Bukkit-x.x.x.jar</code> dans <code>plugins/</code>
# (Optionnel) Installez [[Vault]] pour compatibilité legacy
# Démarrez le serveur
# Configuration générée dans <code>plugins/LuckPerms/config.yml</code>

=== Installation réseau (BungeeCord/Velocity) ===

'''Sur le proxy :'''
# Installez <code>LuckPerms-Velocity-x.x.x.jar</code> ou <code>LuckPerms-Bungee-x.x.x.jar</code>
# Configurez la base de données MySQL

'''Sur chaque serveur backend :'''
# Installez <code>LuckPerms-Bukkit-x.x.x.jar</code>
# Configurez la même base de données

'''Configuration MySQL partagée :'''
<syntaxhighlight lang="yaml">
# config.yml (identique sur tous serveurs)

storage-method: mysql

data:
address: localhost:3306
database: minecraft
username: root
password: votre_mot_de_passe

# Préfixe pour tables
table-prefix: 'luckperms_'

# Pool de connexions
pool-settings:
maximum-pool-size: 10
minimum-idle: 10
maximum-lifetime: 1800000
connection-timeout: 5000

# Sync en temps réel
messaging-service: sql
# Ou pour meilleures performances
messaging-service: redis
</syntaxhighlight>

=== Configuration Redis (recommandé pour réseau) ===
<syntaxhighlight lang="yaml">
# Pour sync instantanée entre serveurs

messaging-service: redis

redis:
address: localhost:6379
password: ''
# Utiliser SSL
ssl: false
</syntaxhighlight>

=== Migration depuis autre plugin ===
<syntaxhighlight lang="bash">
# Depuis PermissionsEx
/lp migration permissionsex

# Depuis GroupManager
/lp migration groupmanager

# Depuis PowerfulPerms
/lp migration powerfulperms

# Depuis bPermissions
/lp migration bpermissions

# Depuis zPermissions
/lp migration zpermissions
</syntaxhighlight>

== Configuration ==

=== config.yml principal ===
<syntaxhighlight lang="yaml">
# Serveur (important pour réseaux)
server: lobby

# Stockage
storage-method: h2
# Options: h2, sqlite, mysql, mariadb, postgresql, mongodb

# Si déjà des groupes, ne pas réappliquer
apply-wildcards: false
apply-regex: false

# Préfixes/suffixes via Vault
vault-server: true
vault-include-global: true

# Debug
verbose-mode: false

# Auto-save interval (minutes)
data:
auto-push-updates: true

# Watch file changes (pour config locale)
watch-files: true

# Poids par défaut
primary-group-calculation: stored
# Options: stored, parents-by-weight, all-parents-by-weight
</syntaxhighlight>

=== Groupes de base ===
<syntaxhighlight lang="bash">
# Créer groupes essentiels

# Groupe par défaut
/lp creategroup default
/lp group default permission set essentials.spawn
/lp group default permission set essentials.home
/lp group default permission set essentials.sethome

# VIP
/lp creategroup vip
/lp group vip parent add default
/lp group vip permission set essentials.fly
/lp group vip permission set essentials.hat
/lp group vip meta setprefix "&6[VIP] "

# Modérateur
/lp creategroup moderator
/lp group moderator parent add vip
/lp group moderator permission set essentials.kick
/lp group moderator permission set essentials.mute
/lp group moderator permission set essentials.vanish
/lp group moderator meta setprefix "&9[Mod] "

# Admin
/lp creategroup admin
/lp group admin parent add moderator
/lp group admin permission set *
/lp group admin meta setprefix "&c[Admin] "

# Owner
/lp creategroup owner
/lp group owner parent add admin
/lp group owner permission set *
/lp group owner meta setprefix "&4[Owner] "
</syntaxhighlight>

== Commandes ==

{| class="wikitable sortable"
! Commande !! Description !! Alias
|-
| colspan="3" style="background:#ddd;" | '''Général'''
|-
| <code>/lp</code> || Menu principal || <code>/luckperms</code>, <code>/perms</code>, <code>/permissions</code>
|-
| <code>/lp info</code> || Infos plugin ||
|-
| <code>/lp sync</code> || Synchroniser données ||
|-
| <code>/lp editor</code> || Ouvrir Web Editor ||
|-
| <code>/lp verbose <on/off></code> || Mode debug ||
|-
| <code>/lp reload</code> || Recharger config ||
|-
| <code>/lp import <file></code> || Importer données ||
|-
| <code>/lp export <file></code> || Exporter données ||
|-
| colspan="3" style="background:#ddd;" | '''Utilisateurs'''
|-
| <code>/lp user <joueur> info</code> || Infos utilisateur ||
|-
| <code>/lp user <joueur> permission set <perm></code> || Donner permission ||
|-
| <code>/lp user <joueur> permission unset <perm></code> || Retirer permission ||
|-
| <code>/lp user <joueur> permission check <perm></code> || Vérifier permission ||
|-
| <code>/lp user <joueur> parent add <groupe></code> || Ajouter au groupe ||
|-
| <code>/lp user <joueur> parent remove <groupe></code> || Retirer du groupe ||
|-
| <code>/lp user <joueur> parent set <groupe></code> || Définir groupe principal ||
|-
| <code>/lp user <joueur> clear</code> || Effacer permissions ||
|-
| <code>/lp user <joueur> clone <cible></code> || Cloner permissions ||
|-
| colspan="3" style="background:#ddd;" | '''Groupes'''
|-
| <code>/lp listgroups</code> || Lister groupes || <code>/lp groups</code>
|-
| <code>/lp creategroup <nom></code> || Créer groupe ||
|-
| <code>/lp deletegroup <nom></code> || Supprimer groupe ||
|-
| <code>/lp group <groupe> info</code> || Infos groupe ||
|-
| <code>/lp group <groupe> permission set <perm></code> || Donner permission ||
|-
| <code>/lp group <groupe> permission unset <perm></code> || Retirer permission ||
|-
| <code>/lp group <groupe> parent add <parent></code> || Hériter de groupe ||
|-
| <code>/lp group <groupe> parent remove <parent></code> || Retirer héritage ||
|-
| <code>/lp group <groupe> setweight <poids></code> || Définir priorité ||
|-
| <code>/lp group <groupe> clear</code> || Effacer permissions ||
|-
| <code>/lp group <groupe> clone <cible></code> || Cloner groupe ||
|-
| <code>/lp group <groupe> rename <nouveau></code> || Renommer groupe ||
|-
| colspan="3" style="background:#ddd;" | '''Meta (préfixes/suffixes)'''
|-
| <code>/lp user <joueur> meta setprefix <prio> <prefix></code> || Définir préfixe ||
|-
| <code>/lp user <joueur> meta setsuffix <prio> <suffix></code> || Définir suffixe ||
|-
| <code>/lp user <joueur> meta unsetprefix</code> || Retirer préfixe ||
|-
| <code>/lp user <joueur> meta unsetsuffix</code> || Retirer suffixe ||
|-
| <code>/lp group <groupe> meta setprefix <prio> <prefix></code> || Préfixe groupe ||
|-
| <code>/lp group <groupe> meta setsuffix <prio> <suffix></code> || Suffixe groupe ||
|-
| <code>/lp user <joueur> meta set <key> <value></code> || Définir meta custom ||
|-
| <code>/lp user <joueur> meta unset <key></code> || Retirer meta ||
|-
| colspan="3" style="background:#ddd;" | '''Permissions temporaires'''
|-
| <code>/lp user <joueur> permission settemp <perm> <durée></code> || Permission temporaire ||
|-
| <code>/lp user <joueur> parent addtemp <groupe> <durée></code> || Groupe temporaire ||
|-
| <code>/lp group <groupe> permission settemp <perm> <durée></code> || Permission temp groupe ||
|-
| colspan="3" style="background:#ddd;" | '''Contextes'''
|-
| <code>/lp user <joueur> permission set <perm> world=world</code> || Permission par monde ||
|-
| <code>/lp user <joueur> permission set <perm> server=lobby</code> || Permission par serveur ||
|-
| <code>/lp group <groupe> permission set <perm> gamemode=survival</code> || Permission par gamemode ||
|-
| colspan="3" style="background:#ddd;" | '''Tracks'''
|-
| <code>/lp createtrack <nom></code> || Créer track ||
|-
| <code>/lp deletetrack <nom></code> || Supprimer track ||
|-
| <code>/lp listracks</code> || Lister tracks || <code>/lp tracks</code>
|-
| <code>/lp track <track> info</code> || Infos track ||
|-
| <code>/lp track <track> append <groupe></code> || Ajouter groupe ||
|-
| <code>/lp track <track> insert <groupe> <pos></code> || Insérer groupe ||
|-
| <code>/lp track <track> remove <groupe></code> || Retirer groupe ||
|-
| <code>/lp user <joueur> promote <track></code> || Promouvoir joueur ||
|-
| <code>/lp user <joueur> demote <track></code> || Rétrograder joueur ||
|-
| colspan="3" style="background:#ddd;" | '''Debug & Utilitaires'''
|-
| <code>/lp verbose on</code> || Activer verbose ||
|-
| <code>/lp verbose record</code> || Enregistrer session ||
|-
| <code>/lp verbose paste</code> || Partager logs ||
|-
| <code>/lp verbose off</code> || Désactiver verbose ||
|-
| <code>/lp tree [scope]</code> || Arbre permissions ||
|-
| <code>/lp search <perm></code> || Chercher permission ||
|-
| <code>/lp check <joueur> <perm></code> || Tester permission ||
|}

=== Formats de durée ===
<syntaxhighlight lang="text">
s = secondes (ex: 30s)
m = minutes (ex: 45m)
h = heures (ex: 2h)
d = jours (ex: 7d)
w = semaines (ex: 2w)
mo = mois (ex: 1mo)
y = années (ex: 1y)

Combinable: 1d12h30m
</syntaxhighlight>

== Web Editor ==

Le '''Web Editor''' est l'interface graphique de LuckPerms accessible via navigateur.

=== Utilisation ===
<syntaxhighlight lang="bash">
# Ouvrir l'éditeur
/lp editor

# Éditer un utilisateur spécifique
/lp user Notch editor

# Éditer un groupe
/lp group admin editor

# Éditer un track
/lp track staff editor
</syntaxhighlight>

Un lien unique et sécurisé sera généré, exemple :
<code>https://editor.luckperms.net/#abcd1234</code>

=== Fonctionnalités Editor ===
* Interface visuelle drag & drop
* Recherche de permissions
* Ajout/suppression en masse
* Modification contextes
* Prévisualisation en temps réel
* Sauvegarde automatique
* Historique des changements
* Export/Import JSON

=== Appliquer les changements ===
Après modifications dans l'éditeur :
# Cliquez sur '''Save''' dans l'éditeur
# Copiez la commande générée
# Collez dans la console Minecraft
# Les changements sont appliqués instantanément

== Exemples avancés ==

=== Système de grades complet ===
<syntaxhighlight lang="bash">
# Créer les groupes
/lp creategroup joueur
/lp creategroup membre
/lp creategroup vip
/lp creategroup mvp
/lp creategroup modérateur
/lp creategroup admin
/lp creategroup owner

# Joueur (défaut)
/lp group joueur permission set essentials.spawn
/lp group joueur permission set essentials.help
/lp group joueur meta setprefix "&7[Joueur] "
/lp group joueur setweight 10

# Membre (actif)
/lp group membre parent add joueur
/lp group membre permission set essentials.home
/lp group membre permission set essentials.sethome.multiple.3
/lp group membre meta setprefix "&a[Membre] "
/lp group membre setweight 20

# VIP
/lp group vip parent add membre
/lp group vip permission set essentials.sethome.multiple.5
/lp group vip permission set essentials.fly
/lp group vip permission set essentials.hat
/lp group vip permission set essentials.nick
/lp group vip meta setprefix "&6[VIP] "
/lp group vip setweight 30

# MVP
/lp group mvp parent add vip
/lp group mvp permission set essentials.sethome.unlimited
/lp group mvp permission set essentials.fly.safelogin
/lp group mvp permission set essentials.speed
/lp group mvp meta setprefix "&e[MVP] "
/lp group mvp setweight 40

# Modérateur
/lp group modérateur parent add mvp
/lp group modérateur permission set essentials.kick
/lp group modérateur permission set essentials.mute
/lp group modérateur permission set essentials.tempban
/lp group modérateur permission set essentials.vanish
/lp group modérateur permission set essentials.socialspy
/lp group modérateur meta setprefix "&9[Mod] "
/lp group modérateur setweight 50

# Admin
/lp group admin parent add modérateur
/lp group admin permission set essentials.ban
/lp group admin permission set essentials.unban
/lp group admin permission set essentials.jail
/lp group admin permission set essentials.god
/lp group admin permission set essentials.gamemode
/lp group admin permission set worldedit.*
/lp group admin meta setprefix "&c[Admin] "
/lp group admin setweight 60

# Owner
/lp group owner parent add admin
/lp group owner permission set *
/lp group owner meta setprefix "&4[Owner] "
/lp group owner setweight 100

# Créer track de progression
/lp createtrack staff
/lp track staff append joueur
/lp track staff append membre
/lp track staff append vip
/lp track staff append mvp
/lp track staff append modérateur
/lp track staff append admin
/lp track staff append owner

# Promouvoir un joueur
/lp user Notch promote staff
</syntaxhighlight>

=== Permissions par monde ===
<syntaxhighlight lang="bash">
# Fly seulement dans lobby
/lp group vip permission set essentials.fly true world=lobby

# PvP désactivé dans monde créatif
/lp group default permission set pvp.allow false world=creative

# Permissions différentes par monde
/lp user Notch permission set worldedit.* true world=build
/lp user Notch permission set worldedit.* false world=survival
</syntaxhighlight>

=== Permissions temporaires ===
<syntaxhighlight lang="bash">
# VIP 30 jours
/lp user Notch parent addtemp vip 30d

# Permission 2 heures
/lp user Notch permission settemp essentials.fly 2h

# VIP jusqu'à date précise
/lp user Notch parent addtemp vip 2024-12-31T23:59:59

# Voir expirations
/lp user Notch info
</syntaxhighlight>

=== Permissions négatives ===
<syntaxhighlight lang="bash">
# Groupe a toutes permissions sauf une
/lp group admin permission set *
/lp group admin permission set -essentials.sudo

# Bloquer commande spécifique
/lp user Notch permission set -essentials.fly

# Override permission de groupe
/lp group vip permission set essentials.*
/lp user Notch permission set -essentials.nick
</syntaxhighlight>

=== Contextes multiples ===
<syntaxhighlight lang="bash">
# Fly seulement dans lobby ET en créatif
/lp user Notch permission set essentials.fly world=lobby gamemode=creative

# Permissions différentes par serveur (réseau)
/lp user Notch permission set plotme.* server=creative
/lp user Notch permission set factions.* server=survival

# Combiner contextes
/lp group builder permission set worldedit.* server=build world=flatworld
</syntaxhighlight>

=== Wildcard avancé ===
<syntaxhighlight lang="bash">
# Toutes permissions essentials sauf economy
/lp group vip permission set essentials.*
/lp group vip permission set -essentials.eco.*

# WorldEdit sauf //set et //replace
/lp group helper permission set worldedit.*
/lp group helper permission set -worldedit.set
/lp group helper permission set -worldedit.replace

# Seulement permissions de lecture
/lp group viewer permission set coreprotect.lookup
/lp group viewer permission set coreprotect.inspect
/lp group viewer permission set -coreprotect.rollback
</syntaxhighlight>

=== Préfixes/Suffixes avancés ===
<syntaxhighlight lang="bash">
# Préfixe avec priorité
/lp group admin meta setprefix 100 "&c[Admin] "
/lp group vip meta setprefix 50 "&6[VIP] "

# Préfixe personnel (override groupe)
/lp user Notch meta setprefix 999 "&4[Fondateur] "

# Suffixe
/lp group mvp meta setsuffix 50 " &6★"

# Multiple préfixes (stack)
/lp group admin meta addprefix 100 "&c[Admin] "
/lp group admin meta addprefix 90 "&7[Builder] "

# Meta custom
/lp user Notch meta set "discord" "Notch#0001"
/lp user Notch meta set "birthday" "2024-06-01"
</syntaxhighlight>

== API Développeur ==

=== Dépendance Maven ===
<syntaxhighlight lang="xml">
<repositories>
<repository>
<id>luck-repo</id>
<url>https://repo.lucko.me/</url>
</repository>
</repositories>

<dependencies>
<dependency>
<groupId>net.luckperms</groupId>
<artifactId>api</artifactId>
<version>5.4</version>
<scope>provided</scope>
</dependency>
</dependencies>
</syntaxhighlight>

=== Dépendance Gradle ===
<syntaxhighlight lang="groovy">
repositories {
maven { url 'https://repo.lucko.me/' }
}

dependencies {
compileOnly 'net.luckperms:api:5.4'
}
</syntaxhighlight>

=== Exemples de code ===

'''Obtenir l'API :'''
<syntaxhighlight lang="java">
import net.luckperms.api.LuckPerms;
import net.luckperms.api.LuckPermsProvider;

public class MyPlugin extends JavaPlugin {
private LuckPerms luckPerms;

@Override
public void onEnable() {
this.luckPerms = LuckPermsProvider.get();
}
}
</syntaxhighlight>

'''Vérifier permission :'''
<syntaxhighlight lang="java">
import net.luckperms.api.model.user.User;
import net.luckperms.api.query.QueryOptions;

public boolean hasPermission(Player player, String permission) {
User user = luckPerms.getUserManager().getUser(player.getUniqueId());
if (user == null) return false;

QueryOptions queryOptions = luckPerms.getContextManager()
.getQueryOptions(player);

return user.getCachedData()
.getPermissionData(queryOptions)
.checkPermission(permission)
.asBoolean();
}
</syntaxhighlight>

'''Ajouter permission :'''
<syntaxhighlight lang="java">
import net.luckperms.api.node.Node;

public void addPermission(UUID uuid, String permission) {
User user = luckPerms.getUserManager().getUser(uuid);
if (user == null) {
// Charger user async si pas en cache
luckPerms.getUserManager().loadUser(uuid).thenAccept(loadedUser -> {
addPermissionToUser(loadedUser, permission);
});
} else {
addPermissionToUser(user, permission);
}
}

private void addPermissionToUser(User user, String permission) {
Node node = Node.builder(permission).build();
user.data().add(node);
luckPerms.getUserManager().saveUser(user);
}
</syntaxhighlight>

'''Ajouter à groupe :'''
<syntaxhighlight lang="java">
import net.luckperms.api.node.types.InheritanceNode;

public void addToGroup(UUID uuid, String groupName) {
User user = luckPerms.getUserManager().getUser(uuid);
Group group = luckPerms.getGroupManager().getGroup(groupName);

if (user != null && group != null) {
InheritanceNode node = InheritanceNode.builder(group).build();
user.data().add(node);
luckPerms.getUserManager().saveUser(user);
}
}
</syntaxhighlight>

'''Permission temporaire :'''
<syntaxhighlight lang="java">
import java.time.Duration;
import java.time.Instant;

public void addTempPermission(UUID uuid, String permission, Duration duration) {
User user = luckPerms.getUserManager().getUser(uuid);
if (user == null) return;

Instant expiry = Instant.now().plus(duration);

Node node = Node.builder(permission)
.expiry(expiry)
.build();

user.data().add(node);
luckPerms.getUserManager().saveUser(user);
}

// Exemple d'utilisation
addTempPermission(playerUUID, "essentials.fly", Duration.ofHours(2));
</syntaxhighlight>

'''Obtenir préfixe/suffixe :'''
<syntaxhighlight lang="java">
public String getPrefix(Player player) {
User user = luckPerms.getUserManager().getUser(player.getUniqueId());
if (user == null) return "";

QueryOptions queryOptions = luckPerms.getContextManager()
.getQueryOptions(player);

CachedMetaData metaData = user.getCachedData()
.getMetaData(queryOptions);

String prefix = metaData.getPrefix();
return prefix != null ? prefix : "";
}

public String getSuffix(Player player) {
User user = luckPerms.getUserManager().getUser(player.getUniqueId());
if (user == null) return "";

QueryOptions queryOptions = luckPerms.getContextManager()
.getQueryOptions(player);

CachedMetaData metaData = user.getCachedData()
.getMetaData(queryOptions);

String suffix = metaData.getSuffix();
return suffix != null ? suffix : "";
}
</syntaxhighlight>

'''Contextes custom :'''
<syntaxhighlight lang="java">
import net.luckperms.api.context.ContextCalculator;
import net.luckperms.api.context.ContextConsumer;
import net.luckperms.api.context.ContextSet;

public class RegionContextCalculator implements ContextCalculator<Player> {

@Override
public void calculate(Player player, ContextConsumer consumer) {
String region = getPlayerRegion(player);
if (region != null) {
consumer.accept("region", region);
}
}

private String getPlayerRegion(Player player) {
// Votre logique pour obtenir la région
return "spawn"; // exemple
}
}

// Enregistrer le calculator
luckPerms.getContextManager().registerCalculator(new RegionContextCalculator());

// Utiliser le contexte
// /lp user Notch permission set myplugin.special true region=spawn
</syntaxhighlight>

'''Écouter les changements :'''
<syntaxhighlight lang="java">
import net.luckperms.api.event.EventBus;
import net.luckperms.api.event.user.UserDataRecalculateEvent;

EventBus eventBus = luckPerms.getEventBus();

eventBus.subscribe(UserDataRecalculateEvent.class, event -> {
User user = event.getUser();
getLogger().info("Permissions recalculées pour: " + user.getUsername());

// Réagir aux changements
// Exemple: mettre à jour un scoreboard, un prefix, etc.
});
</syntaxhighlight>

== Intégrations ==

=== Vault ===
LuckPerms inclut un hook [[Vault]] automatique pour compatibilité legacy.

'''Configuration :'''
<syntaxhighlight lang="yaml">
# config.yml
vault-server: true
vault-include-global: true
vault-ignore-world: false
</syntaxhighlight>

'''Utilisation via Vault API :'''
<syntaxhighlight lang="java">
// Automatiquement supporté par plugins utilisant Vault
Permission perms = getServer().getServicesManager()
.getRegistration(Permission.class).getProvider();

Chat chat = getServer().getServicesManager()
.getRegistration(Chat.class).getProvider();

// Via Vault (déconseillé, préférer API native LP)
perms.playerAdd(world, player.getName(), "permission.node");
String prefix = chat.getPlayerPrefix(world, player.getName());
</syntaxhighlight>

=== PlaceholderAPI ===

LuckPerms fournit des placeholders [[PlaceholderAPI]] :

<syntaxhighlight lang="text">
# Groupe principal
%luckperms_prefix%
%luckperms_suffix%
%luckperms_primary_group_name%

# Groupes
%luckperms_groups%
%luckperms_inherited_groups%
%luckperms_has_groups_on_track_<track>%

# Meta
%luckperms_meta_<key>%
%luckperms_meta_<key>_<default>%

# Permissions
%luckperms_has_permission_<permission>%
%luckperms_check_permission_<permission>%
%luckperms_inherits_permission_<permission>%

# Contextes
%luckperms_context_<key>%

# Exemples
%luckperms_prefix% → &c[Admin]
%luckperms_primary_group_name% → admin
%luckperms_meta_discord% → Notch#0001
%luckperms_has_permission_essentials.fly% → true
</syntaxhighlight>

=== Formats de chat ===

Avec [[EssentialsXChat]] :
<syntaxhighlight lang="yaml">
# EssentialsXChat config.yml
format: '{DISPLAYNAME}: {MESSAGE}'

# Avec préfixes LuckPerms
format: '{PREFIX}{DISPLAYNAME}{SUFFIX}&r: {MESSAGE}'

# Avancé
format: '&7[{GROUP}] {PREFIX}{DISPLAYNAME}{SUFFIX}&r&7: &f{MESSAGE}'
</syntaxhighlight>

Avec autres plugins chat, LuckPerms fournit automatiquement préfixes/suffixes via Vault.

== Performance ==

=== Impact système ===
* '''RAM''' : 15-30 MB (selon taille base de données)
* '''CPU''' : <1% en idle, 2-3% lors de changements
* '''Base de données''' : Requêtes optimisées et cache agressif
* '''Réseau''' : Sync quasi-instantanée avec Redis

=== Optimisations ===

'''Cache :'''
<syntaxhighlight lang="yaml">
# config.yml
# Augmenter cache pour gros serveurs
meta-cache-max-size: 1000
context-cache-max-size: 100
</syntaxhighlight>

'''MySQL optimisé :'''
<syntaxhighlight lang="yaml">
data:
pool-settings:
maximum-pool-size: 15 # Plus pour gros serveurs
minimum-idle: 10
maximum-lifetime: 1800000
keep-alive-time: 0
connection-timeout: 5000
</syntaxhighlight>

'''Redis pour réseau :'''
Redis est '''beaucoup plus rapide''' que SQL pour sync entre serveurs.

<syntaxhighlight lang="yaml">
messaging-service: redis
redis:
address: localhost:6379
password: ''
pool-size: 8
</syntaxhighlight>

== Voir aussi ==

* [[Vault]]
* [[PlaceholderAPI]]
* [[EssentialsX]]
* [[TAB]]

== Liens externes ==

* [https://luckperms.net/ Site officiel]
* [https://luckperms.net/wiki/ Wiki officiel]
* [https://github.com/LuckPerms/LuckPerms GitHub]
* [https://editor.luckperms.net/ Web Editor]
* [https://modrinth.com/plugin/luckperms Page Modrinth]
* [https://www.spigotmc.org/resources/28140/ Page SpigotMC]
* [https://discord.gg/luckperms Discord officiel]
* [https://luckperms.net/download Téléchargements]

== Références ==
<references />

Plugin:LuckPerms - Historique des versions

Agrado : namespace essentialX

Hiob : Hiob a déplacé la page LuckPerms vers Plugin:LuckPerms sans laisser de redirection

Hiob le 10 octobre 2025 à 14:46

Hiob le 10 octobre 2025 à 08:22

Hiob : logo png

Hiob : logo svg

Hiob : Création

← Version précédente		Version du 13 février 2026 à 18:29
Ligne 952 :		Ligne 952 :
	* [[Vault]]		* [[Vault]]
	* [[PlaceholderAPI]]		* [[PlaceholderAPI]]
	* [[EssentialsX]]		* [[Plugin:EssentialsX\|EssentialsX]]
	* [[TAB]]		* [[TAB]]

← Version précédente	Version du 10 février 2026 à 20:33
(Aucune différence)

← Version précédente		Version du 10 octobre 2025 à 14:46
Ligne 13 :		Ligne 13 :
	\|sources=https://github.com/LuckPerms/LuckPerms		\|sources=https://github.com/LuckPerms/LuckPerms
	\|dépendance=Aucune		\|dépendance=Aucune
	\|compatibilité=~~1.8.8 à 1.21+~~		\|compatibilité=
	}}		}}

← Version précédente		Version du 10 octobre 2025 à 08:22
Ligne 49 :		Ligne 49 :
	\| '''Interface'''		\| '''Interface'''
	\|		\|
	* Web Editor : éditeur en ligne intuitif		* '''Web Editor''' : éditeur en ligne intuitif
	* Verbose mode : debug permissions en temps réel		* '''Verbose mode''' : debug permissions en temps réel
	* Commandes in-game complètes		* Commandes in-game complètes
	* Interface visuelle pour tracks		* Interface visuelle pour tracks

← Version précédente		Version du 10 octobre 2025 à 08:17
Ligne 2 :		Ligne 2 :
	{{Infobox Plugin		{{Infobox Plugin
	\|nom=LuckPerms		\|nom=LuckPerms
	\|image=LuckPerms_Logo.~~svg~~		\|image=LuckPerms_Logo.png
	\|legende=Logo de LuckPerms		\|legende=Logo de LuckPerms
	\|type=Administration		\|type=Administration

← Version précédente		Version du 10 octobre 2025 à 08:14
Ligne 2 :		Ligne 2 :
	{{Infobox Plugin		{{Infobox Plugin
	\|nom=LuckPerms		\|nom=LuckPerms
	\|image=LuckPerms_Logo.~~png~~		\|image=LuckPerms_Logo.svg
	\|legende=Logo de LuckPerms		\|legende=Logo de LuckPerms
	\|type=Administration		\|type=Administration

Plugin:LuckPerms - Historique des versions

Agrado : namespace essentialX

Hiob : Hiob a déplacé la page LuckPerms vers Plugin:LuckPerms sans laisser de redirection

Hiob le 10 octobre 2025 à 14:46

Hiob le 10 octobre 2025 à 08:22

Hiob : logo png

Hiob : logo svg

Hiob : Création

Agrado : namespace essentialX

Hiob : Hiob a déplacé la page LuckPerms vers Plugin:LuckPerms sans laisser de redirection

Hiob : logo png

Hiob : logo svg

Hiob : Création