Démarrage

Introduction

Tout ce qu'il faut savoir pour configurer et utiliser Orbis sur votre serveur Discord.

Orbis est un bot Discord tout-en-un : tickets d'assistance, modération avancée, logs unifiés, économie, système de niveaux, rôles automatiques, giveaways, et bien plus — le tout géré depuis un dashboard web, sans avoir besoin de taper la moindre commande.

🚀 Commencer

Pour ajouter Orbis à votre serveur :

1. Cliquez sur Ajouter Orbis depuis la page d'accueil.
2. Sélectionnez le serveur sur lequel vous êtes administrateur.
3. Accédez au Dashboard pour configurer chaque module.

🧭 Le Dashboard

Chaque fonctionnalité d'Orbis (tickets, modération, économie, rôles...) se configure entièrement depuis le dashboard web — aucune commande slash n'est nécessaire pour l'administration du bot.

💬 Besoin d'aide ?

Rejoignez notre serveur de support si vous avez une question ou rencontrez un problème.

Démarrage

Variables

Comment insérer des informations dynamiques (membre, serveur...) dans vos messages Orbis

Lorsque vous personnalisez vos messages dans Orbis (bienvenue, au revoir, embeds, réponses automatiques, messages programmés...), vous pouvez utiliser des variables qui seront automatiquement remplacées par la vraie valeur au moment de l'envoi.

👤 Variables de membre

Utilisables partout où un membre est concerné (messages de bienvenue, au revoir, boost...) :

Mentionne directement le membre (ex : @Pseudo).

Affiche uniquement le pseudo du membre, sans le mentionner.

Exemple :

🏠 Variables de serveur

Le nom du serveur.

Le nombre total de membres du serveur.

@ Mentions Discord

Pour mentionner un rôle ou un salon précis (et non une variable dynamique), utilisez la syntaxe native de Discord directement dans vos messages :

Remplacez ROLE_ID par l'identifiant du rôle (clic droit sur le rôle → Copier l'ID, le mode développeur doit être activé dans Discord).

Remplacez CHANNEL_ID par l'identifiant du salon.

✓ Résumé

• {user} / {username} — informations sur le membre
• {server} / {membercount} — informations sur le serveur
• <@&ROLE_ID> / <#CHANNEL_ID> — mentions natives Discord

Tickets

🎫 Créer un panneau

Déployez le message qui permet à vos membres d'ouvrir un ticket d'assistance en un clic.

🧭 Fonctionnement général

Le système de tickets d'Orbis repose sur deux éléments : un ou plusieurs types de tickets (voir Catégories) qui définissent où et comment un ticket est créé, et un panneau — le message avec le bouton que vos membres cliquent pour en ouvrir un.

Vous devez configurer au moins un type de ticket avant de déployer un panneau, sinon le bouton renverra une erreur aux membres qui cliquent dessus.

🚀 Déployer le panneau

1. Ouvrez le Dashboard → Tickets → onglet Panneau.
2. Choisissez le salon dans lequel le panneau doit être envoyé.
3. Personnalisez (facultatif) le titre et la description de l'embed.
4. Cliquez sur Envoyer le panneau.

Un embed avec un bouton 🎫 Créer un ticket est alors publié dans le salon choisi.

🖱️ Ce qu'il se passe au clic

• S'il n'existe qu'un seul type de ticket, le salon privé est créé immédiatement.
• S'il existe plusieurs types, un menu déroulant s'affiche pour laisser le membre choisir le sujet de sa demande.
• Un membre ne peut avoir qu'un seul ticket ouvert à la fois — s'il en a déjà un, Orbis lui indique le salon existant au lieu d'en recréer un.

Le salon créé n'est visible que par le membre et le rôle support associé au type de ticket, avec un message de bienvenue et deux boutons : 🔒 Fermer le ticket et, en Premium, 🙋 Prendre en charge (permet à un membre du staff de s'assigner le ticket).

✨ Free vs Premium

• Free — 3 types de ticket actifs maximum.
• Premium — types de tickets illimités, bouton "Prendre en charge" pour le staff.

Tickets

📂 Catégories

Sur le dashboard, on parle de "types de tickets" — un type = un sujet de demande (support, partenariat, signalement...).

Créer plusieurs types permet de trier automatiquement les demandes : chaque type peut ouvrir ses salons dans une catégorie Discord différente, pinger un rôle support différent, et afficher un message de bienvenue adapté au sujet.

➕ Créer un type de ticket

Depuis Dashboard → Tickets → Types de tickets, renseignez :

