NOUVEAU 📢 Black Friday : l'offre de lancement finit le 30 nov. Jusqu'à 70 % de remise sur votre premier mois !Voir les offres
Black FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 minBlack FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 minBlack FridayJusqu'à 70 % de remise sur votre premier mois, fin le 30 nov.Fin dans 9 j 02 h 49 min

Héberger un bot Discord4J 24/7

Hébergement de bots DiscordMis à jour 6 nov. 202614 min de lecture

Pour héberger un bot Discord4J 24/7, vous le faites tourner sur une machine toujours allumée : un VPS Linux avec un service systemd qui le relance quand il s’arrête, ou un forfait bot sur l’hébergement de bots Discord PlayNHost (à partir de 1,99 $US par mois), où vous téléversez un jar exécutable, collez le token et cliquez sur Démarrer. Dans notre test, un bot Discord4J 3.3.3 a utilisé environ 126 Mo de mémoire sous Java 21 et a reçu la réponse de Discord 2,6 secondes après son lancement. Discord4J est une bibliothèque, pas un programme : vous compilez donc d’abord votre bot en jar sur votre propre ordinateur. Les étapes sur PlayNHost :

  1. Sur la page Hébergement de bots Discord, cliquez sur Créer un serveur pour un forfait. Dans la fenêtre de commande, répondez à Pour quelle plateforme est votre bot ? par Discord et choisissez Java.
  2. Sur votre ordinateur, compilez le bot avec le pom.xml ci-dessous : mvn package écrit target/bot.jar, avec Discord4J à l’intérieur.
  3. Ouvrez votre serveur dans le panel. La carte Configurer votre bot de l'Aperçu s'ouvre sur Connexion à Discord. Sa première étape, Ce qui tourne, doit indiquer Ce bot fait tourner Java Bot. ; cliquez sur cette étape pour la vérifier, puis sur Continuer.
  4. À l’étape Connexion à Discord, collez votre token dans Collez le token de votre bot, cliquez sur Connexion, puis sur Oui, continuer.
  5. À l’étape Permissions, cochez Mon code l’utilise uniquement pour les intents privilégiés que demande votre code (le bot ci-dessous n’en demande aucun), cliquez sur Ajouter à un serveur Discord, puis sur Continuer.
  6. À l’étape Votre code, cliquez sur Téléverser des fichiers et téléversez bot.jar dans le dossier principal.
  7. Sur la page Bot, volet Code, vérifiez que le Fichier d’entrée est bot.jar et que le Runtime est Java 21 (recommended), ou Java 17 ou 25. Si vous modifiez le Fichier d’entrée, cliquez sur Enregistrer à côté ; un nouveau Runtime est enregistré dès que vous le choisissez.
  8. Cliquez sur Démarrer le bot et surveillez la Console. Quand votre bot affiche Logged in as ..., la carte indique Votre bot est en ligne sur Discord.

La création du bot et de son token est expliquée dans Comment créer un bot Discord et obtenir son token, et le type de bot Java en général dans Comment héberger un bot Discord Java. Cette page parle de Discord4J lui-même : ce qu’il utilise sur un serveur et ce qu’il faut savoir avant de l’héberger.

Ce que nous avons mesuré

BibliothèqueVersionMémoire après le démarrageDu lancement à la réponse de DiscordTaille du jar
Discord4J3.3.3126 Mo2,6 s37 Mo
JDA6.7.091 Mo1,5 s19 Mo
Java 21 seul, sans bibliothèque21.0.12.138 Moaucune0,0 Mo

Méthode : sur notre propre nœud, dans un conteneur jetable configuré comme un forfait bot de 1 Go (l’image Java 21 et la commande java exacte de notre type de bot Java), chaque bot s’est connecté avec un faux token, que Discord a refusé ; la mémoire est la mémoire résidente 15 secondes après cette réponse, le temps de démarrage va du lancement à la réponse, et chaque valeur est la médiane des exécutions 2 à 4.

Ce sont des planchers : aucun serveur, aucun membre en cache, pas encore de session gateway ouverte. Votre propre code et le nombre de serveurs où se trouve votre bot s’y ajoutent, et le script de démarrage laisse le heap Java grandir jusqu’à 80 pour cent du forfait (voir plus bas). Comparez ces chiffres avec les forfaits de l’hébergement de bots Discord et choisissez selon ce que fait votre bot.

