Permissions de WaterCraft

LuckPerms est le registre central des autorisations. Il indique aux autres plugins si un joueur peut utiliser une commande, combien de homes son groupe lui accorde et quels avantages supplémentaires sont disponibles.

LuckPerms ne constitue pas une deuxième progression. Le joueur avance dans /grade ; WaterCraftGrades valide les objectifs puis met à jour les groupes et permissions nécessaires.

Les trois couches à ne pas confondre

Chaque joueur suit une seule route de progression de Nouveau à Légende. VIP et MVIP se superposent à cette route sans la remplacer. Les groupes de l'équipe restent séparés des grades joueurs.

La progression complète est détaillée dans Grades et objectifs. Le fonctionnement prévu des achats se trouve dans Tebex, VIP et MVIP.

Groupes réellement préparés

WaterCraftGrades crée les groupes de progression grade_nouveau à grade_legende. Chaque groupe hérite du précédent, et le groupe LuckPerms default hérite de grade_nouveau. Lors d'une promotion, le plugin remplace seulement l'ancien groupe de progression du joueur par le nouveau.

Les groupes de soutien sont indépendants :

WaterCraftRecompenses ne cherche pas un nom affiché : il vérifie les permissions watercraftgrades.vip et watercraftgrades.mvip. WaterCraftGrades utilise les mêmes permissions pour afficher VIP ou MVIP dans TAB. Ajouter le bon groupe LuckPerms active donc les deux plugins ; changer seulement un préfixe visuel ne suffit pas.

Pour un test contrôlé, l'équipe peut utiliser /lp user <pseudo> parent add vip ou /lp user <pseudo> parent add mvip, puis la commande parent remove correspondante pour retirer le soutien. Il ne faut pas utiliser parent set, car cela risquerait d'écraser le groupe de progression normal.

Nettoyage restant dans les données

La base LuckPerms vérifiée contient encore d'anciens groupes nommés nouveau et membre, distincts des nouveaux groupes grade_nouveau à grade_legende. Elle conserve également certaines anciennes métadonnées de préfixe staff et un héritage admin vers grade_touriste issu des essais précédents.

Ces éléments ne définissent pas la progression officielle, mais ils doivent être audités avant l'ouverture afin d'éviter des permissions ou un affichage hérités par surprise. L'équipe doit examiner chaque parent et chaque utilisateur dans /lp editor, sauvegarder la base, puis supprimer uniquement les relations confirmées comme obsolètes. Une suppression directe dans le fichier H2 est à proscrire.

Ce que voit un joueur

1. /grade affiche le grade normal, les avantages et le prochain objectif.
2. Une promotion validée débloque les commandes prévues pour le nouveau grade.
3. Le préfixe est actualisé dans la liste des joueurs ouverte avec TAB.
4. Le chat reste lisible : aucun préfixe de grade ne doit être ajouté devant les messages.
5. Les avantages déjà acquis restent disponibles lors des promotions suivantes.

LuckPerms travaille principalement en arrière-plan. Un joueur ordinaire n'a pas besoin d'utiliser /lp et ne doit jamais recevoir de permissions d'administration pour corriger lui-même un problème.

Contrôler une promotion qui semble incomplète

Vérifications du joueur

1. Ferme puis rouvre /grade et vérifie que la promotion est bien confirmée.
2. Déconnecte-toi puis reconnecte-toi une fois.
3. Teste uniquement la nouvelle commande annoncée par le grade.
4. Regarde la liste TAB pour vérifier l'affichage.
5. Si le problème continue, donne à l'équipe ton pseudonyme exact, ton grade affiché et la commande refusée.

Ne redépose pas les ressources et ne réclame pas une seconde promotion : les dépôts déjà validés restent enregistrés.

Vérifications du staff

1. Comparer le grade affiché dans WaterCraftGrades avec le signalement du joueur.
2. Utiliser /lp user <pseudo> info pour examiner ses groupes et ses permissions effectives.
3. Déterminer si le problème vient du groupe, de l'héritage ou de la permission du plugin concerné.
4. Corriger uniquement la cause identifiée, puis faire reconnecter le joueur.
5. Tester la commande et le préfixe TAB sans modifier les objectifs déjà enregistrés.

Si une seule commande reste refusée alors que le grade est correct, le problème peut venir de la permission de cette commande. Changer entièrement le groupe du joueur serait alors une correction trop large.

Utiliser l'éditeur LuckPerms en sécurité

/lp editor est réservé au staff. Il ouvre une session d'édition destinée aux changements contrôlés.

• Ne publie jamais le lien de session dans un salon public.
• Ne donne pas de permission avec un joker global pour gagner du temps.
• Modifie le groupe ou le nœud strictement nécessaire.
• Respecte l'héritage défini par WaterCraftGrades au lieu de recopier toutes les permissions dans chaque groupe.
• Vérifie le résultat sur un compte de test avant de généraliser un changement.
• Conserve une sauvegarde des données LuckPerms avant une réorganisation importante.

WaterCraftGrades reconstruit les groupes grade_* à son démarrage et remet ses permissions gérées dans vip et mvip. Une modification manuelle de ces nœuds peut donc être remplacée au prochain redémarrage. Les changements durables d'avantages doivent être effectués dans la configuration ou le code du plugin, puis validés sur une copie de test.

Les commandes de contrôle du staff sont récapitulées dans Toutes les commandes.

Règle des préfixes

Les préfixes de progression, VIP, MVIP et staff sont conçus pour la liste TAB uniquement. EssentialsXChat ne doit pas injecter ces préfixes dans le format des messages.

Si un grade est correct mais son préfixe apparaît dans le chat, ne change pas les permissions du joueur au hasard : signale un problème de format de chat. Consulte EssentialsXChat pour le comportement attendu.

Principes de sécurité

• Un grade VIP ne doit jamais hériter d'un groupe staff.
• Une permission d'administration ne doit pas être accordée à un groupe de progression.
• Un test temporaire doit être retiré et vérifié immédiatement après usage.
• Le lien d'éditeur, les sauvegardes et les fichiers LuckPerms ne doivent pas être transmis à un joueur.
• Une correction manuelle ne doit pas contourner durablement WaterCraftGrades, qui reste la source de la progression.