• Nom — identifie le type dans le menu de sélection (doit être unique).
• Emoji — affiché à côté du nom (par défaut 🎫).
• Description — courte phrase d'aide affichée dans le menu.
• Catégorie Discord de destination — où le salon du ticket sera créé.
• Rôle support — le rôle qui aura accès au salon et sera notifié.
• Format du nom de salon — ex : ticket-{count}-{username}.
• Message de bienvenue — envoyé dans le salon à l'ouverture.
• Titre / couleur de l'embed et salon de logs dédié (facultatif).

🧩 Variables disponibles

Utilisables dans le format du nom de salon et le message de bienvenue :

Mentionne le membre qui a ouvert le ticket.

Le pseudo du membre, sans le mentionner.

Le numéro séquentiel du ticket (utile pour un nom de salon du type ticket-0004).

Le nom du serveur.

🗂️ Plusieurs types sur un seul panneau

Un seul panneau suffit : dès que plus d'un type de ticket existe, Orbis affiche automatiquement un menu déroulant listant tous les types au clic sur le bouton du panneau — inutile de créer un panneau par type.

🔐 Free vs Premium

Free : 3 types de ticket maximum. Premium : types illimités.

🗑️ Supprimer un type

Supprimer un type l'enlève simplement du menu de sélection pour les nouveaux tickets — les salons déjà ouverts sous ce type ne sont pas affectés et restent utilisables normalement.

Tickets

❓ Questions personnalisées

Récoltez les bonnes informations dès l'ouverture d'un ticket, pour que le staff n'ait pas à les redemander.

💬 Pré-qualifier une demande dès aujourd'hui

En attendant un formulaire dédié (voir plus bas), deux réglages permettent déjà de bien cadrer chaque demande :

• Créez un type de ticket par sujet (support technique, partenariat, signalement...) — voir Catégories. Chaque type peut avoir son propre rôle support, donc la bonne personne est notifiée directement.
• Personnalisez le message de bienvenue de chaque type pour lister exactement les informations attendues.

✅ Bonnes pratiques

Un message de bienvenue efficace ressemble à ceci :

Le membre répond directement dans le salon du ticket, comme dans une conversation classique.

🔜 Bientôt disponible

Un véritable formulaire (questions à remplir dans une fenêtre dédiée avant même la création du salon) est en cours de développement. Il permettra d'exiger des réponses obligatoires avant l'ouverture du ticket. Cette page sera mise à jour dès sa sortie.

Modération

🛡️ Sanctions & Logs

Avertissements, mutes, kicks, bans — avec un historique complet et des logs automatiques.

⚔️ Commandes de modération

Directement utilisables depuis Discord (nécessitent la permission correspondante) :

Le paramètre duree est facultatif (ex : 1d, 7j) — laissé vide, le ban est permanent.

Mise en sourdine native Discord (timeout), durée maximum 28 jours.

Affiche l'historique des 15 dernières sanctions du membre (type, date, modérateur, raison).

🖥️ Actions depuis le dashboard

• Avertissements — ajoutez ou retirez un avertissement à un membre ; il en est informé par message privé.
• Clear / Purge — supprime jusqu'à 500 messages d'un salon, avec filtre facultatif sur un membre précis.
• Verrouiller / Déverrouiller un salon — bloque ou rétablit l'envoi de messages pour @everyone.
• Slowmode — définit un délai entre les messages (0 à 6h).

🧾 Salon de logs

Configurez un salon de logs dans Dashboard → Général. Une fois défini, chaque action de modération — qu'elle vienne d'une commande Discord ou du dashboard — y publie automatiquement un embed détaillant la cible, le modérateur et la raison.

Modération

🧹 AutoMod

Deux niveaux de protection cumulables : le moteur de protection Orbis et les règles AutoMod natives de Discord.

🛡️ Protection Orbis

Un système de détection interne, actif dès qu'il est activé dans Dashboard → Modération → Protection, qui sanctionne automatiquement (mute temporaire via un rôle "Muted" créé et configuré automatiquement sur tous les salons) — les administrateurs en sont toujours exemptés :

• Anti-spam — trop de messages en peu de temps (par défaut 5 messages / 3s) déclenche un mute.
• Anti-mention — trop de mentions dans un seul message (par défaut 5, un @everyone/@here comptant pour 5) supprime le message et mute l'auteur.
• Anti-raid — trop d'arrivées en peu de temps (par défaut 10 en 10s) expulse automatiquement les nouveaux membres suspects.
• Anti-nuke — trop de suppressions de salons/rôles par un même membre en 30s (par défaut 3) le mute automatiquement.

