Aby hostować bota Discord4J 24/7, uruchamiasz go na maszynie, która jest zawsze włączona: na VPS z Linuksem z usługą systemd, która startuje go ponownie, gdy się zatrzyma, albo w planie dla botów w hostingu botów Discord PlayNHost (od 1,99 USD miesięcznie), gdzie przesyłasz jeden uruchamialny jar, wklejasz token i klikasz Start. W naszym teście bot Discord4J 3.3.3 zużył ok. 126 MB pamięci na Javie 21 i dostał odpowiedź Discorda 2,6 sekundy po uruchomieniu. Discord4J to biblioteka, nie program, więc najpierw budujesz swojego bota do jara na własnym komputerze. Kroki w PlayNHost:
- Na stronie Hosting botów Discord kliknij Utwórz serwer przy wybranym planie. W oknie zamówienia odpowiedz na pytanie Na jaką platformę jest Twój bot? wyborem Discord i wybierz Javę.
- Na swoim komputerze zbuduj bota z użyciem poniższego
pom.xml:mvn packagezapiszetarget/bot.jarz Discord4J w środku. - Otwórz swój serwer w panelu. Karta Skonfiguruj swojego bota w sekcji Przegląd otwiera się na kroku Połącz z Discord. Jej pierwszy krok, Co działa, powinien pokazywać Ten bot uruchamia Java Bot.; kliknij ten krok, aby to sprawdzić, a potem Dalej.
- W kroku Połącz z Discord wklej token w polu Wklej token swojego bota, kliknij Połączenie, a potem Tak, dalej.
- W kroku Uprawnienia zaznacz Mój kod tego używa tylko dla uprzywilejowanych intentów, o które prosi twój kod (bot poniżej żadnego nie potrzebuje), kliknij Dodaj na serwer Discord, a potem Dalej.
- W kroku Twój kod kliknij Prześlij pliki i prześlij
bot.jardo głównego folderu. - Na stronie Bot, w panelu Kod, sprawdź, czy Plik startowy to
bot.jar, a Runtime to Java 21 (recommended), albo Java 17 lub 25. Jeśli zmienisz Plik startowy, kliknij obok Zapisz; nowy Runtime zapisuje się od razu po wybraniu. - Kliknij Uruchom bota i obserwuj Console. Gdy twój bot wypisze
Logged in as ..., karta pokaże Twój bot jest online na Discordzie.
Tworzenie bota i jego tokena opisuje artykuł Jak stworzyć bota Discord i zdobyć jego token, a typ bota Javy ogólnie artykuł Jak hostować bota Discord w Javie. Ta strona dotyczy samego Discord4J: czego używa na serwerze i co warto wiedzieć przed hostowaniem.
Co zmierzyliśmy
| Biblioteka | Wersja | Pamięć po starcie | Od uruchomienia do odpowiedzi Discorda | Rozmiar jara |
|---|---|---|---|---|
| Discord4J | 3.3.3 | 126 MB | 2,6 s | 37 MB |
| JDA | 6.7.0 | 91 MB | 1,5 s | 19 MB |
| Sama Java 21, bez biblioteki | 21.0.12.1 | 38 MB | brak | 0,0 MB |
Jak: na naszym własnym węźle, w jednorazowym kontenerze skonfigurowanym jak plan dla botów z 1 GB (obraz Javy 21 i dokładne polecenie java naszego typu bota Javy) każdy bot logował się fałszywym tokenem, który Discord odrzucał; pamięć to pamięć rezydentna 15 sekund po tej odpowiedzi, czas startu liczy się od uruchomienia do odpowiedzi, a każda wartość to mediana uruchomień od 2 do 4.
To wartości minimalne: brak serwerów, brak członków w pamięci podręcznej, jeszcze bez otwartej sesji gateway. Twój własny kod i liczba serwerów, na których jest bot, dochodzą do tego, a skrypt startowy pozwala stercie Javy urosnąć do 80 procent planu (zobacz niżej). Porównaj liczby z planami w hostingu botów Discord i wybierz według tego, co robi twój bot.
Minimalny bot Discord4J
Rejestruje komendę slash /ping, odpowiada na nią Pong!, czyta token z DISCORD_TOKEN (taką nazwę nadaje mu panel) i wypisuje linię gotowości. Nie potrzebuje żadnego uprzywilejowanego intentu. Dwa pliki:
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);
}
}
}
Zbuduj go z Mavenem 3.9 i JDK 17 lub nowszym:
mvn package
java -jar target/bot.jar
Druga linia to test na twoim komputerze: bez tokena wypisuje No DISCORD_TOKEN found. i się zatrzymuje, co dowodzi, że jar startuje i znajduje klasę główną. Prześlij target/bot.jar. jar-with-dependencies z maven-assembly-plugin wkłada Discord4J i wszystko, czego potrzebuje, do tego jednego jara; w Gradle to samo daje wtyczka Shadow. maven.compiler.release 17 daje jar, który działa na wszystkich trzech wersjach Javy oferowanych przez panel.
Linia Logged in as ... przełącza znacznik w sekcji Przegląd na Online na Discordzie. Zaproś bota przyciskiem Dodaj na serwer Discord, zanim wypróbujesz /ping: Jak zaprosić bota Discord na serwer.
Gdy token jest błędny
W naszym teście, z fałszywym tokenem, logowanie Discord4J zakończyło się takim błędem:
ClientException: GET /gateway/bot returned 401 Unauthorized with response {code=0, message=401: Unauthorized}
Bot powyżej przechwytuje odrzucony token (HTTP 401) i zamiast stack trace wypisuje Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart., po czym kończy działanie z kodem wyjścia 1. Gdy uruchomiliśmy go z fałszywym tokenem, najpierw pojawiły się trzy linie ostrzeżeń SLF4J:, pierwsza zaczyna się od SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".; dotyczą logowania, nie tokena (zobacz Logi niżej). Aby to naprawić, otwórz Discord Developer Portal, swoją aplikację, Bot i kliknij Reset Token; Discord pokazuje nowy token tylko raz. Na naszej stronie Bot, w panelu Discord, kliknij Zastąp token, wklej go, kliknij Zapisz token, a potem Zrestartuj teraz. Gdy Discord odrzuci sprawdzenie zapisanego tokena, panel pokazuje Discord go nie przyjął.
Co warto wiedzieć o Discord4J na serwerze
- Wersje: Discord4J 3.3.3 ukazał się 19 sierpnia 2026. Linia 3.3 jest bieżąca, a 3.2 dostaje tylko poprawki utrzymaniowe. Discord4J 3.3.3 jest skompilowany dla Javy 8, więc działa na każdym Runtime oferowanym przez panel (Java 17, 21 lub 25); buduj z
releasenie nowszym niż wybrany runtime. - Jeden jar, nic nie jest instalowane na serwerze. Typ bota Javy nie ma źródła Git ani pola Pakiety: uruchamia
java -jarna twoim Pliku startowym, więc wszystko, czego używa bot, musi być w jarze. Aby zaktualizować bota, prześlij nowy jar. - Limit pamięci: skrypt startowy uruchamia Javę z
-XX:MaxRAMPercentage=80.0i garbage collectorem G1, więc sterta może zajmować do 80 procent pamięci planu, a reszta procesu ma miejsce. Gdy sterta się zapełni, Java wypisujejava.lang.OutOfMemoryError, a panel pokazuje Twojemu botowi zabrakło pamięci. - Intenty: Discord4J łączy się ze wszystkimi nieuprzywilejowanymi intentami, o ile nie wybierzesz innych. Przykład
!pingz README Discord4J czyta treść wiadomości, co wymaga uprzywilejowanego intentu Message Content: włącz go w Developer Portal, zażądaj go w kodzie przezDiscordClient.create(token).gateway().setEnabledIntents(IntentSet.nonPrivileged().or(IntentSet.of(Intent.MESSAGE_CONTENT)))i zaznacz dla niego Mój kod tego używa w naszym kroku Uprawnienia. Bez niego Discord wysyła botowi pustą treść wiadomości, poza wiadomościami prywatnymi i wiadomościami, które wspominają bota. Komenda slash, jak wyżej, nie potrzebuje żadnego z tych kroków. Zobacz Napraw błąd „Used disallowed intents” w bocie Discord. - Logi: Discord4J loguje przez Reactor, który używa SLF4J, gdy SLF4J jest w jarze, a Discord4J przynosi SLF4J ze sobą. Bez biblioteki logowania z tyłu, jak w
pom.xmlpowyżej, SLF4J wypisuje przy starcie trzy linie ostrzeżeń, ostatnia toSLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., a potem odrzuca własne linie logów Discord4J, razem z błędami. Twoje linieSystem.outnadal widać w Console. Aby zobaczyć linie Discord4J, dodaj bibliotekę logowania; dokumentacja Discord4J poleca Logback. - Niech
main()czeka. Discord4J jest reaktywny: jego logowanie toMono, które łączy się dopiero, gdy coś je zasubskrybuje. Przykłady z jego README kończąmain()wywołaniemgateway.onDisconnect().block()alboblock()nawithGateway(...), które czekają, dopóki bot jest połączony. Bot powyżej używawithGateway(...).block(). - Rejestrowanie komend przy każdym starcie jest w porządku. Discord traktuje utworzenie komendy o nazwie, której twoja aplikacja już używa, jako aktualizację tej komendy, więc bot powyżej nie mnoży kopii
/ping. - Awarie: gdy bot kończy działanie, jak ten powyżej przy odrzuconym tokenie, panel od razu uruchamia go ponownie. Jeśli zatrzyma się znowu w ciągu minuty, pozostaje zatrzymany, a Console podaje powód.
Hostowanie samodzielnie na VPS z Linuksem
VPS potrzebuje tylko środowiska Javy, bo jar budujesz na własnym komputerze. Na Debianie 13 lub Ubuntu 24.04 zainstaluj Javę 21; Debian 12 ma Javę 17, która też uruchomi powyższy jar:
sudo apt update
sudo apt install openjdk-21-jre-headless
java -version
Utwórz użytkownika dla bota i skopiuj jar na serwer (na przykład przez scp), a potem do jego folderu:
sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp bot.jar /opt/mybot/
sudo chown -R mybot: /opt/mybot
Trzymaj token poza kodem, w pliku, który może czytać tylko root:
sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env
Utwórz /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
Uruchom go teraz i przy każdym starcie systemu, a potem śledź jego wyjście:
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f
Restart=always uruchamia bota ponownie 5 sekund po tym, jak się zakończy lub padnie, ale nie po zatrzymaniu go przez systemctl stop. Na VPS -XX:MaxRAMPercentage to udział w pamięci całej maszyny, więc zmniejsz go, jeśli działają tam inne programy. Aby zaktualizować, skopiuj nowy jar nad stary i uruchom sudo systemctl restart mybot.
Samodzielny hosting czy plan dla botów
Na VPS, którym zarządzasz sam, zajmujesz się:
- Aktualizacjami i bezpieczeństwem systemu operacyjnego oraz aktualizacjami Javy.
- Kopiowaniem każdego nowego jara, plikiem usługi, plikiem tokena i jego uprawnieniami.
- Czytaniem
journalctl, żeby sprawdzić, dlaczego bot się zatrzymał. - Kopiami zapasowymi wszystkiego, co zapisuje twój bot.
W zamian VPS uruchomi wszystko, co na nim zainstalujesz.
W planie dla botów PlayNHost robi to za ciebie panel:
- Java 17, 21 lub 25 z listy wyboru, z ustawionym limitem sterty i garbage collectorem.
- Token sprawdzany w Discordzie przed zapisem, przechowywany w postaci zaszyfrowanej i przekazywany twojemu kodowi jako
DISCORD_TOKEN. - Link zaproszenia z wybranymi przez ciebie uprawnieniami i karta Uprzywilejowane intenty, która sprawdza, które są włączone w twoim Developer Portal.
- Ponowne uruchomienie bota po awarii i baner nad Console, gdy zabraknie mu pamięci.
- Przesyłanie z przeglądarki i kopie zapasowe z panelu.
Najczęstsze pytania
Mój bot Discord4J jest online, ale !ping nic nie robi. Dlaczego?
Bo treść wiadomości jest pusta. Discord4J domyślnie żąda tylko nieuprzywilejowanych intentów, a czytanie treści wiadomości na serwerach wymaga Message Content, uprzywilejowanego intentu. Włącz go w Developer Portal i zażądaj przez setEnabledIntents, jak pokazano wyżej, albo użyj komendy slash, takiej jak /ping w bocie z tej strony, która nie potrzebuje uprzywilejowanego intentu.
Discord4J czy JDA w PlayNHost?
Oba działają na tym samym typie bota Javy, z tego samego rodzaju jara. Tabela powyżej zawiera pamięć, którą zmierzyliśmy dla każdego. Prawdziwa różnica to styl: Discord4J opiera się na Reactorze, więc łączysz w łańcuch Mono i Flux, a JDA używa listenerów i callbacków. Wybierz ten, którego kod czytasz łatwiej. Kroki dla JDA: Jak hostować bota Discord w Javie.
Którą wersję Javy wybrać dla Discord4J?
Javę 21, zalecaną, chyba że twój własny kod wymaga 25. Sam Discord4J działa od Javy 8, więc ograniczeniem jest release, z którym budujesz: jar zbudowany dla nowszej Javy, niż działa na serwerze, zatrzymuje się z UnsupportedClassVersionError. Wybierz nowszy Runtime albo buduj z niższym release.
Dlaczego mój jar Discord4J jest taki duży?
Bo zawiera wszystko: Discord4J przynosi Reactor, Netty, Jackson i własne moduły głosowe, a build z jar-with-dependencies pakuje je wszystkie. Jar w naszym teście miał 37 MB. To miejsce na dysku w twoim planie; pamięć zużywana przez działającego bota jest w tabeli powyżej.
Gotowy, by twój bot Discord4J działał całą dobę? Zobacz plany w hostingu botów Discord.



