Documentation Velkra BOT

Guide d'utilisation pour les gérants de serveurs Discord. Pour le dashboard, connectez-vous via /dashboard.

🛡️ Bien configurer la modération — guide complet & FAQ

Démarrage rapide

  • Invitez Velkra BOT sur votre serveur Discord (invitation gratuite).
  • Connectez-vous au dashboard avec Discord.
  • Activez le plan Basique (gratuit) ou choisissez Standard/Premium, puis activez un slot sur le serveur à configurer.
  • Configurez les modules (bienvenue, tickets, règlement…). Champs optionnels : laissez vides pour ne pas les afficher.
  • Cliquez sur Déployer pour publier les panneaux sur Discord.

Slots & serveurs

  • Basique : 1 serveur configurable (gratuit).
  • Standard : 2 serveurs configurables (4,99 €/mois).
  • Premium : 5 serveurs configurables (9,99 €/mois).
  • Le bot peut être présent sur d'autres serveurs sans configuration active.
  • Slot supplémentaire : +1,99 €/mois.

Tickets & transcripts

  • Configurez la catégorie tickets, le rôle support, les rôles autorisés à fermer et le salon du panneau.
  • Salon logs & transcripts : les fermetures par le staff génèrent un fichier .txt.
  • Activez « Transcripts activés » dans les réglages tickets.

Règlement & rôle membre

  • Choisissez le salon du règlement et le rôle membre à attribuer.
  • Déployez le module Règlement : un bouton « J'accepte » apparaît.
  • Salon logs règlement (optionnel) : trace chaque validation.

Création de serveur (Premium)

  • Commande propriétaire : /create-discord sur un serveur avec slot actif.
  • Assistant pas à pas : rôles, salons, règlement et structure de base.
  • Idéal pour lancer un nouveau serveur sans tout configurer à la main.
  • Disponible avec le plan Premium (abonnement + activation du serveur).

Inactivité (Premium)

  • Activez « Expulsion inactivité » et définissez le nombre de jours (ex. 7).
  • Les membres sans message depuis X jours peuvent être expulsés.
  • Les administrateurs et le rôle exempté ne sont pas concernés.

Parrainages (Premium)

  • Configurez le salon du classement parrainage et déployez.
  • Un embed « Classement parrainage » se met à jour automatiquement.
  • Le dashboard affiche qui a parrainé qui (dernières invitations).
  • Commande staff : /invites — aperçu du classement.

Alertes live (Twitch / RSS)

  • Module Alertes live : ajoutez des flux RSS et des streamers Twitch depuis le dashboard.
  • Choisissez le salon de publication pour chaque source.
  • Style des alertes (couleur, pied de page) : réglable dans la même section.
  • Les alertes Twitch LIVE nécessitent TWITCH_CLIENT_ID/SECRET sur le serveur du bot.

