Documentation

Kryon

Bot de protection et de vie de serveur. Français, configurable sur Discord (/config) et sur ce site. Ce guide est pour les administrateurs, puis pour l'équipe.

Première heure

1. Invite le bot avec les permissions administrateur (ou au minimum : bannir, expulser, modérer, gérer salons / rôles / messages, journal d'audit).
2. Sur le serveur, lance /permissions et corrige ce qui manque.
3. Lance /config. Lis chaque page : le texte dit ce que fait le réglage, pas seulement son nom.
4. Choisis un salon de journaux (page Journaux). Sans ça, tu ne vois pas les sanctions automatiques.
5. Optionnel : ouvre ce site, connecte Discord, et complète les listes (boutique, paliers de niveau, motifs de tickets, Twitch / YouTube).

Les protections (anti-nuke, anti-raid, anti-spam, anti-bot, alertes) arrivent allumées. Coupe seulement ce que tu n'utilises pas.

Panneau web

Adresse par défaut : https://kryon.duckdev.fr. Le bot et le site démarrent ensemble avec python main.py à la racine du projet. Ne lance pas web/server.py tout seul.

OAuth Discord

1. Portail Discord → ton application → OAuth2.
2. Redirect : https://kryon.duckdev.fr/callback
3. Colle le Client Secret dans le .env (DISCORD_CLIENT_SECRET).
4. Relance le bot.

Tous tes serveurs Discord apparaissent après connexion. Si tu es administrateur (ou que tu gères le serveur) et que Kryon n'y est pas, un bouton Ajouter Kryon ouvre l'invitation Discord, déjà ciblée sur ce serveur. Ensuite, Actualiser : le serveur passe dans « Déjà là ».

Le menu reste collé en bas : logo Kryon, icône du serveur (pour changer), les pages, ta photo. Les listes (panneaux de rôles, articles, récompenses de niveau, motifs, chaînes, questions de candidature) se règlent ici. Sur Discord tu postes ensuite /roles, /ticket, /verification.

Garde

Anti-nuke

Si quelqu'un enchaîne trop de bans, d'expulsions, de suppressions de rôles ou de salons en une minute, Kryon le sanctionne. Règle les seuils selon la taille de l'équipe : trop bas, un vrai modo pressé se fait coincer.

Anti-raid

Vague de comptes qui rejoignent en même temps, ou comptes trop jeunes. Sanction : expulsion, ban, ou verrouillage.

Anti-spam et auto-modération

Flood, mentions en masse, majuscules, répétitions, mots interdits. Les invitations Discord se gèrent à part (autorisation ou non). Le filtre de liens douteux vise les arnaques type faux Nitro, pas tes propres invitations.

Anti-bot

Un bot qui rejoint sans être dans la liste d'identifiants est expulsé ou banni. Colle les IDs des bots que tu installes toi-même.

Alertes

Préviens l'équipe sans sanctionner : compte trop jeune, arrivées groupées. Utile la nuit.

Modération

Chaque sanction demande une raison. Un identifiant de dossier (#12) est écrit dans le journal. Tu le retrouves avec /historique.

/sauvegarde copie la config Kryon plus les noms de rôles et de salons. /restaurer avec l'option structure recrée ce qui a disparu (noms, pas les messages).

Rôles, arrivées, vérification

Autorole à l'arrivée : un rôle unique, automatique, pour tout le monde (ou pour les bots). Ce n'est pas le panneau de couleurs / jeux / notifications.

Rôles au clic : tu crées un panneau sur le site, tu ajoutes des rôles, tu récupères l'identifiant, tu lances /roles dans le salon public. Le membre coche, décoche, Kryon ajoute ou retire.

Vérification : active le module, choisis le rôle donné, poste /verification dans un salon que les nouveaux voient. Mode bouton, ou petit calcul (captcha).

Message d'arrivée : variables {user} {mention} {guild} {count}.

Tickets

1. Catégorie + rôle staff dans /config.
2. Motifs (Aide, Signalement, Partenariat, ou les tiens) sur le site.
3. /ticket poste le menu.

À l'ouverture : salon privé. Un modo clique Prendre. À la fermeture : fichier texte de conversation envoyé dans le journal tickets, puis le salon est supprimé.

Niveaux, pièces, boutique

Les membres gagnent des points en écrivant (/niveau, /classement). Sur le site, associe un rôle à un palier : 5, 10, 20, ce que tu veux. Dès que le niveau est atteint, le rôle est donné. Sans ça, /niveau n'est qu'un chiffre.

Pièces : /quotidien (une fois par jour), /travailler (plus souvent), /solde, /payer. La boutique (/boutique) vend un rôle, l'accès à un salon, ou un tirage. Les articles se créent sur le site.

Concours, idées, sondages

/concours lance un tirage. Si personne n'a gagné ou si le gagnant est injoignable : /terminer clôture, /relancer tire quelqu'un d'autre (les anciens gagnants sont exclus).

/suggestion : votes Pour / Contre, boutons Accepter et Refuser pour l'équipe.

/sondage : sondage Discord natif. Choix séparés par |.

/candidature : formulaire (max 5 questions, réglées sur le site) envoyé dans le salon prévu.

Vocaux, rappels, annonces

Vocal temporaire : un salon hub. Y entrer crée un vocal au nom du membre, détruit dès qu'il est vide.

Rappels : /rappel 10m Le meeting commence. Liste /rappels, annulation /annuler-rappel.

Twitch / YouTube : ajoute les chaînes sur le site. YouTube = identifiant UCxxxx. Twitch = pseudo, et clés TWITCH_CLIENT_ID / TWITCH_CLIENT_SECRET dans le .env.

Premium

Les protections, la modération de base, les tickets, les arrivées, la vérification, les idées, les sondages, les niveaux et /config restent gratuits.

Les administrateurs du bot (IDs dans OWNER_IDS, ou le propriétaire de l'application Discord) créent des codes. Un code n'est pas lié à un serveur : n'importe quel admin de serveur peut l'activer. Si tu mets serveurs à 0, le même code marche sur tous les serveurs.

Sur le site, tu peux aussi coller le code en haut de la vue d'ensemble. Les pages Économie, Rôles au clic, Vocaux, Annonces, Candidatures et Rappels affichent un bandeau tant que le serveur n'est pas Premium.

Index des commandes

Si une commande n'apparaît pas : attends la synchro Discord, ou relance le bot. En cas de doute, /aide sur le serveur.