Un bot Discord4J minimal

Il enregistre une commande slash /ping, y répond par Pong!, lit le token dans DISCORD_TOKEN (le nom que lui donne le panel) et affiche une ligne de démarrage. Il n’a besoin d’aucun intent privilégié. Deux fichiers :

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.example</groupId>
  <artifactId>bot</artifactId>
  <version>1.0</version>
  <properties>
    <maven.compiler.release>17</maven.compiler.release>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
  <dependencies>
    <dependency>
      <groupId>com.discord4j</groupId>
      <artifactId>discord4j-core</artifactId>
      <version>3.3.3</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>bot</finalName>
    <plugins>
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <version>3.7.1</version>
        <configuration>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
          <appendAssemblyId>false</appendAssemblyId>
          <archive>
            <manifest>
              <mainClass>Bot</mainClass>
            </manifest>
          </archive>
        </configuration>
        <executions>
          <execution>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
</project>

src/main/java/Bot.java

import discord4j.core.DiscordClient;
import discord4j.core.event.domain.interaction.ChatInputInteractionEvent;
import discord4j.core.event.domain.lifecycle.ReadyEvent;
import discord4j.discordjson.json.ApplicationCommandRequest;
import discord4j.rest.http.client.ClientException;
import reactor.core.publisher.Mono;

public class Bot {
    public static void main(String[] args) {
        String token = System.getenv("DISCORD_TOKEN");
        if (token == null || token.isBlank()) {
            System.out.println("No DISCORD_TOKEN found. Paste your bot token on the Bot page, then restart.");
            System.exit(1);
        }

        ApplicationCommandRequest ping = ApplicationCommandRequest.builder()
                .name("ping")
                .description("Replies with Pong!")
                .build();

        try {
            DiscordClient.create(token).withGateway(gateway -> {
                // Creating a command that already exists updates it, so this is safe on every start.
                Mono<Void> register = gateway.getRestClient().getApplicationId()
                        .flatMap(appId -> gateway.getRestClient().getApplicationService()
                                .createGlobalApplicationCommand(appId, ping))
                        .then();

                Mono<Void> ready = gateway.on(ReadyEvent.class, event -> Mono.fromRunnable(() ->
                        System.out.println("Logged in as " + event.getSelf().getUsername())))
                        .then();

                Mono<Void> commands = gateway.on(ChatInputInteractionEvent.class, event -> {
                    if (event.getCommandName().equals("ping")) {
                        return event.reply("Pong!");
                    }
                    return Mono.empty();
                }).then();

                return register.and(ready).and(commands);
            }).block();
        } catch (RuntimeException e) {
            if (ClientException.isStatusCode(401).test(e)) {
                System.out.println("Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart.");
            } else {
                e.printStackTrace();
            }
            System.exit(1);
        }
    }
}

Compilez-le avec Maven 3.9 et un JDK 17 ou plus récent :

mvn package
java -jar target/bot.jar

La deuxième ligne est un test sur votre ordinateur : sans token, elle affiche No DISCORD_TOKEN found. et s’arrête, ce qui prouve que le jar démarre et trouve sa classe principale. Téléversez target/bot.jar. Le jar-with-dependencies du maven-assembly-plugin place Discord4J et tout ce dont il a besoin dans ce seul jar ; avec Gradle, le plugin Shadow donne le même résultat. maven.compiler.release 17 produit un jar qui tourne sur les trois versions de Java proposées par le panel.

La ligne Logged in as ... fait passer le badge de l’onglet Aperçu à En ligne sur Discord. Invitez le bot avec Ajouter à un serveur Discord avant d’essayer /ping : Comment inviter votre bot Discord sur un serveur.

Si le token est incorrect

Dans notre test, avec un faux token, la connexion de Discord4J a échoué avec cette erreur :

ClientException: GET /gateway/bot returned 401 Unauthorized with response {code=0, message=401: Unauthorized}

