Configurer une extension

La configuration des extensions est réservée au propriétaire de l'instance.

Chaque extension possède sa propre configuration, modifiable via l'éditeur intégré.

Accéder à la configuration

1. Rendez-vous dans Administration > Extensions

2. Cliquez sur l'icône de configuration (engrenage) à côté de l'extension

3. L'éditeur de configuration s'ouvre dans une modale

L'éditeur de configuration

L'éditeur dispose de deux modes :

Mode formulaire

Le mode par défaut affiche un formulaire structuré avec :

• Champs texte pour les chaînes de caractères

• Champs numériques pour les nombres

• Cases à cocher pour les booléens

• Sections repliables pour les objets imbriqués

• Listes éditables pour les tableaux

Chaque champ affiche :

• Son nom et une description explicative

• Son icône indiquant le type (info, action, etc.)

• Sa valeur actuelle modifiable

Mode JSON

Basculez en mode JSON pour éditer la configuration brute :

• Éditeur texte avec coloration syntaxique

• Validation JSON en temps réel

• Utile pour des modifications en masse

Sauvegarder

Cliquez sur Sauvegarder pour appliquer les modifications. La configuration est rechargée à chaud sans redémarrage du backend.

Réinitialiser

Le bouton Réinitialiser restaure la configuration à son état avant vos modifications (dans la session actuelle).

Restreindre l'accès par rôle Discord

La plupart des extensions possèdent un champ requiredDiscordRole dans leur configuration. Ce champ permet de limiter l'accès à cette extension à un rôle Discord spécifique.

• Vide (par défaut) : tous les membres authentifiés (ayant le Required Role global) peuvent accéder à l'extension

• Renseigné avec un ID de rôle Discord : seuls les membres ayant ce rôle (ou le Admin Role, ou le propriétaire) peuvent accéder à l'extension

La partie Logs est la seule fonctionnalité qui n'est pas soumise à cette restriction. Elle est toujours accessible à tous les membres ayant le Required Role global configuré dans Discord Authentication.

Pour plus de détails sur le système de rôles, voir Rôles et permissions.

Exemples de configuration

Analytics

{
  "collectIntervalMinutes": 5,
  "retentionDays": 90,
  "defaultSchedule": {
    "days": ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"],
    "startHour": 14,
    "endHour": 2
  }
}

Alerting

{
  "enabled": true,
  "webhookUrl": "https://discord.com/api/webhooks/...",
  "rules": [
    {
      "name": "Nouveau joueur",
      "measurement": "connect",
      "condition": "contains",
      "value": "joined",
      "cooldownMinutes": 5
    }
  ]
}

Player Steam

{
  "apiKey": "votre-clé-steam-api",
  "cacheMinutes": 60,
  "fetchAvatars": true
}

Certains champs peuvent être gérés automatiquement par QuantumLogs selon votre plan. Dans ce cas, ils apparaissent en lecture seule et ne sont pas modifiables.