NIEUW 📢 Black Friday: onze lanceeractie eindigt op 30 nov. Tot 70% korting op je eerste maand, voor elke game!Bekijk pakketten
Black FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 minBlack FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 minBlack FridayTot 70% korting op je eerste maand, eindigt op 30 nov.Eindigt over 9 d 02 u 49 min

Een Discord4J-bot 24/7 hosten

Discord-bothostingBijgewerkt 6 nov 202613 min lezen

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:

  1. 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.
  2. Bouw de bot op je computer met de pom.xml hieronder: mvn package schrijft target/bot.jar, met Discord4J erin.
  3. 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.
  4. Plak bij Verbinden met Discord je token in Plak je bottoken, klik op Verbinden en daarna op Ja, doorgaan.
  5. 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.
  6. Klik bij Je code op Bestanden uploaden en upload bot.jar naar de hoofdmap.
  7. Controleer op de pagina Bot, paneel Code, dat het Startbestand bot.jar is 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.
  8. 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

BibliotheekVersieGeheugen na het startenVan start tot antwoord van DiscordJar-grootte
Discord4J3.3.3126 MB2.6 s37 MB
JDA6.7.091 MB1.5 s19 MB
Alleen Java 21, zonder bibliotheek21.0.12.138 MBgeen0.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 release die 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 -jar op 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.0 en 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 Java java.lang.OutOfMemoryError af en toont het paneel Je bot had geen geheugen meer.
  • Intents: Discord4J verbindt met alle niet-bevoorrechte intents tenzij je andere kiest. Het voorbeeld !ping in 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 met DiscordClient.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.xml hierboven, drukt SLF4J bij het starten drie waarschuwingsregels af, de laatste SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., en gooit dan de eigen logregels van Discord4J weg, fouten inbegrepen. Je System.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 een Mono die pas verbindt als er iets op abonneert. De voorbeelden in de README eindigen main() met gateway.onDisconnect().block() of met block() op withGateway(...), die wachten zolang de bot verbonden is. De bot hierboven gebruikt withGateway(...).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 /ping op.
  • 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.
  • journalctl lezen 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_TOKEN aan 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.

Draait je bot al ergens anders? Verhuis hem naar ons

ONZE NIEUWSTE BLOGS