Om een Discord4J-bot 24/7 te hosten laat je hem draaien op een machine die altijd aanstaat: een Linux-VPS met een systemd-service die hem opnieuw start als hij stopt, of een botplan bij PlayNHost Discord-bothosting (vanaf US$1.99 per maand), waar je één uitvoerbare jar uploadt, het token plakt en op Start drukt. In onze test gebruikte een Discord4J 3.3.3-bot ongeveer 126 MB geheugen op Java 21 en kreeg hij 2.6 seconden na het starten het antwoord van Discord. Discord4J is een bibliotheek, geen programma, dus je bouwt je bot eerst op je eigen computer tot een jar. De stappen bij PlayNHost:
- Klik op de pagina Discord-bothosting bij een plan op Server aanmaken. Beantwoord in het bestelvenster Voor welk platform is je bot? met Discord en kies Java.
- Bouw de bot op je computer met de
pom.xmlhieronder:mvn packageschrijfttarget/bot.jar, met Discord4J erin. - Open je server in het paneel. De kaart Je bot instellen op het Overzicht opent bij Verbinden met Discord. De eerste stap, Wat er draait, hoort Deze bot draait Java Bot. te tonen; klik op die stap om het te controleren en dan op Doorgaan.
- Plak bij Verbinden met Discord je token in Plak je bottoken, klik op Verbinden en daarna op Ja, doorgaan.
- Vink bij Rechten alleen voor de bevoorrechte intents die je code vraagt Mijn code gebruikt dit aan (de bot hieronder heeft er geen nodig), klik op Toevoegen aan een Discord-server en daarna op Doorgaan.
- Klik bij Je code op Bestanden uploaden en upload
bot.jarnaar de hoofdmap. - Controleer op de pagina Bot, paneel Code, dat het Startbestand
bot.jaris en de Runtime Java 21 (recommended), of Java 17 of 25. Als je het Startbestand wijzigt, klik dan ernaast op Opslaan; een nieuwe Runtime wordt opgeslagen zodra je hem kiest. - Klik op Bot starten en volg de Console. Zodra je bot
Logged in as ...afdrukt, staat in de kaart Je bot is online in Discord.
Hoe je de bot en zijn token maakt, staat in Een Discord-bot maken en zijn token ophalen, en het Java-bottype in het algemeen in Een Java Discord-bot hosten. Deze pagina gaat over Discord4J zelf: wat het op een server gebruikt en wat je moet weten voordat je het host.
Wat we hebben gemeten
| Bibliotheek | Versie | Geheugen na het starten | Van start tot antwoord van Discord | Jar-grootte |
|---|---|---|---|---|
| Discord4J | 3.3.3 | 126 MB | 2.6 s | 37 MB |
| JDA | 6.7.0 | 91 MB | 1.5 s | 19 MB |
| Alleen Java 21, zonder bibliotheek | 21.0.12.1 | 38 MB | geen | 0.0 MB |
Hoe: op onze eigen node, in een wegwerpcontainer ingericht als een botplan van 1 GB (de Java 21-image en het exacte java-commando van ons Java-bottype), logde elke bot in met een nep-token, dat Discord weigerde; het geheugen is het resident geheugen 15 seconden na dat antwoord, de starttijd loopt van de start tot het antwoord en elke waarde is de mediaan van run 2 tot 4.
Dit zijn ondergrenzen: geen servers, geen gecachete leden, nog geen open gateway-sessie. Je eigen code en het aantal servers waarin je bot zit komen erbovenop, en het startscript laat de Java-heap groeien tot 80 procent van het plan (zie hieronder). Vergelijk de cijfers met de plannen bij Discord-bothosting en kies op basis van wat je bot doet.
Een minimale Discord4J-bot
Hij registreert een slash-commando /ping, beantwoordt dat met Pong!, leest het token uit DISCORD_TOKEN (de naam die het paneel eraan geeft) en drukt een gereedregel af. Hij heeft geen bevoorrechte intent nodig. Twee bestanden:
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);
}
}
}
Bouw hem met Maven 3.9 en een JDK 17 of nieuwer:
mvn package
java -jar target/bot.jar
De tweede regel is een test op je computer: zonder token drukt hij No DISCORD_TOKEN found. af en stopt, wat bewijst dat de jar start en zijn hoofdklasse vindt. Upload target/bot.jar. De jar-with-dependencies van de maven-assembly-plugin stopt Discord4J en alles wat het nodig heeft in die ene jar; met Gradle bereik je hetzelfde via de Shadow-plugin. maven.compiler.release 17 levert een jar die draait op alle drie de Java-versies die het paneel aanbiedt.
De regel Logged in as ... zet de chip op Overzicht op Online in Discord. Nodig de bot uit met Toevoegen aan een Discord-server voordat je /ping probeert: Je Discord-bot uitnodigen op een server.
Als het token fout is
In onze test, met een nep-token, mislukte de login van Discord4J met deze fout:
ClientException: GET /gateway/bot returned 401 Unauthorized with response {code=0, message=401: Unauthorized}
De bot hierboven vangt een geweigerd token (HTTP 401) af en drukt Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart. af in plaats van een stacktrace, en stopt dan met exitcode 1. Toen we hem met een nep-token draaiden, kwamen er eerst drie SLF4J:-waarschuwingsregels, de eerste begint met SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".; die gaan over logging, niet over het token (zie Logs hieronder). Om het op te lossen open je het Discord Developer Portal, je applicatie, Bot, en klik je op Reset Token; Discord toont het nieuwe token één keer. Klik op onze pagina Bot, paneel Discord, op Token vervangen, plak het, klik op Token opslaan en daarna op Nu herstarten. Als Discord de controle van het opgeslagen token weigert, toont het paneel Discord heeft het niet geaccepteerd.
Wat je moet weten over Discord4J op een server
- Versies: Discord4J 3.3.3 kwam uit op 19 augustus 2026. De 3.3-lijn is de huidige en 3.2 krijgt alleen onderhoud. Discord4J 3.3.3 is gecompileerd voor Java 8, dus elke Runtime die het paneel aanbiedt (Java 17, 21 of 25) draait het; bouw met een
releasedie niet nieuwer is dan de runtime die je kiest. - Eén jar, niets geïnstalleerd op de server. Het Java-bottype heeft geen Git-bron en geen veld Packages: het start
java -jarop je Startbestand, dus alles wat je bot gebruikt moet in de jar zitten. Upload een nieuwe jar om de bot bij te werken. - Geheugenlimiet: het startscript draait Java met
-XX:MaxRAMPercentage=80.0en de G1-garbage collector, zodat de heap tot 80 procent van het geheugen van je plan kan gebruiken en de rest van het proces ruimte heeft. Als de heap volloopt, drukt Javajava.lang.OutOfMemoryErroraf en toont het paneel Je bot had geen geheugen meer. - Intents: Discord4J verbindt met alle niet-bevoorrechte intents tenzij je andere kiest. Het voorbeeld
!pingin de README van Discord4J leest berichttekst, wat de bevoorrechte intent Message Content vereist: zet hem aan in het Developer Portal, vraag hem in code aan metDiscordClient.create(token).gateway().setEnabledIntents(IntentSet.nonPrivileged().or(IntentSet.of(Intent.MESSAGE_CONTENT)))en vink bij onze stap Rechten Mijn code gebruikt dit ervoor aan. Zonder die intent stuurt Discord de bot lege berichttekst, behalve in directe berichten en berichten die de bot vermelden. Een slash-commando, zoals hierboven, heeft dit allemaal niet nodig. Zie "Used disallowed intents" oplossen op je Discord-bot. - Logs: Discord4J logt via Reactor, dat SLF4J gebruikt als SLF4J in de jar zit, en Discord4J brengt SLF4J zelf mee. Zonder logbibliotheek erachter, zoals in de
pom.xmlhierboven, drukt SLF4J bij het starten drie waarschuwingsregels af, de laatsteSLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., en gooit dan de eigen logregels van Discord4J weg, fouten inbegrepen. JeSystem.out-regels verschijnen nog steeds in de Console. Voeg een logbibliotheek toe om de regels van Discord4J te zien; de documentatie van Discord4J raadt Logback aan. - Laat
main()wachten. Discord4J is reactief: de login is eenMonodie pas verbindt als er iets op abonneert. De voorbeelden in de README eindigenmain()metgateway.onDisconnect().block()of metblock()opwithGateway(...), die wachten zolang de bot verbonden is. De bot hierboven gebruiktwithGateway(...).block(). - Commando's bij elke start registreren is prima. Discord behandelt het aanmaken van een commando met een naam die je applicatie al gebruikt als een update van dat commando, dus de bot hierboven stapelt geen kopieën van
/pingop. - Crashes: als de bot stopt, zoals de bot hierboven doet bij een geweigerd token, start het paneel hem meteen opnieuw. Als hij binnen een minuut daarna weer stopt, blijft hij gestopt en zegt de Console waarom.
Zelf hosten op een Linux-VPS
Een VPS heeft alleen een Java-runtime nodig, omdat je de jar op je eigen computer bouwt. Installeer op Debian 13 of Ubuntu 24.04 Java 21; Debian 12 levert Java 17, dat de jar hierboven ook draait:
sudo apt update
sudo apt install openjdk-21-jre-headless
java -version
Maak een gebruiker voor de bot en kopieer de jar naar de server (bijvoorbeeld met scp), en dan naar zijn map:
sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp bot.jar /opt/mybot/
sudo chown -R mybot: /opt/mybot
Houd het token buiten je code, in een bestand dat alleen root kan lezen:
sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env
Maak /etc/systemd/system/mybot.service aan:
[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
Start hem nu en bij elke boot en volg dan zijn uitvoer:
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f
Restart=always start de bot 5 seconden nadat hij stopt of crasht opnieuw, maar niet nadat je hem met systemctl stop stopt. Op een VPS is -XX:MaxRAMPercentage een deel van het geheugen van de hele machine, dus zet hem lager als er andere programma's draaien. Kopieer om bij te werken de nieuwe jar over de oude en voer sudo systemctl restart mybot uit.
Zelf hosten of een botplan
Op een VPS die je zelf beheert, regel je:
- Updates en beveiliging van het besturingssysteem, en Java-upgrades.
- Elke nieuwe jar kopiëren, het servicebestand, het tokenbestand en de rechten daarvan.
journalctllezen om uit te zoeken waarom de bot stopte.- Back-ups van alles wat je bot opslaat.
Daar staat tegenover dat een VPS alles draait wat je erop installeert.
Op een PlayNHost-botplan doet het paneel dit voor je:
- Java 17, 21 of 25 uit een keuzelijst, met de heaplimiet en garbage collector al ingesteld.
- Het token, bij Discord gecontroleerd voordat het wordt opgeslagen, versleuteld bewaard en als
DISCORD_TOKENaan je code doorgegeven. - Een uitnodigingslink met de rechten die jij kiest en een kaart Bevoorrechte intents die controleert welke in je Developer Portal aanstaan.
- De bot opnieuw starten na een crash en een banner boven de Console als het geheugen op is.
- Uploaden vanuit de browser en back-ups vanuit het paneel.
Veelgestelde vragen
Mijn Discord4J-bot is online maar !ping doet niets. Waarom?
Omdat de berichttekst leeg is. Discord4J vraagt standaard alleen niet-bevoorrechte intents aan, en berichttekst lezen op servers vereist Message Content, een bevoorrechte intent. Zet hem aan in het Developer Portal en vraag hem aan met setEnabledIntents zoals hierboven getoond, of gebruik een slash-commando zoals /ping in de bot op deze pagina, dat geen bevoorrechte intent nodig heeft.
Discord4J of JDA bij PlayNHost?
Beide draaien op hetzelfde Java-bottype, vanuit hetzelfde soort jar. De tabel hierboven bevat het geheugen dat we voor elk hebben gemeten. Het echte verschil is de stijl: Discord4J is gebouwd op Reactor, dus je koppelt Mono en Flux aan elkaar, terwijl JDA listeners en callbacks gebruikt. Kies degene waarvan je de code makkelijker leest. Stappen voor JDA: Een Java Discord-bot hosten.
Welke Java-versie moet ik voor Discord4J kiezen?
Java 21, de aanbevolen versie, tenzij je eigen code 25 nodig heeft. Discord4J zelf werkt vanaf Java 8, dus de grens is de release waarmee je bouwt: een jar die voor een nieuwere Java is gebouwd dan de server draait, stopt met UnsupportedClassVersionError. Kies een nieuwere Runtime, of bouw met een lagere release.
Waarom is mijn Discord4J-jar zo groot?
Omdat hij alles bevat: Discord4J brengt Reactor, Netty, Jackson en zijn eigen spraakmodules mee, en de build met jar-with-dependencies pakt ze allemaal in. De jar in onze test was 37 MB. Dat is schijfruimte van je plan; het geheugen dat de draaiende bot gebruikte staat in de tabel hierboven.
Klaar om je Discord4J-bot dag en nacht te laten draaien? Bekijk de plannen bij Discord-bothosting.