Le bot ci-dessus intercepte un token refusé (HTTP 401) et affiche Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart. au lieu d’une stack trace, puis s’arrête avec le code de sortie 1. Quand nous l’avons lancé avec un faux token, trois lignes d’avertissement SLF4J: sont apparues d’abord, la première commençant par SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder". ; elles concernent la journalisation, pas le token (voir Logs plus bas). Pour corriger, ouvrez le Discord Developer Portal, votre application, Bot, et cliquez sur Reset Token ; Discord n’affiche le nouveau token qu’une seule fois. Sur notre page Bot, volet Discord, cliquez sur Remplacer le token, collez-le, cliquez sur Enregistrer le token, puis sur Redémarrer maintenant. Quand Discord refuse la vérification du token enregistré, le volet affiche Discord ne l’a pas accepté.

Ce qu’il faut savoir sur Discord4J sur un serveur

  • Versions : Discord4J 3.3.3 est sorti le 19 août 2026. La branche 3.3 est la version actuelle et la 3.2 n’est plus que maintenue. Discord4J 3.3.3 est compilé pour Java 8 : tout Runtime proposé par le panel (Java 17, 21 ou 25) l’exécute ; compilez avec un release qui n’est pas plus récent que le runtime choisi.
  • Un seul jar, rien d’installé sur le serveur. Le type de bot Java n’a ni source Git ni champ Paquets : il lance java -jar sur votre Fichier d’entrée, donc tout ce que votre bot utilise doit être dans le jar. Pour mettre le bot à jour, téléversez un nouveau jar.
  • Limite de mémoire : le script de démarrage lance Java avec -XX:MaxRAMPercentage=80.0 et le ramasse-miettes G1, si bien que le heap peut utiliser jusqu’à 80 pour cent de la mémoire de votre forfait et que le reste du processus a de la place. Si le heap se remplit, Java affiche java.lang.OutOfMemoryError et le panel indique Votre bot a manqué de mémoire.
  • Intents : Discord4J se connecte avec tous les intents non privilégiés, sauf si vous en choisissez d’autres. L’exemple !ping du README de Discord4J lit le texte des messages, ce qui exige l’intent privilégié Message Content : activez-le dans le Developer Portal, demandez-le dans le code avec DiscordClient.create(token).gateway().setEnabledIntents(IntentSet.nonPrivileged().or(IntentSet.of(Intent.MESSAGE_CONTENT))) et cochez Mon code l’utilise pour lui à notre étape Permissions. Sans lui, Discord envoie au bot un texte de message vide, sauf dans les messages privés et les messages qui mentionnent le bot. Une commande slash, comme ci-dessus, n’a besoin de rien de tout cela. Voir Corriger « Used disallowed intents » sur votre bot Discord.
  • Logs : Discord4J journalise via Reactor, qui utilise SLF4J lorsque SLF4J est dans le jar, et Discord4J apporte SLF4J avec lui. Sans bibliothèque de journalisation derrière, comme dans le pom.xml ci-dessus, SLF4J affiche trois lignes d’avertissement au démarrage, la dernière étant SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., puis jette les lignes de log propres à Discord4J, erreurs comprises. Vos lignes System.out apparaissent toujours dans la Console. Pour voir les lignes de Discord4J, ajoutez une bibliothèque de journalisation ; la documentation de Discord4J recommande Logback.
  • Faites attendre main(). Discord4J est réactif : sa connexion est un Mono qui se connecte quand quelque chose s’y abonne. Les exemples de son README terminent main() par gateway.onDisconnect().block() ou par block() sur withGateway(...), qui attendent tant que le bot est connecté. Le bot ci-dessus utilise withGateway(...).block().
  • Enregistrer les commandes à chaque démarrage ne pose pas de problème. Discord traite la création d’une commande portant un nom que votre application utilise déjà comme une mise à jour de cette commande ; le bot ci-dessus n’accumule donc pas de copies de /ping.
  • Plantages : quand le bot se termine, comme celui ci-dessus avec un token refusé, le panel le relance aussitôt. S’il s’arrête de nouveau dans la minute qui suit, il reste arrêté et la Console en donne la raison.

L’héberger vous-même sur un VPS Linux

Un VPS n’a besoin que d’un runtime Java, puisque vous compilez le jar sur votre propre ordinateur. Sur Debian 13 ou Ubuntu 24.04, installez Java 21 ; Debian 12 fournit Java 17, qui exécute aussi le jar ci-dessus :

sudo apt update
sudo apt install openjdk-21-jre-headless
java -version

Créez un utilisateur pour le bot et copiez le jar sur le serveur (par exemple avec scp), puis dans son dossier :

sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp bot.jar /opt/mybot/
sudo chown -R mybot: /opt/mybot

Gardez le token hors de votre code, dans un fichier que seul root peut lire :

sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env

Créez /etc/systemd/system/mybot.service :

[Unit]
Description=Discord4J bot
Wants=network-online.target
After=network-online.target

[Service]
User=mybot
WorkingDirectory=/opt/mybot
EnvironmentFile=/etc/mybot.env
ExecStart=/usr/bin/java -XX:MaxRAMPercentage=80.0 -jar /opt/mybot/bot.jar
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Démarrez-le maintenant et à chaque démarrage de la machine, puis suivez sa sortie :

sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f

Restart=always relance le bot 5 secondes après qu’il s’est terminé ou a planté, mais pas après un arrêt avec systemctl stop. Sur un VPS, -XX:MaxRAMPercentage est une part de la mémoire de toute la machine ; réduisez-le donc si d’autres programmes y tournent. Pour mettre à jour, copiez le nouveau jar par-dessus l’ancien et lancez sudo systemctl restart mybot.

Auto-hébergement ou forfait bot

Sur un VPS que vous gérez vous-même, il vous revient de gérer :

  • Les mises à jour et la sécurité du système d’exploitation, ainsi que les mises à niveau de Java.
  • La copie de chaque nouveau jar, le fichier de service, le fichier du token et ses permissions.
  • La lecture de journalctl pour savoir pourquoi le bot s’est arrêté.
  • Les sauvegardes de tout ce que stocke votre bot.

En contrepartie, un VPS exécute tout ce que vous y installez.

Avec un forfait bot PlayNHost, le panel s’en charge :

  • Java 17, 21 ou 25 depuis un sélecteur, avec la limite de heap et le ramasse-miettes déjà réglés.
  • Le token, vérifié auprès de Discord avant d’être enregistré, stocké chiffré et transmis à votre code sous le nom DISCORD_TOKEN.
  • Un lien d’invitation avec les permissions de votre choix, et une carte Intents privilégiés qui vérifie lesquels sont activés dans votre Developer Portal.
  • Le redémarrage du bot après un plantage, et une bannière au-dessus de la Console quand il manque de mémoire.
  • Le téléversement depuis le navigateur et les sauvegardes depuis le panel.

Questions fréquentes

Mon bot Discord4J est en ligne mais !ping ne fait rien. Pourquoi ?

Parce que le texte du message est vide. Discord4J ne demande par défaut que des intents non privilégiés, et lire le texte des messages sur les serveurs exige Message Content, un intent privilégié. Activez-le dans le Developer Portal et demandez-le avec setEnabledIntents comme montré ci-dessus, ou utilisez une commande slash comme /ping dans le bot de cette page, qui n’a besoin d’aucun intent privilégié.

Discord4J ou JDA sur PlayNHost ?

Les deux tournent sur le même type de bot Java, à partir du même genre de jar. Le tableau ci-dessus donne la mémoire que nous avons mesurée pour chacun. La vraie différence est le style : Discord4J repose sur Reactor, vous enchaînez donc des Mono et des Flux, alors que JDA utilise des listeners et des callbacks. Choisissez celui dont le code vous paraît le plus lisible. Étapes pour JDA : Comment héberger un bot Discord Java.

Quelle version de Java choisir pour Discord4J ?

Java 21, la version recommandée, sauf si votre propre code a besoin de 25. Discord4J lui-même fonctionne dès Java 8 ; la limite est donc le release avec lequel vous compilez : un jar compilé pour un Java plus récent que celui du serveur s’arrête avec UnsupportedClassVersionError. Choisissez un Runtime plus récent, ou compilez avec un release plus bas.

Pourquoi mon jar Discord4J est-il si gros ?

Parce qu’il contient tout : Discord4J apporte Reactor, Netty, Jackson et ses propres modules vocaux, et la compilation jar-with-dependencies les emballe tous. Le jar de notre test faisait 37 Mo. C’est de l’espace disque sur votre forfait ; la mémoire utilisée par le bot en marche figure dans le tableau ci-dessus.

Prêt à faire tourner votre bot Discord4J en continu ? Consultez les forfaits de l’hébergement de bots Discord.

Votre bot est hébergé ailleurs ? Transférez-le chez nous

NOS DERNIERS ARTICLES