Aller au contenu principal

Permissions

BQBetterHUD utilise un système de permissions simple basé sur Bukkit/Spigot.

🔑 Liste des permissions​

PermissionDéfautDescription
bqhud.adminOPAccès à toutes les commandes /bqhud

📋 Détail des permissions​

bqhud.admin​

Accorde l'accès à :

  • /bqhud reload - Recharger la configuration
  • /bqhud update - Télécharger les mises à jour

Par défaut : Opérateurs uniquement (op: true)

Recommandé pour :

  • Administrateurs du serveur
  • Staff de configuration
  • Gestionnaires de plugins
Sécurité

Cette permission permet de télécharger et installer des mises à jour. Ne l'accordez qu'aux personnes de confiance.

🛠️ Configuration avec un plugin de permissions​

LuckPerms​

Accorder la permission à un joueur​

/lp user <joueur> permission set bqhud.admin true

Accorder la permission à un groupe​

/lp group admin permission set bqhud.admin true

Retirer la permission​

/lp user <joueur> permission unset bqhud.admin

Vérifier les permissions d'un joueur​

/lp user <joueur> permission info

PermissionsEx (PEX)​

Accorder la permission à un joueur​

/pex user <joueur> add bqhud.admin

Accorder la permission à un groupe​

/pex group admin add bqhud.admin

Retirer la permission​

/pex user <joueur> remove bqhud.admin

GroupManager​

Accorder la permission à un groupe​

/manuaddp admin bqhud.admin

Accorder la permission à un joueur​

/manuaddp <joueur> bqhud.admin

👥 Suggestions de configuration​

Configuration recommandée​

# LuckPerms - config.yml
groups:
  admin:
    permissions:
      - bqhud.admin          # Commandes BQBetterHud
      - betonquest.admin.*   # Commandes BetonQuest
      - betterhud.admin      # Commandes BetterHud

  moderator:
    permissions:
      - bqhud.admin          # Peut recharger la config

  builder:
    permissions:
      - betonquest.admin.*   # Peut gérer les quêtes
      # PAS bqhud.admin (ne peut pas modifier la config globale)

Configuration minimale​

Si vous voulez que seuls les OPs puissent utiliser les commandes :

# Aucune configuration nécessaire
# Par défaut, seuls les OPs ont accès

Configuration large​

Si vous voulez que tous les joueurs puissent recharger la config (déconseillé) :

# LuckPerms
/lp group default permission set bqhud.admin true
Attention

Permettre à tous les joueurs de recharger la configuration peut causer des problèmes. Réservez cette permission aux administrateurs.

🎮 Permissions des autres plugins​

BQBetterHUD s'intègre avec BetonQuest et BetterHud. Voici les permissions associées :

BetonQuest​

PermissionDescription
betonquest.adminAccès aux commandes /bq
betonquest.conversationPeut participer aux conversations
Conversations

Les joueurs n'ont pas besoin de permission spéciale pour voir les conversations BQBetterHUD. Si vous utilisez BetonQuest, les conversations fonctionnent automatiquement.

BetterHud​

PermissionDescription
betterhud.adminAccès aux commandes /betterhud
betterhud.reloadPeut recharger la configuration

📝 Vérification des permissions​

Vérifier si un joueur a la permission​

Avec LuckPerms :

/lp user <joueur> permission check bqhud.admin

Avec PermissionsEx :

/pex user <joueur> has bqhud.admin

Lister toutes les permissions d'un joueur​

Avec LuckPerms :

/lp user <joueur> permission info

Avec PermissionsEx :

/pex user <joueur> list

🆘 Problèmes courants​

"Vous n'avez pas la permission"​

Cause : Le joueur n'a pas bqhud.admin

Solutions :

  1. Vérifiez si le joueur est OP :

    /op <joueur>

  2. Accordez la permission manuellement :

    /lp user <joueur> permission set bqhud.admin true

  3. Vérifiez les héritages de groupe :

    /lp user <joueur> info

La permission ne fonctionne pas après l'ajout​

Cause : Cache de permissions ou reconnexion nécessaire

Solutions :

  1. Déconnectez/reconnectez le joueur

  2. Rechargez le plugin de permissions :

    /lp sync
    # ou
    /pex reload

  3. Vérifiez les conflits de permissions :

    /lp user <joueur> permission info

Permission accordée mais commande inaccessible​

Cause : Plugin de permissions non installé ou mal configuré

Solutions :

  1. Vérifiez que LuckPerms/PEX est installé :

    /plugins

  2. Vérifiez que le joueur est OP si pas de plugin de permissions :

    /op <joueur>

  3. Redémarrez le serveur après modification des permissions

🔐 Bonnes pratiques​

1. Principe du moindre privilège​

N'accordez que les permissions nécessaires :

# ❌ Mauvais : trop de permissions
builder:
  - "*"

# ✅ Bon : permissions spécifiques
builder:
  - betonquest.admin.*
  - betterhud.admin

2. Utiliser des groupes​

Au lieu d'accorder des permissions individuelles, utilisez des groupes :

# ❌ Mauvais
/lp user Alice permission set bqhud.admin true
/lp user Bob permission set bqhud.admin true
/lp user Charlie permission set bqhud.admin true

# ✅ Bon
/lp group admin permission set bqhud.admin true
/lp user Alice parent add admin
/lp user Bob parent add admin
/lp user Charlie parent add admin

3. Documenter les permissions​

Créez un fichier de documentation pour votre équipe :

permissions.yml
# Groupe Admin
# Permissions :
#   - bqhud.admin : Gestion de BQBetterHud
#   - betonquest.admin.* : Gestion des quêtes
#   - betterhud.admin : Gestion de BetterHud
#
# Membres : Alice, Bob

# Groupe Moderator
# Permissions :
#   - bqhud.admin : Peut recharger la config
#
# Membres : Charlie, Dave

4. Tester avant de déployer​

Testez les permissions sur un serveur de test avant de les appliquer en production :

# Serveur de test
/lp user TestPlayer permission set bqhud.admin true
# Tester /bqhud reload
# Si OK, appliquer en production

🔗 Ressources externes​

Plugins de permissions recommandés​

Documentation officielle​

💡 Exemples de configuration complète​

Configuration pour un serveur RP​

# LuckPerms
groups:
  proprietaire:
    permissions:
      - "*"

  admin:
    permissions:
      - bqhud.admin
      - betonquest.admin.*
      - betterhud.admin

  gamemaster:
    permissions:
      - betonquest.admin.*  # Peut gérer les quêtes
      - betterhud.admin     # Peut modifier les HUD
      # PAS bqhud.admin (ne peut pas changer la config)

  joueur:
    permissions:
      - betonquest.conversation  # Peut voir les conversations

Configuration pour un serveur mini-jeux​

# LuckPerms
groups:
  admin:
    permissions:
      - "*"

  developpeur:
    permissions:
      - bqhud.admin
      - betonquest.admin.*

  joueur:
    permissions:
      # Aucune permission spéciale nécessaire

🔗 Voir aussi​

Dernière mise à jour le par Bossbirdyman