BumpX › Documentation
Accueil

Documentation BumpX

Guide complet · Créé par Ilyox et Flana · Mise à jour : Mars 2026

Tout ce que vous devez savoir pour installer, configurer et utiliser BumpX — le bot Discord qui propulse votre serveur vers de nouveaux membres.

Introduction

BumpX est un bot Discord qui permet de référencer des serveurs dans un annuaire public et de les faire remonter via un système de bump. Le bump est encadré par un cooldown fixe de 2h30. Entièrement gratuit, sans abonnement, sans pub.

Communautaire

Une fois enregistré, tout le monde peut bumper votre serveur.

Cooldown fixe

2h30 entre deux bumps du même serveur, équitable pour tous.

Statistiques

Suivi détaillé des bumps et classement en temps réel.

Annuaire

Recherche par nom, tags, description avec filtres.

Bump Web

Bumper directement depuis le site, sans Discord.

Partenariats

Page dédiée aux partenariats sur la vitrine.

API publique

Accès REST libre aux données de l'annuaire.

Note : BumpX ne propose pas d'auto-bump externe. Les bumps doivent être initiés manuellement via la commande Discord ou le site web.

Installation

1

Ajouter le bot à votre serveur

Vous devez avoir la permission Gérer le serveur. Cliquez sur le lien ci-dessous :

URL d'invitation
https://discord.com/oauth2/authorize?client_id=1467891844494004274 &permissions=8&integration_type=0&scope=applications.commands+bot
2

Enregistrer votre serveur

Une fois le bot ajouté, un administrateur exécute la commande :

/register

Important : La commande /register est réservée aux membres avec la permission "Gérer le serveur".
3

Configurer la fiche serveur

Personnalisez votre fiche avec ces commandes admin :

/setbio— description affichée dans l'annuaire
/settags— tags de catégorie (gaming, anime, fr…)
/setstatus— activer / désactiver l'affichage
/setinvite— définir une invite Discord manuellement
Prêt ! Votre serveur peut maintenant être bumpé par toute la communauté et apparaît dans l'annuaire.

Commandes disponibles

Commandes admin serveur

CommandeDescriptionPermission
/registerEnregistrer le serveur dans l'annuaireAdmin
/setbioDéfinir la description affichée sur le siteAdmin
/settagsDéfinir les tags affichés sur le siteAdmin
/setstatusActiver / désactiver l'affichage du serveurAdmin
/setinviteDéfinir une invite Discord manuellementAdmin

Commandes accessibles à tous

CommandeDescriptionCooldown
/bumpBumper le serveur et le remonter dans l'annuaire2h30 / serveur
/bumpstatusVoir le cooldown actuel et les stats du serveurAucun

Fonctionnement

Système de bump

  1. Un serveur est enregistré avec /register (admin requis).
  2. N'importe quel membre peut exécuter /bump dans le serveur.
  3. Après un bump, un cooldown fixe de 2h30 s'applique au serveur entier.
  4. Les stats sont mises à jour : total bumps, derniers bumps, classement global.
  5. Le serveur remonte dans l'annuaire public, visible par tous.

Cooldown & équité

Le cooldown est global au serveur : peu importe qui bumpe, il faut attendre 2h30. Ce système garantit un classement équitable pour tous les serveurs.

