Чтобы запустить бота Discord4J 24/7, его нужно держать на машине, которая всегда включена: на Linux VPS со службой systemd, которая запускает бота снова, когда он останавливается, или на тарифе для ботов в хостинге Discord-ботов PlayNHost (от US$1.99 в месяц), где вы загружаете один исполняемый jar, вставляете токен и нажимаете «Запустить». В нашем тесте бот на Discord4J 3.3.3 занял около 126 МБ памяти на Java 21 и получил ответ Discord через 2,6 секунды после запуска. Discord4J является библиотекой, а не программой, поэтому сначала вы собираете бота в jar на своём компьютере. Шаги в PlayNHost:
- На странице Хостинг Discord-ботов нажмите Создать сервер на нужном тарифе. В окне заказа на вопрос Для какой платформы ваш бот? ответьте Discord и выберите Java.
- На своём компьютере соберите бота с помощью
pom.xmlниже:mvn packageсоздастtarget/bot.jarс Discord4J внутри. - Откройте свой сервер в панели. Карточка Настройка бота в разделе Обзор открывается на шаге Подключение к Discord. Первый шаг, Что запускается, должен показывать Этот бот запускает Java Bot.; нажмите на этот шаг, чтобы проверить, затем Продолжить.
- На шаге Подключение к Discord вставьте токен в поле Вставьте токен бота, нажмите Подключение, затем Да, продолжить.
- На шаге Разрешения отметьте Мой код это использует только для тех привилегированных интентов, которые запрашивает ваш код (боту ниже они не нужны), нажмите Добавить на сервер Discord, затем Продолжить.
- На шаге Ваш код нажмите Загрузить файлы и загрузите
bot.jarв основную папку. - На странице Бот в блоке Код проверьте, что Файл запуска называется
bot.jar, а в поле Среда выполнения выбрано Java 21 (recommended), либо Java 17 или 25. Если вы меняете Файл запуска, нажмите рядом Сохранить; новая Среда выполнения сохраняется сразу, как только вы её выберете. - Нажмите Запустить бота и следите за Console. Когда бот выведет
Logged in as ..., карточка покажет Ваш бот онлайн в Discord.
Как создать бота и его токен, объяснено в статье Как создать Discord-бота и получить его токен, а про тип бота Java в целом написано в статье Как запустить Discord-бота на Java. Эта страница о самом Discord4J: что он использует на сервере и что стоит знать перед запуском.
Что мы измерили
| Библиотека | Версия | Память после запуска | От запуска до ответа Discord | Размер jar |
|---|---|---|---|---|
| Discord4J | 3.3.3 | 126 МБ | 2,6 с | 37 МБ |
| JDA | 6.7.0 | 91 МБ | 1,5 с | 19 МБ |
| Только Java 21, без библиотеки | 21.0.12.1 | 38 МБ | нет | 0,0 МБ |
Как мы измеряли: на нашем собственном узле, в одноразовом контейнере, настроенном как тариф для ботов на 1 ГБ (образ Java 21 и точная команда java нашего типа бота Java), каждый бот входил с поддельным токеном, который Discord отклонял; память здесь означает резидентную память через 15 секунд после этого ответа, время старта считается от запуска до ответа, а каждое значение является медианой запусков с 2 по 4.
Это нижние границы: без серверов, без кэшированных участников, пока без открытой сессии gateway. Ваш собственный код и число серверов, на которых находится бот, добавляются к ним, а стартовый скрипт позволяет куче Java расти до 80 процентов тарифа (см. ниже). Сравните числа с тарифами на странице Хостинг Discord-ботов и выбирайте по тому, что делает ваш бот.
Минимальный бот на Discord4J
Он регистрирует слэш-команду /ping, отвечает на неё Pong!, читает токен из DISCORD_TOKEN (под таким именем его выдаёт панель) и выводит строку о готовности. Привилегированные интенты ему не нужны. Два файла:
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);
}
}
}
Соберите его с Maven 3.9 и JDK 17 или новее:
mvn package
java -jar target/bot.jar
Вторая строка служит проверкой на вашем компьютере: без токена она выводит No DISCORD_TOKEN found. и останавливается, что доказывает: jar запускается и находит главный класс. Загрузите target/bot.jar. Сборка jar-with-dependencies из maven-assembly-plugin кладёт Discord4J и всё, что ему нужно, в этот единственный jar; в Gradle то же самое делает плагин Shadow. Значение maven.compiler.release 17 даёт jar, который работает на всех трёх версиях Java, предлагаемых панелью.
Именно строка Logged in as ... переключает индикатор на вкладке Обзор на Онлайн в Discord. Пригласите бота кнопкой Добавить на сервер Discord, прежде чем пробовать /ping: Как пригласить Discord-бота на сервер.
Если токен неверный
В нашем тесте с поддельным токеном вход Discord4J завершился такой ошибкой:
ClientException: GET /gateway/bot returned 401 Unauthorized with response {code=0, message=401: Unauthorized}
Бот выше перехватывает отклонённый токен (HTTP 401) и вместо stack trace выводит Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart., после чего завершается с кодом выхода 1. Когда мы запускали его с поддельным токеном, сначала появились три строки предупреждений SLF4J:, первая начинается с SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".; они относятся к логированию, а не к токену (см. «Логи» ниже). Чтобы исправить, откройте Discord Developer Portal, своё приложение, Bot и нажмите Reset Token; Discord показывает новый токен только один раз. На нашей странице Бот в блоке Discord нажмите Заменить токен, вставьте его, нажмите Сохранить токен, затем Перезапустить сейчас. Если Discord отклоняет проверку сохранённого токена, блок показывает Discord его не принял.
Что нужно знать о Discord4J на сервере
- Версии: Discord4J 3.3.3 вышел 19 августа 2026 года. Ветка 3.3 актуальная, а 3.2 получает только сопровождение. Discord4J 3.3.3 скомпилирован для Java 8, поэтому его запустит любая Среда выполнения, которую предлагает панель (Java 17, 21 или 25); собирайте с
releaseне новее выбранной среды. - Один jar, на сервере ничего не устанавливается. У типа бота Java нет источника Git и поля Пакеты: он запускает
java -jarна вашем Файл запуска, поэтому всё, что использует бот, должно лежать внутри jar. Чтобы обновить бота, загрузите новый jar. - Лимит памяти: стартовый скрипт запускает Java с
-XX:MaxRAMPercentage=80.0и сборщиком мусора G1, так что куча может занять до 80 процентов памяти тарифа, а остальной части процесса хватает места. Если куча заполнится, Java выведетjava.lang.OutOfMemoryError, а панель покажет Вашему боту не хватило памяти. - Интенты: Discord4J подключается со всеми непривилегированными интентами, если вы не выберете другие. Пример
!pingиз README Discord4J читает текст сообщений, а для этого нужен привилегированный интент Message Content: включите его в Developer Portal, запросите в коде черезDiscordClient.create(token).gateway().setEnabledIntents(IntentSet.nonPrivileged().or(IntentSet.of(Intent.MESSAGE_CONTENT)))и отметьте для него Мой код это использует на нашем шаге Разрешения. Без него Discord присылает боту пустой текст сообщения, кроме личных сообщений и сообщений, где упомянут бот. Слэш-команде, как выше, ничего из этого не нужно. См. Как исправить «Used disallowed intents» у вашего Discord-бота. - Логи: Discord4J пишет логи через Reactor, который использует SLF4J, если SLF4J есть в jar, а Discord4J приносит SLF4J с собой. Без библиотеки логирования за ним, как в
pom.xmlвыше, SLF4J при старте выводит три строки предупреждений, последняя из нихSLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details., а затем отбрасывает собственные строки логов Discord4J, включая ошибки. Ваши строкиSystem.outпо-прежнему видны в Console. Чтобы видеть строки Discord4J, добавьте библиотеку логирования; документация Discord4J рекомендует Logback. - Заставьте
main()ждать. Discord4J реактивный: его вход представляет собойMono, который подключается, когда на него кто-то подпишется. Примеры в его README заканчиваютmain()вызовомgateway.onDisconnect().block()илиblock()уwithGateway(...), и они ждут, пока бот подключён. Бот выше используетwithGateway(...).block(). - Регистрировать команды при каждом запуске можно. Discord считает создание команды с именем, которое ваше приложение уже использует, обновлением этой команды, поэтому бот выше не копит копии
/ping. - Сбои: когда бот завершается, как бот выше при отклонённом токене, панель сразу запускает его снова. Если он остановится ещё раз в течение минуты, он останется остановленным, а Console покажет причину.
Запуск самостоятельно на Linux VPS
VPS нужна только среда Java, потому что jar вы собираете на своём компьютере. На Debian 13 или Ubuntu 24.04 установите Java 21; в Debian 12 есть Java 17, и она тоже запускает jar выше:
sudo apt update
sudo apt install openjdk-21-jre-headless
java -version
Создайте пользователя для бота и скопируйте jar на сервер (например, через scp), затем в его папку:
sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp bot.jar /opt/mybot/
sudo chown -R mybot: /opt/mybot
Храните токен вне кода, в файле, который может читать только root:
sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env
Создайте /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
Запустите службу сейчас и при каждой загрузке, затем следите за её выводом:
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f
Restart=always запускает бота снова через 5 секунд после того, как он завершился или упал, но не после того, как вы остановили его командой systemctl stop. На VPS -XX:MaxRAMPercentage задаёт долю памяти всей машины, поэтому уменьшите его, если там работают другие программы. Чтобы обновить бота, скопируйте новый jar поверх старого и выполните sudo systemctl restart mybot.
Свой сервер или тариф для ботов
На VPS, которым вы управляете сами, на вас лежит:
- Обновление и безопасность операционной системы, а также обновление Java.
- Копирование каждого нового jar, файл службы, файл с токеном и его права.
- Чтение
journalctl, чтобы выяснить, почему бот остановился. - Резервные копии всего, что хранит ваш бот.
Взамен VPS запускает всё, что вы на неё установите.
На тарифе для ботов PlayNHost это делает панель:
- Java 17, 21 или 25 из списка, с уже заданными лимитом кучи и сборщиком мусора.
- Токен, который проверяется в Discord перед сохранением, хранится в зашифрованном виде и передаётся вашему коду как
DISCORD_TOKEN. - Ссылка-приглашение с выбранными вами правами и карточка Привилегированные интенты, которая проверяет, какие из них включены в вашем Developer Portal.
- Повторный запуск бота после сбоя и баннер над Console, когда ему не хватает памяти.
- Загрузка из браузера и резервные копии из панели.
Частые вопросы
Мой бот на Discord4J онлайн, но !ping ничего не делает. Почему?
Потому что текст сообщения пустой. Discord4J по умолчанию запрашивает только непривилегированные интенты, а чтение текста сообщений на серверах требует Message Content, привилегированного интента. Включите его в Developer Portal и запросите через setEnabledIntents, как показано выше, или используйте слэш-команду вроде /ping в боте на этой странице: ей привилегированный интент не нужен.
Discord4J или JDA в PlayNHost?
Оба работают на одном и том же типе бота Java, из одного и того же вида jar. В таблице выше указана память, которую мы измерили для каждого. Настоящее различие в стиле: Discord4J построен на Reactor, поэтому вы связываете в цепочку Mono и Flux, а JDA использует слушатели и колбэки. Выберите тот, чей код вам легче читать. Шаги для JDA: Как запустить Discord-бота на Java.
Какую версию Java выбрать для Discord4J?
Java 21, рекомендуемую, если только вашему коду не нужна 25. Сам Discord4J работает начиная с Java 8, поэтому ограничение задаёт release, с которым вы собираете: jar, собранный для более новой Java, чем на сервере, останавливается с UnsupportedClassVersionError. Выберите более новую Среда выполнения или соберите с меньшим release.
Почему мой jar с Discord4J такой большой?
Потому что в нём лежит всё: Discord4J приносит Reactor, Netty, Jackson и собственные голосовые модули, а сборка jar-with-dependencies упаковывает их все. Jar в нашем тесте весил 37 МБ. Это место на диске вашего тарифа; память, которую занял работающий бот, указана в таблице выше.
Готовы запустить своего бота на Discord4J круглосуточно? Посмотрите тарифы на странице Хостинг Discord-ботов.