Les seuils et la durée de mute sont personnalisables depuis le dashboard. Toutes les actions sont journalisées dans le salon de logs configuré (ou, à défaut, un salon dont le nom contient "log", "audit" ou "mod").

🤖 Règles AutoMod natives Discord

Depuis Dashboard → Modération → AutoMod, activez individuellement des règles gérées nativement par Discord (badge "Uses AutoMod" sur le serveur) :

• Filtres Discord — grossièretés, contenu sexuel, insultes (presets natifs Discord).
• Anti-Invitations — bloque les liens d'invitation Discord (discord.gg/...).
• Anti-Arnaque — bloque les messages d'arnaque courants ("nitro gratuit", etc.).
• Anti-IP Grabber — bloque les liens connus pour voler des adresses IP (grabify, iplogger...).
• Anti-Spam Mentions — bloque nativement les messages dépassant un nombre de mentions.

🚫 Mots interdits personnalisés

Ajoutez votre propre liste de mots à bloquer (jusqu'à 1000) depuis le dashboard — elle est synchronisée automatiquement avec une règle AutoMod native dès que l'AutoMod est activé.

⚠️ Limites à connaître

Discord n'autorise qu'une seule règle par type (filtres par mots-clés, spam de mentions...) par serveur. Si une règle du même type existe déjà (créée manuellement ou par un autre bot), Orbis la réutilise au lieu d'en créer une nouvelle, pour éviter tout conflit.

Rôles

🎭 Auto Role

Attribue automatiquement un ou plusieurs rôles dès qu'un membre (ou un bot) rejoint le serveur.

⚙️ Configuration

Depuis Dashboard → Rôles → Auto Role, ajoutez un ou plusieurs rôles à distribuer automatiquement, en choisissant pour chacun à qui il s'applique :

• Tous — humains et bots.
• Humains uniquement.
• Bots uniquement.

🔄 Fonctionnement

Dès qu'un membre arrive sur le serveur, Orbis lui attribue chaque rôle configuré correspondant à son type (humain/bot). Si un rôle ne peut pas être attribué (permissions insuffisantes, rôle supprimé...), l'erreur est ignorée silencieusement pour ne pas bloquer l'arrivée du membre.

💡 Cas d'usage

• Un rôle "Membre" donné à tous les humains pour débloquer l'accès au serveur.
• Un rôle "Bot" distinct pour garder vos salons de bots bien identifiés.
• Combiné à un salon de vérification ou à un panneau de rôles de réaction pour construire un parcours d'arrivée complet.

🛠️ Astuce hiérarchie

Le rôle d'Orbis doit être positionné au-dessus des rôles que vous souhaitez attribuer automatiquement dans les paramètres du serveur, sinon l'attribution échouera silencieusement.

Rôles

🙂 Rôles de réaction

Laissez vos membres s'attribuer un rôle eux-mêmes, en cliquant sur un bouton ou en choisissant dans un menu.

➕ Créer un panneau de rôles

Depuis Dashboard → Rôles → Rôles de réaction :

1. Choisissez le salon de destination.
2. Renseignez un titre et une description.
3. Choisissez le mode d'affichage : boutons ou menu déroulant.
4. Ajoutez les rôles proposés, chacun avec un libellé et un émoji facultatif.

🔘 Boutons vs 📋 Menu déroulant

• Boutons — idéal pour une courte liste de rôles (jusqu'à 5 par ligne, 25 au total), très visuel.
• Menu déroulant — idéal pour proposer de nombreux rôles sans surcharger le message.

🔁 Comportement au clic

Cliquer sur un bouton ou sélectionner un rôle dans le menu fonctionne comme un interrupteur : si le membre n'a pas encore le rôle, il lui est donné ; s'il l'a déjà, il lui est retiré. Une confirmation discrète (visible uniquement par le membre) s'affiche à chaque action.

🔐 Free vs Premium

Free : 2 panneaux de rôles-réaction maximum par serveur. Premium : panneaux illimités.

Économie & Niveaux

💰 Système d'économie

Une monnaie virtuelle propre à votre serveur, alimentée par l'activité de vos membres.

💸 Comment les membres gagnent des pièces

Chaque fois qu'un membre passe un niveau (voir Niveaux), il reçoit automatiquement 50 pièces. C'est aujourd'hui la principale source de revenus passive du système.

🛠️ Gestion depuis le dashboard

Le staff peut créditer ou débiter manuellement le solde de n'importe quel membre depuis Dashboard → Économie (le solde ne descend jamais sous 0).

🏆 Classement

Le dashboard affiche automatiquement un top 20 des membres les plus riches du serveur, trié par solde décroissant.

🔜 Boutique (à venir)

Une boutique permettant aux membres d'échanger leurs pièces contre des rôles personnalisés est en préparation et viendra compléter le système d'économie. Cette page sera mise à jour à sa sortie.

Économie & Niveaux

📈 Niveaux

Un système d'XP basé sur l'activité des messages, avec des annonces de passage de niveau personnalisables.

⚡ Gain d'XP

Chaque message envoyé sur le serveur rapporte un montant aléatoire d'XP (par défaut entre 15 et 25), avec un délai anti-abus entre deux gains (par défaut 60 secondes). Ces valeurs sont réglables depuis Dashboard → Niveaux.

📐 Formule de progression

L'XP nécessaire pour passer au niveau suivant augmente progressivement :

Par exemple, il faut 100 XP pour passer du niveau 0 au niveau 1, puis 155 XP pour passer au niveau 2.

📣 Annonce de passage de niveau

Personnalisez le message annoncé (variables {user} et {level}) ainsi que le salon où il est publié — par défaut, il est envoyé dans le salon où le membre vient d'écrire.

🎁 Récompense automatique

Chaque passage de niveau crédite automatiquement 50 pièces dans le solde du membre — voir Système d'économie.

🏆 Classement

Le dashboard affiche un top 20 des membres les plus expérimentés, trié par niveau puis par XP.

Plus de fonctionnalités

💡 Suggestions

Un canal officiel pour que votre communauté propose des idées, et que le staff y réponde directement.

📋 Déployer le panneau

Depuis Dashboard → Suggestions, choisissez un salon et personnalisez (facultatif) le titre et la description. Un embed avec un bouton 💡 Faire une suggestion est publié dans le salon.

✍️ Soumission

Au clic, une fenêtre s'ouvre pour que le membre rédige sa suggestion (jusqu'à 1000 caractères). Elle est ensuite enregistrée avec le statut en attente.

🗂️ Gestion depuis le dashboard

Le staff retrouve les 30 dernières suggestions du serveur (avec pseudo et avatar de l'auteur) et peut :

• Marquer une suggestion comme traitée.
• Répondre — la réponse est envoyée en message privé à l'auteur et sauvegardée.
• Supprimer une suggestion.

Plus de fonctionnalités

🎁 Giveaways

Organisez des concours sur votre serveur avec tirage au sort automatique.

🎉 Créer un giveaway

Depuis Dashboard → Giveaways, renseignez :

• Le salon où publier le giveaway.
• Le lot à gagner.
• La durée (ex : 1h, 7d).
• Le nombre de gagnants.

Un embed avec un bouton 🎉 Participer et un compte à rebours est publié.

🖱️ Participation

Les membres cliquent sur le bouton pour s'inscrire — une seule participation par membre.

🏁 Fin du giveaway

Le tirage a lieu automatiquement à la fin du minuteur, ou peut être forcé plus tôt depuis le dashboard. Le(s) gagnant(s) sont annoncés dans le salon.

🔁 Retirer un gagnant (reroll)

Depuis le dashboard, relancez un tirage parmi les participants existants pour désigner un nouveau gagnant — utile si le premier ne réclame pas son lot.

Plus de fonctionnalités

📨 Invitations

Suivez qui invite qui, pour récompenser vos membres les plus actifs côté recrutement.

🔍 Suivi automatique

Orbis surveille la création et la suppression des invitations du serveur. Quand un nouveau membre rejoint via un lien d'invitation, le crédit est automatiquement ajouté au compteur de la personne qui a créé ce lien.

🏆 Classement

Le dashboard affiche un top 20 des membres ayant le plus invité, trié par nombre d'invitations.

🔎 Consulter un membre

Depuis le dashboard, consultez le nombre d'invitations réussies d'un membre précis — pratique pour animer un système de récompenses ou de rôles de recrutement.

Plus de fonctionnalités

⚙️ Commandes personnalisées

Créez vos propres commandes textuelles avec une réponse sur mesure.

➕ Créer une commande

Depuis Dashboard → Commandes personnalisées, renseignez un nom et une réponse. Le nom est automatiquement nettoyé (minuscules, espaces remplacés par des tirets) et doit être unique sur le serveur.

⌨️ Utilisation

La commande se déclenche avec le préfixe du serveur (par défaut !, modifiable dans Dashboard → Général) :

🧩 Variable disponible

Remplacé par la mention du membre qui a utilisé la commande.

🔐 Fonctionnalité Premium

Les commandes personnalisées sont réservées aux serveurs Premium. Sans abonnement, le dashboard affiche un message d'erreur avec un lien pour passer Premium.