Newsletter (Standard)

  • Module Newsletter : abonnement MP pour recevoir les annonces importantes.
  • Déployez le panneau (boutons S'abonner / Se désabonner) dans un salon public.
  • Liste des abonnés visible dans l'onglet Stats du dashboard.

Auto Voice (Standard)

  • Salon « Rejoindre pour créer » : un membre rejoint ce salon vocal pour obtenir sa propre voc temporaire.
  • Configure la catégorie des vocaux créés et le format du nom ({user}).
  • Le salon temporaire est supprimé quand il est vide.

Annonces planifiées (Standard)

  • Annonce ponctuelle : choisis date/heure (fuseau de ton navigateur) — publication unique.
  • Message récurrent : par salon, avec fuseau IANA au choix (ex. Europe/Paris).
  • Mode intervalle : toutes les X minutes (min. 5) ou heures.
  • Mode heures fixes : choisis les HH:MM auxquels le bot poste chaque jour.
  • Limites récurrents : Basique 0 · Standard 2 · Premium illimité.
  • Couleur embed réglable ; pas de panneau Discord à déployer.

Boutique vitrine (Standard)

  • Catalogues web cliquables : grille d'articles avec image, prix indicatif et lien externe.
  • Pas de paiement intégré — redirection vers ton site ou ta page de vente.
  • Déployez les panneaux Discord depuis l'onglet Boutique du dashboard.

Sondages

  • Activez le module Sondages et choisissez la couleur des embeds.
  • Créez un sondage depuis le dashboard (salon, durée, propositions).
  • Ou sur Discord : /sondage (admin) pour créer un vote.
  • Les membres votent par boutons ; les admins peuvent fermer le sondage.

Tirages au sort

  • Activez le module — réglages optionnels : couleur, bouton, emoji, mode participation.
  • Pas de salon à configurer : lancez un giveaway dans n'importe quel salon textuel.
  • Limites giveaways actifs : Basique 1 · Standard 20 · Premium illimité.
  • Staff : /giveaway start duree:2h lot:Nitro gagnants:1
  • /giveaway end — termine le giveaway du salon actuel.
  • /gend — liste les actifs et choisis lequel terminer (menu).
  • /giveaway reroll — remplace un gagnant.

Modération — par où commencer

  • Guide complet : /docs/moderation — glossaire (raid, lockdown, quarantaine), ordre de config, FAQ par module.
  • 1. Logs modération : salon staff dédié (#logs-modération) — active les événements utiles.
  • 2. Modération active : seuil warns (ex. 3), action auto timeout/ban, rôles immunisés.
  • 3. Auto-modération : un filtre à la fois (mots, liens, flood…) — teste avant d'en cumuler plusieurs.
  • 4. Anti-raid + vérification si serveur public ou en croissance.
  • 5. Premium : modération dashboard (onglet Modérer) + analytics (onglet Stats).
  • Dans le dashboard (Configurer → Sécurité), chaque module affiche un panneau « Guide & paramétrage recommandé ».
  • Hiérarchie Discord : le rôle du bot doit être au-dessus des membres qu'il sanctionne.

Logs modération (Standard)

  • Réglages → Configurer → Sécurité → Logs modération.
  • Salon logs + toggles (suppression, édition, join/leave, ban, kick).
  • Afficher le contenu des messages supprimés : utile pour les appeals, désactivable si RGPD.
  • Pas de déploiement panneau : actif dès la sauvegarde.

Modération active (Standard)

  • Commandes : /warn, /warns, /clearwarns, /timeout, /untimeout, /kick, /ban, /unban.
  • Strikes : à X warns, timeout ou ban automatique selon ta config.
  • Rôles immunisés (IDs) : exemptés des strikes auto, pas des commandes manuelles staff.
  • Chaque action crée une entrée dans les logs si le salon est configuré.

Auto-mod & anti-raid (Standard)

  • Auto-mod : mots, invitations Discord, caps, emojis, flood, pièces jointes, salons exemptés.
  • Staff et admins sont exemptés de l'auto-mod.
  • Anti-raid : âge minimum compte, rafale d'arrivées, lockdown, rôle quarantaine.
  • Vérification : bouton à l'arrivée — compatible anti-raid (quarantaine prioritaire).

Modération dashboard (Premium)

  • Active Modération active puis Modération dashboard.
  • Réglages → onglet Modérer : ID membre → historique warns/sanctions → warn/timeout/kick/ban.
  • Tes permissions Discord sont vérifiées (Modérer membres, Kick, Ban selon l'action).
  • Même journalisation que les commandes slash — source « Dashboard Velkra » dans les logs.

Suggestions (Standard)

  • Configurez le salon du panneau et les seuils de votes (retenue, alerte staff).
  • Déployez : un bouton « Proposer une idée » apparaît dans le salon.
  • Les suggestions peuvent utiliser un fil par idée ; votes 👍 / 👎 côté bot.

XP & niveaux (Premium)

  • Définissez l'XP par message, le cooldown anti-spam et l'XP vocal (optionnel).
  • Paliers niveau → rôle : une ligne par palier (niveau|ID_du_rôle).
  • Classement optionnel : configurez le salon et déployez l'embed placeholder.
  • Annonces de montée de niveau : activables avec salon dédié optionnel.

Avis communauté (Premium)

  • Configurez le salon du panneau et déployez — le bot transforme le message en hub type Google.
  • L'embed affiche : note moyenne, nombre total d'avis, répartition (combien de 5★, 4★…).
  • Jusqu'à 5 avis affichés en même temps dans l'embed — ◀ ▶ pour les pages suivantes.
  • Boutons 5★ (23), 4★ (12)… : clique une note pour filtrer les avis correspondants.
  • Bouton « Mon avis » : laisser ou modifier son avis (1 note par membre, modifiable).
  • Après déploiement, redémarrez le bot ou cliquez Déployer pour rafraîchir le panneau.

Analytics (Premium)

  • Active le module Analytics — données dans l'onglet Stats du dashboard.
  • Graphiques : évolution des membres, messages par jour, top salons, heatmap horaire.
  • Sync bot → dashboard environ toutes les 3 minutes.
  • Requiert un slot actif et le module activé dans les toggles.

Support

  • Support par email : [email protected] — pas de hotline 24h/24.
  • Discord Velkra Studio : lien dans le footer du site.
  • Bug ou question : décrivez le serveur, le module et le message d'erreur.

Velkra BOT — développé par Velkra Studio. Cette documentation est mise à jour au fil des nouvelles fonctionnalités.