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 :
- 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.
- Sur votre ordinateur, compilez le bot avec le
pom.xmlci-dessous :mvn packageécrittarget/bot.jar, avec Discord4J à l’intérieur. - 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.
- À l’étape Connexion à Discord, collez votre token dans Collez le token de votre bot, cliquez sur Connexion, puis sur Oui, continuer.
- À 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.
- À l’étape Votre code, cliquez sur Téléverser des fichiers et téléversez
bot.jardans le dossier principal. - Sur la page Bot, volet Code, vérifiez que le Fichier d’entrée est
bot.jaret 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. - 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èque | Version | Mémoire après le démarrage | Du lancement à la réponse de Discord | Taille du jar |
|---|---|---|---|---|
| Discord4J | 3.3.3 | 126 Mo | 2,6 s | 37 Mo |
| JDA | 6.7.0 | 91 Mo | 1,5 s | 19 Mo |
| Java 21 seul, sans bibliothèque | 21.0.12.1 | 38 Mo | aucune | 0,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
releasequi 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 -jarsur 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.0et 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 affichejava.lang.OutOfMemoryErroret 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
!pingdu 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 avecDiscordClient.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.xmlci-dessus, SLF4J affiche trois lignes d’avertissement au démarrage, la dernière étantSLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., puis jette les lignes de log propres à Discord4J, erreurs comprises. Vos lignesSystem.outapparaissent 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 unMonoqui se connecte quand quelque chose s’y abonne. Les exemples de son README terminentmain()pargateway.onDisconnect().block()ou parblock()surwithGateway(...), qui attendent tant que le bot est connecté. Le bot ci-dessus utilisewithGateway(...).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
journalctlpour 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.