Conseil : Créez un salon dédié au bump (#bump ou #publicité) avec un rappel du cooldown pour que vos membres s'organisent et ne ratent aucun bump.

Bump Web

BumpX permet aussi de bumper depuis le site web directement. Connectez-vous avec Discord sur bumpx.fr, puis bumper depuis la fiche de votre serveur — sans ouvrir Discord.

Maintenance & Annonces

Les admins BumpX peuvent déclencher un mode maintenance ou diffuser une annonce depuis le panneau admin. Ces deux systèmes supportent un scope de portée pour cibler précisément la vitrine ou le dashboard.

Portée (scope)

Chaque action admin dispose d'un sélecteur de portée avec trois options :

Scope
Site vitrine
Dashboard
vitrine
🚫 Affecté
✅ Accessible
dashboard
✅ Accessible
🚫 Affecté
both
🚫 Affecté
🚫 Affecté

Mode Maintenance

  • Active une page de maintenance à la place du contenu normal.
  • Les admins BumpX gardent toujours accès au dashboard, quel que soit le scope.
  • L'API /api/status reste toujours accessible pour que la vitrine puisse détecter l'état.
Scope vitrine : seule la vitrine affiche la maintenance — le dashboard reste pleinement fonctionnel( appart si un owner à séléctionner les 2 ). Idéal pour une mise à jour de la page d'accueil sans couper les utilisateurs connectés.

Bannière d'annonce

  • Affiche un bandeau en haut du site avec votre message.
  • Les visiteurs peuvent le fermer, il ne réapparaît pas jusqu'au prochain message différent.
  • Le scope contrôle si la bannière s'affiche sur la vitrine, le dashboard ou les deux.

API REST publique

BumpX expose une API REST publique. Tous les endpoints listés ci-dessous sont accessibles avec ou sans clé API, CORS activé.

Base URL : https://dashboard.bumpx.fr

Endpoints disponibles

GET /api/bumped?limit=60&offset=0 Serveurs bumpés, triés par bumps
GET /api/servers Tous les serveurs listés (sort, limit, offset, q, tag)
GET /api/stats Statistiques globales (serverCount, totalBumps, totalMembers)
GET /api/status État du système (maintenance, scope, annonce)
GET /api/partnerships Partenariats actifs NEW
GET /api/me Utilisateur connecté (session requise)
GET /s/:guild_id Page d'un serveur spécifique

Exemple de réponse — /api/bumped

JSON
[ { "guild_id": "123456789", "name": "Mon Serveur", "bio": "Description du serveur", "tags": "gaming,fr,chill", "icon_url": "https://cdn.discordapp.com/...", "member_count": 1200, "total_bumps": 47, "next_bump_ts": 1706965200 // timestamp Unix } ]

Exemple de réponse — /api/status

JSON
{ "maintenance": false, "maintenanceScope": "both", // "vitrine" | "dashboard" | "both" "announcement": "Nouvelle mise à jour 🚀", "announcementScope": "both" }
Les champs blacklisted et listed sont filtrés côté serveur. L'API ne renvoie jamais de serveurs bannis ou désactivés.

Site / Annuaire

BumpX dispose d'un dashboard web complet où les serveurs sont listés, recherchables et chaque serveur possède une fiche dédiée.

Vitrine : bumpx.fr
Page serveur : /s/<guild_id>
Mes statistiques (connecté) : /me
Partenariats : onglet "Partenariats" sur la vitrine
Invite : Si le bot ne peut pas créer d'invite automatiquement, utilisez /setinvite pour en définir une manuellement. Sans invite valide, les visiteurs ne pourront pas rejoindre depuis l'annuaire.

FAQ

BumpX est-il payant ?

BumpX est entièrement gratuit. Le cooldown est identique pour tous les serveurs, sans avantage payant. Aucun abonnement, aucune fonctionnalité premium.

Mon serveur n'apparaît pas dans l'annuaire

Vérifie d'avoir exécuté /register
Vérifie que le statut est actif via /setstatus active
Vérifie qu'une invite valide est définie (ou utilise /setinvite)
Vérifie que le serveur n'a pas été blacklisté (contenu NSFW interdit)

Qui peut utiliser /bump ?

Tout le monde peut bumper — aucune permission particulière requise. Le cooldown de 2h30 est global au serveur. Un seul bump est possible toutes les 2h30, peu importe qui le déclenche.

Comment modifier la description du serveur ?

Utilisez /setbio [votre texte] suivi de la description souhaitée. Réservé aux admins avec la permission "Gérer le serveur". La description est immédiatement visible sur l'annuaire.

Comment bumper depuis le site web ?

Connectez-vous sur bumpx.fr avec votre compte Discord. Si vous êtes membre d'un serveur inscrit sur BumpX, un bouton "Bump" apparaît sur sa fiche dans l'annuaire. Un seul clic suffit.

La maintenance bloque-t-elle tout le site ?

Non. Grâce au système de scope, la maintenance peut cibler uniquement la vitrine (bumpx.fr) ou uniquement le dashboard, ou les deux à la fois. Voir la section Maintenance & Annonces pour le détail.

Mon serveur contient du NSFW, peut-il être listé ?

Non. Les serveurs avec du contenu NSFW sont automatiquement détectés et bannis. BumpX maintient un annuaire propre et sécurisé. Cette règle est strictement appliquée.

Support

Pour toute question, bug ou suggestion, plusieurs canaux sont disponibles :

Merci d'utiliser BumpX ! Vos retours et suggestions sont précieux pour améliorer le projet. N'hésitez pas à venir nous en parler sur Discord.