> For the complete documentation index, see [llms.txt](https://nocturiassh.gitbook.io/docu-nocturiassh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nocturiassh.gitbook.io/docu-nocturiassh/kuroo-nocturius/documentation-kuroo-nocturius.md).

# Documentation - Kuroo/Nocturius

## 📖 Kuroo — Documentation

> ⚠️ **Note importante :** La documentation est en cours d'écriture. Toutes les informations ne sont pas encore disponibles ou complètes. Veuillez vous référer à la commande `/help` sur Discord pour obtenir la liste actualisée des commandes disponibles.

Bienvenue dans la documentation complète de Kuroo (également appelé Snowbell), le bot Discord polyvalent de la communauté Subasa et ses partenaires.

Cette documentation vous guide à travers toutes les fonctionnalités disponibles.

{% hint style="warning" %}
Les Fonctions IA ont étais retirer pour tout les utilisateurs de KUROO, Nocturius et Nocturia garde la fonction IA
{% endhint %}

***

### 🔌 Modes d'interaction

Le bot propose plusieurs types d'interactions :

* **Commandes slash** : `/commande` — le mode moderne par défaut.
* **Menus contextuels** : Clic droit sur un message ou un membre.
* **Commandes préfixées** : `!commande` — le mode classique.

> 💡 **Astuce** : Utilisez la commande `/help` sur Discord pour obtenir la **liste actualisée** des commandes disponibles sur votre serveur.

***

### 🗺️ Sommaire

1. Commande `/help`
2. Catégories de commandes (Commandes Slash)
3. Menus contextuels (clic droit)
4. IA (mention du bot)
5. Index rapide des commandes
6. Disponibilité des commandes

***

## 📑 Commande `/help`

La commande `/help` affiche l'aide dynamique de Snowbell dans un embed. Elle est automatiquement générée à partir des commandes **réellement chargées** sur le serveur.

#### Fonctionnalités de l'aide

| Élément affiché       | Description                                                                                    |
| --------------------- | ---------------------------------------------------------------------------------------------- |
| **Slash**             | Chaque commande `/…` apparaît avec ses sous-commandes (ex. `dossier consulter`).               |
| **Menus contextuels** | Actions accessibles via le clic droit sur un message ou un membre                              |
| **Préfixe**           | Commandes `!nom` (les alias sont indiqués). Aucun doublon si la commande existe déjà en slash. |

#### Pagination

Si la liste est longue, utilisez les boutons **Précédent** / **Suivant**. Seul l'utilisateur ayant invoqué `/help` peut utiliser ces boutons.

#### Ordre d'affichage des catégories

Les commandes sont organisées par thème dans l'ordre suivant :

1. Modération (sanctions, tickets, prévention)
2. Divertissement (fun, réactions, animations)
3. Anime & listes (anime, animes, listes)
4. Jeux (mini-jeux, jeux gratuits)
5. Steam (informations Steam, souvent en préfixe)
6. Traduction (`/traduire`, listes de langues)
7. IA (comportement par mention)
8. Outils (utilitaires divers)
9. Statistiques (messages, vocal, classements)
10. Messages privés (MP liés aux commandes)
11. Vocal & musique (file d'attente, lecture)
12. Logs serveur (`/logs …`)
13. Succès (`/succes …`)
14. Panel Snowbell (configuration, synchronisation)
15. Aide (`/help`)
16. Système (synchro slash, tâches techniques)

***

### 🛠️ Commandes Slash

Les commandes slash sont la méthode principale d'interaction. Elles commencent par `/` et s'affichent automatiquement dans l'interface Discord.

#### 🔐 Permissions requises

* **Modération & Gestion** : "Gérer les membres" (pour les actions sur les utilisateurs).
* **Logs serveur** : "Voir les logs de serveur".
* **Panel Snowbell** : "Administrateur" ou permissions personnalisées.
* **Vocal & Musique** : "Se connecter au vocal" et "Parler".
* **Jeux & Divertissement** : Aucune permission spéciale requise.

> 💡 **Astuce :** Pour les commandes avec sous-commandes (ex. `/logs setup`), cliquez d'abord sur la commande, puis sélectionnez la sous-commande dans le menu déroulant qui s'affiche.

#### ⚙️ Panel Kuroo & Système

**Panneau de configuration système**

| Commande | Description                                                                                 |
| -------- | ------------------------------------------------------------------------------------------- |
| `/panel` | Ouvre le panneau de configuration principal avec les options générales du système Snowbell. |

**Synchronisation automatique**

| Commande     | Description                                                                                                             |
| ------------ | ----------------------------------------------------------------------------------------------------------------------- |
| `/sync_data` | Force la synchronisation et met à jour les données d'auto-modération, de succès et de statistiques depuis les serveurs. |

**Aide**

| Commande | Description                                                                                                                                         |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/help`  | Génère automatiquement l'aide à partir des commandes chargées — la seule référence fiable. *Disponible sur tous les serveurs car elle est système.* |

#### 🛡️ Modération & Gestion

**Analyse de message**

| Commande   | Description                                                                                                   |
| ---------- | ------------------------------------------------------------------------------------------------------------- |
| `/analyze` | Analyse le texte d'un message pour détecter les anomalies, problèmes de langage ou comportements inhabituels. |

**Configuration du salon de logs**

| Commande           | Description                                                                                                       |
| ------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `/mod_log_channel` | Configure le canal de texte qui recevra les logs des actions de modération (bannissements, avertissements, etc.). |

**Gestion des mutes**

| Commande       | Description                                   |
| -------------- | --------------------------------------------- |
| `/mute`        | Mute un membre sur le serveur (salons texte). |
| `/voicemute`   | Mute un membre en vocal.                      |
| `/voiceunmute` | Démute un membre en vocal.                    |

**Gestion des avertissements**

| Commande         | Description                                                                                  |
| ---------------- | -------------------------------------------------------------------------------------------- |
| `/warn`          | Donne un avertissement à un membre (le cumul peut déclencher des sanctions automatiquement). |
| `/warnings`      | Vérifie le nombre d'avertissements d'un membre.                                              |
| `/clearwarnings` | Supprime tous les avertissements d'un membre.                                                |

**Nettoyage de messages**

| Commande   | Description                                                                                          |
| ---------- | ---------------------------------------------------------------------------------------------------- |
| `/cleanup` | Supprime les derniers messages d'un salon et envoie un récapitulatif (transcript) par message privé. |

**Informations sur un ID**

| Commande  | Description                                                                                        |
| --------- | -------------------------------------------------------------------------------------------------- |
| `/lookup` | Récupère les informations sur un utilisateur, un serveur ou un message à partir de son ID Discord. |

**Mode lent**

| Commande    | Description                                                                   |
| ----------- | ----------------------------------------------------------------------------- |
| `/slowmode` | Active le mode lent (ex. 5s, 30s, 1m) pour limiter la fréquence des messages. |

**Verrouillage de salon**

| Commande  | Description                                                                                                       |
| --------- | ----------------------------------------------------------------------------------------------------------------- |
| `/lock`   | Verrouille un salon : les membres ne peuvent plus envoyer de messages (les Admins/Modos peuvent toujours parler). |
| `/unlock` | Déverrouille un salon verrouillé.                                                                                 |

**Gestion des tickets (Support)**

| Commande        | Description                                              |
| --------------- | -------------------------------------------------------- |
| `/ticketpanel`  | Crée un panneau pour ouvrir des tickets de support.      |
| `/ticketroles`  | Configure les rôles qui peuvent accéder aux tickets.     |
| `/ticketmanage` | Gère les tickets existants (fermeture, transfert, etc.). |

**Configuration de prévention (Anti-Spam)**

| Commande               | Description                                                     |
| ---------------------- | --------------------------------------------------------------- |
| `/violations`          | Affiche les violations détectées par le système anti-spam.      |
| `/prevention_config`   | Configure les seuils de détection pour les nouvelles commandes. |
| `/prevention_approval` | Approuve ou rejette une action préventive.                      |
| `/prevention_channel`  | Définit le salon où les alertes de prévention sont envoyées.    |

**Contrôles de sécurité**

| Commande     | Description                                                 |
| ------------ | ----------------------------------------------------------- |
| `/bancheck`  | Vérifie si un membre est banni ou a été banni précédemment. |
| `/urlcheck`  | Vérifie les urls partagées par un utilisateur.              |
| `/underlink` | Détecte les liens cachés ou malveillants.                   |

***

#### 📊 Logs Serveur

Système de suivi complet de toutes les actions effectuées sur le serveur via la racine `/logs`.

| Sous-commande      | Description                                                                                     |
| ------------------ | ----------------------------------------------------------------------------------------------- |
| `/logs setup`      | Sélectionne le salon de texte qui recevra les logs (messages supprimés, modifications...).      |
| `/logs toggle`     | Active ou désactive globalement le système de logging pour le serveur.                          |
| `/logs categories` | Affiche la liste des catégories de logs disponibles (messages, voice, bans, kicks...).          |
| `/logs category`   | Active ou désactive une catégorie spécifique (ex. "messages", "voice", "bans").                 |
| `/logs ignore`     | Configure un salon pour qu'aucun log n'y soit enregistré.                                       |
| `/logs status`     | Vérifie si les logs sont activés et affiche le salon configuré.                                 |
| `/logs history`    | Affiche tous les logs connus concernant un membre spécifique (warnings, messages supprimés...). |
| `/logs settings`   | Configure la durée de rétention des logs et les préférences de notifications.                   |

***

#### 📂 Dossiers / Tower

Système de stockage de contenu structuré assorti d'un mode compétitif « Tower ».

| Sous-commande          | Description                                                                                   |
| ---------------------- | --------------------------------------------------------------------------------------------- |
| `/dossier consulter`   | Affiche les détails d'un dossier spécifique (titre, créateur, date de création).              |
| `/dossier tower`       | Active le mode Tower qui affiche les dossiers sous forme de tour avec classements dynamiques. |
| `/dossier classement`  | Affiche le classement des dossiers selon leur nombre de consultations.                        |
| `/dossier ajouter`     | Crée un nouveau dossier en spécifiant le titre et le contenu à y stocker.                     |
| `/dossier contenu`     | Affiche directement le contenu stocké dans un dossier spécifique.                             |
| `/dossier telecharger` | Génère un fichier téléchargeable contenant tout le contenu du dossier.                        |

***

#### 🌌 Cosmos

Système permettant de créer, gérer et partager des galeries d'images (Cosmos).

| Sous-commande    | Description                                                               |
| ---------------- | ------------------------------------------------------------------------- |
| `/cosmos status` | Vérifie l'état de votre cosmos actif (nombre d'images, date de création). |
| `/cosmos creer`  | Crée un nouveau cosmos vide à remplir avec des images.                    |
| `/cosmos lister` | Affiche la liste de tous vos cosmos créés avec leur nom et statut.        |
| `/cosmos voir`   | Affiche toutes les images stockées dans un cosmos spécifique.             |

***

#### 🔍 Surveillance

Outils de sécurité pour surveiller l'activité des comptes et bloquer les raids.

| Sous-commande                   | Description                                                                     |
| ------------------------------- | ------------------------------------------------------------------------------- |
| `/surveillance check`           | Lance un scan de sécurité pour détecter les comptes suspects ou les violations. |
| `/surveillance comptes-recents` | Affiche les comptes créés durant les dernières heures (outil anti-raid).        |
| `/surveillance activite`        | Affiche l'activité récente : connexions, déconnexions, modifications.           |
| `/surveillance rapport`         | Génère un rapport PDF complet contenant toutes les données de surveillance.     |

***

#### 🤬 Anti-insultes

Protection et détection automatique des insultes sur le serveur.

| Commande                 | Description                                                                                  |
| ------------------------ | -------------------------------------------------------------------------------------------- |
| `/anti_insultes loginfo` | Affiche les détails des logs anti-insultes : date, auteur, message, type d'insulte détectée. |

***

#### 📨 Invitations

Système de suivi des invitations pour analyser la croissance de votre serveur.

| Commande                 | Description                                                                                         |
| ------------------------ | --------------------------------------------------------------------------------------------------- |
| `/invitation classement` | Affiche le classement des membres par nombre d'invitations réussies.                                |
| `/invitation stats`      | Affiche les statistiques globales : nombre total d'invitations, taux de conversion, invités actifs. |

***

#### 📊 Statistiques & Classements

Outils de suivi pour récompenser l'activité textuelle et vocale des membres.

| Commande        | Description                                                                      |
| --------------- | -------------------------------------------------------------------------------- |
| `/messages`     | Affiche vos statistiques de messages : total envoyés, moyenne par jour.          |
| `/rankmessages` | Affiche votre rang dans le classement des membres les plus productifs par écrit. |
| `/vocal`        | Affiche votre temps total passé en vocal (heures, minutes).                      |
| `/rankvocal`    | Affiche votre rang dans le classement des membres les plus actifs en vocal.      |

***

#### 🎬 Anime & Listes

Outils pour rechercher des œuvres japonaises et gérer ses listes de visionnage personnelles.

**Recherche générale**

| Commande  | Description                                                                      |
| --------- | -------------------------------------------------------------------------------- |
| `/anime`  | Recherche un anime par titre et affiche ses détails (synopsis, épisodes, notes). |
| `/animes` | Variante de recherche pour trouver des séries animées.                           |

**Gestion de liste personnelle (`/animelist`)**

| Sous-commande        | Description                                          |
| -------------------- | ---------------------------------------------------- |
| `/animelist ajouter` | Ajoute un anime à votre liste personnelle.           |
| `/animelist noter`   | Attribue une note à un anime de votre liste.         |
| `/animelist fiche`   | Affiche la fiche complète d'un anime de votre liste. |
| `/animelist apercu`  | Affiche un aperçu rapide de votre liste globale.     |
| `/animelist retirer` | Retire un anime de votre liste.                      |

***

#### 🌐 Traduction

| Commande    | Description                                                                               |
| ----------- | ----------------------------------------------------------------------------------------- |
| `/traduire` | Traduit le texte d'une langue vers le français (ex. : `/traduire de:anglais text:Hello`). |
| `/langues`  | Affiche la liste complète des langues supportées avec leurs codes.                        |

***

#### 🎮 Jeux gratuits & Annonces

Suivi automatique des offres de jeux gratuits via la plateforme GamerPower.

| Commande                         | Description                                                                              |
| -------------------------------- | ---------------------------------------------------------------------------------------- |
| `/jeux_gratuits`                 | Affiche la liste des jeux actuellement gratuits disponibles sur GamerPower.              |
| `/jeux_gratuits_annonce`         | Envoie manuellement une notification dans le salon configuré pour une nouvelle offre.    |
| `/creer_webhook_jeux_gratuits`   | Crée un webhook qui envoie automatiquement chaque nouvelle offre dans le salon spécifié. |
| `/retirer_webhook_jeux_gratuits` | Supprime un webhook existant pour arrêter les notifications automatiques.                |
| `/liste_webhooks_jeux_gratuits`  | Affiche la liste de tous les webhooks de notifications actuellement activés.             |

***

#### 🚂 Steam

Consultez les informations de la plateforme Steam. *Ces commandes sont très souvent utilisées via leur préfixe textuel (`!`).*

| Commande         | Description                                                                                         |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| `!steamdb`       | Recherche un jeu Steam et affiche ses informations (prix, notes, développeur).                      |
| `!steamdb_price` | Affiche l'historique complet des prix et les promotions passées d'un jeu.                           |
| `!steamdb_info`  | Affiche les informations techniques complètes (configuration système, graphismes, taille, langues). |

***

#### 💍 Mariage & Famille

Créez des liens affectifs et bâtissez un arbre généalogique au sein de votre communauté.

**Système de mariage (`/mariage`)**

| Sous-commande       | Description                                                    |
| ------------------- | -------------------------------------------------------------- |
| `/mariage proposer` | Fait une demande en mariage officielle à un membre du serveur. |
| `/mariage divorcer` | Met fin au mariage actuel avec votre conjoint.                 |
| `/mariage conjoint` | Affiche les informations détaillées sur votre conjoint.        |

**Système d'adoption (`/adoption`)**

| Sous-commande          | Description                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------ |
| `/adoption adopter`    | Adopte un membre du serveur comme enfant.                                            |
| `/adoption désadopter` | Met fin à l'adoption d'un enfant.                                                    |
| `/adoption famille`    | Affiche vos relations familiales globales (parents, enfants, frères/sœurs adoptifs). |

*Note : Les fonctionnalités liées à l'**Arbre généalogique** complet et aux **Statistiques de mariage** du serveur s'organisent également dans ce module.*

***

#### 🎲 Fun

* **Calculateur de love** : Calcule la compatibilité amoureuse entre deux personnes. *Note : selon la configuration, elle s'utilise en slash ou via les préfixes classiques `!love` / `!lovecalc`.*

***

#### 🎵 Vocal & Musique

Utilisez le bot comme un lecteur musical complet dans vos salons vocaux.

* **Rejoindre / Quitter** : Commandes pour faire entrer ou sortir le bot du salon vocal.
* **Gestion des pistes** : Commandes pour lire un morceau (via nom ou URL), lire un fichier audio local ou afficher la file d'attente (playlist).
* **Contrôle** : Arrêter complètement la lecture et vider la file d'attente.

***

#### 🏆 Succès

Système d'achievements pour récompenser la fidélité et l'activité des membres via la racine `/succes`.

| Sous-commande / Fonction         | Description                                                                          |
| -------------------------------- | ------------------------------------------------------------------------------------ |
| `/succes voir` / `/succes liste` | Affiche les succès que vous avez obtenus ainsi que votre progression.                |
| `/succes catalogue`              | Permet de parcourir l'ensemble des succès disponibles sur le serveur.                |
| `/succes donner`                 | Permet (aux modérateurs/administrateurs) de donner un succès spécifique à un membre. |
| `/succes annonces`               | Active ou désactive les notifications globales lors de l'obtention d'un succès.      |
| `/succes attribuer_roles`        | Gère l'attribution automatique de rôles Discord selon les succès déverrouillés.      |

***

### 🖱️ Menus Contextuels (Clic droit)

Ces actions rapides ne nécessitent pas l'écriture d'une commande textuelle, elles s'activent via le menu de contexte de Discord.

#### 👤 Sur un utilisateur

* Messages envoyés
* Temps passé en vocal
* Signaler ce membre
* Voir les warnings
* Envoyer un message privé (dépend de la configuration générale du bot)

#### 💬 Sur un message

* Traduire en français
* Signaler un bug

***

### 🔍 Index rapide des commandes

Voici la liste brute de l'ensemble des commandes slash et sous-commandes intégrées au bot :

`analyze` · `anti_insultes loginfo` · `arbre` · `adoption adopter` · `adoption désadopter` · `adoption famille` · `animelist ajouter` · `animelist apercu` · `animelist fiche` · `animelist noter` · `animelist retirer` · `anime` · `animes` · `bancheck` · `cleanup` · `cosmos creer` · `cosmos lister` · `cosmos status` · `cosmos voir` · `creer_webhook_jeux_gratuits` · `dossier ajouter` · `dossier classement` · `dossier consulter` · `dossier contenu` · `dossier telecharger` · `dossier tower` · `help` · `invitation classement` · `invitation stats` · `jeux_gratuits` · `jeux_gratuits_annonce` · `langues` · `liste_webhooks_jeux_gratuits` · `lock` · `lookup` · `logs category` · `logs categories` · `logs history` · `logs ignore` · `logs settings` · `logs setup` · `logs status` · `logs toggle` · `mariage conjoint` · `mariage divorcer` · `mariage proposer` · `messages` · `mod_log_channel` · `mute` · `panel` · `play` · `playfile` · `politico aide` · `politico alliance` · `politico attaquer` · `politico classement` · `politico creer` · `politico pays` · `politico recolte` · `politico recruter` · `politico recherche` · `politico taxes` · `prevention_approval` · `prevention_channel` · `prevention_config` · `rankmessages` · `rankvocal` · `retirer_webhook_jeux_gratuits` · `slowmode` · `statsmariage` · `succes annonces` · `succes attribuer_roles` · `succes catalogue` · `succes donner` · `succes liste` · `succes voir` · `surveillance activite` · `surveillance check` · `surveillance comptes-recents` · `surveillance rapport` · `sync` · `sync_data` · `ticketmanage` · `ticketpanel` · `ticketroles` · `traduire` · `underlink` · `unlock` · `urlcheck` · `violations` · `vocal` · `voiceunmute` · `voicemute` · `warn` · `warnings` · `clearwarnings` · `join` · `leave` · `list` · `stop`

***

### 📢 Disponibilité des commandes

* **Permissions Discord** : L'affichage des commandes dépend des permissions de l'utilisateur ainsi que des choix de configuration effectués par l'équipe d'administration du serveur.
* **Modules optionnels** : Une commande peut être absente si son module lié n'est pas chargé sur l'instance active (ex : la commande `/topactivite` n'apparaîtrait que si son extension est activée).
* **Référence absolue** : Pour connaître avec exactitude les fonctionnalités utilisables sur votre salon, tapez systématiquement la commande **`/help`** sur Discord.

***

*Documentation statique — En cas d'écart ou de mise à jour, la commande `/help` en direct sur Discord fait toujours foi.*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://nocturiassh.gitbook.io/docu-nocturiassh/kuroo-nocturius/documentation-kuroo-nocturius.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.