В предыдущем разделе вы добавили игру на панель, импортировав egg-файл. Чтобы бот в Discord работал круглосуточно, сначала нужно создать его в Discord, а затем запустить его код таким же образом - как сервер, построенный на основе egg-файла Node.js или Python.
Бот Discord - это обычная программа, которая устанавливает постоянное соединение с Discord и реагирует на события. У него нет веб-страницы, и он не принимает входящий трафик. Благодаря этому он идеально подходит для размещения на платформе хостинга игр: панель управления обеспечивает его работу, перезапускает его после сбоя, отображает его журналы и ограничивает объем памяти, точно так же, как и в случае с игрой.
Создать бота в Discord
Вся информация, позволяющая Discord идентифицировать бота, хранится в Портал для разработчиков Discord. Войдите в систему с помощью своей учетной записи Discord, создайте приложение, добавьте в него бота и сгенерируйте его токен. Токен - это пароль бота: любой, кто его знает, может управлять ботом, а Discord отображает его только в момент генерации, поэтому сразу скопируйте его в менеджер паролей.
Прежде чем загружать код бота в Git: убедитесь, что токен нигде не фигурирует ни в коде, ни в репозитории. Для проверки выполните поиск первых символов токена в файлах, поскольку токен, загруженный в общедоступный репозиторий, следует рассматривать как утечку и сгенерировать его заново на портале.
В этом разделе токен вообще не фигурирует в коде. Панель сохраняет его в переменной и передает боту в виде переменной среды с именем DISCORD_TOKEN, который присутствует в обоих приведенных ниже примерах.
Напишите минималистичный бот
Этого одного крошечного бота на двух языках вполне достаточно для тестирования всего конвейера: он регистрирует /ping команда и ответы Pong!. Файлы бота помещаются в репозиторий Git на GitHub или любом другом хостинге Git, поскольку установка egg осуществляется путем клонирования этого репозитория.
Node.js с discord.js
Бот на Node.js состоит из двух файлов. Первый из них - package.json, в котором указана эта зависимость. В нём версия discord.js зафиксирована на серии 14, а текущая версия 14.27.0 требует Node 18 или более поздней версии:
{
"name": "my-discord-bot",
"version": "1.0.0",
"main": "index.js",
"dependencies": {
"discord.js": "^14.27.0"
}
}
Второй - это index.js. Он создаёт клиент, регистрирует команду, как только клиент готов, отвечает на неё и входит в систему с помощью токена из переменных среды:
const { Client, Events, GatewayIntentBits } = require("discord.js");
const client = new Client({ intents: [GatewayIntentBits.Guilds] });
client.once(Events.ClientReady, async (readyClient) => {
await readyClient.application.commands.create({
name: "ping",
description: "Replies with Pong!",
});
console.log("Logged in as " + readyClient.user.tag);
});
client.on(Events.InteractionCreate, async (interaction) => {
if (interaction.isChatInputCommand() && interaction.commandName === "ping") {
await interaction.reply("Pong!");
}
});
client.login(process.env.DISCORD_TOKEN);
Python с использованием discord.py
У бота на Python также есть два файла. requirements.txt содержит список библиотек, текущая версия которой - discord.py 2.7.1:
discord.py>=2.4
И bot.py выполняет ту же самую работу, что и версия на JavaScript:
import os
import discord
from discord import app_commands
client = discord.Client(intents=discord.Intents.default())
tree = app_commands.CommandTree(client)
@tree.command(name="ping", description="Replies with Pong!")
async def ping(interaction: discord.Interaction):
await interaction.response.send_message("Pong!")
@client.event
async def on_ready():
await tree.sync()
print(f"Logged in as {client.user}")
client.run(os.environ["DISCORD_TOKEN"])
Разместите каждый бот в отдельном репозитории. Публичный репозиторий можно клонировать без ввода учетных данных. Для частного репозитория требуются имя пользователя и токен доступа; в скрипте egg есть переменные для обоих параметров, которые приведены ниже.
Импортируйте пакеты Node.js и Python Eggs
Ни одна из сред выполнения не поставляется в комплекте с панелью, поэтому импортируйте их, как описано в предыдущем разделе. Универсальные модули из каталога проекта охватывают обе среды: node.js - общие сведения и Python - общие сведения. Скачайте два файла JSON, создайте гнездо с названием «Discord Bots» и импортируйте в него оба «яйца».
Оба «egg» работают одинаково. При установке они клонируют репозиторий Git в папку на сервере и устанавливают зависимости, а при каждом запуске - если включена переменная «Auto Update» - загружают последнюю версию кода, устанавливают отсутствующие пакеты и запускают главный файл. Egg для Node.js предоставляет образы Docker от Node 12 до Node 25, а egg для Python - версии Python от 2.7 и 3.7 до 3.13.
Добавить переменную для токена
Стандартные модули «egg» знают адрес репозитория Git, ветку и главный файл, но ничего не знают о Discord. Токен хранится в новой переменной в каждом модуле «egg». Откройте вкладку «Переменные» модуля «egg» и выберите «Создать новую переменную». Имя переменной среды должно быть точно таким же, как DISCORD_TOKEN, потому что именно так написано в коде.
Правило ввода required|string приводит к тому, что панель отказывается создавать сервер без токена. Поле «Права доступа» определяет, что владелец сервера может делать с переменной. Новая переменная изначально не имеет ни одного из этих прав, что полностью скрывает её от владельца, поэтому выберите «Пользователи могут просматривать» и «Пользователи могут редактировать», если владелец бота вставляет свой собственный токен. Оставьте эти поля незаполненными, чтобы токен оставался под контролем администратора.
Повторите переменную в пакете Python egg, используя то же имя и то же правило.
Создание серверов ботов
Для создания сервера бота используется та же форма, что и ранее, но с меньшими ограничениями. В этом руководстве каждому боту выделяется 512 MiB памяти, 1500 MiB дискового пространства и половина потока ЦП, что подходит для бота, который только ожидает событий. Выберите раздел «Discord Bots», затем «egg», а затем образ Docker - Node 24 для первого бота и Python 3.13 для второго.
Нужен ли боту порт?
Нет. Бот открывает исходящее соединение с Discord, но обратное соединение не устанавливается. Панель по-прежнему запрашивает по одному адресу на каждый сервер, поэтому боты берут адреса 3000 и 3001 из диапазона, созданного в части 2, и ничто никогда не прослушивает эти адреса. Боту не нужен собственный публичный IPv4-адрес.
Важны именно те переменные, которые находятся внизу формы. Для бота Node.js в поле «Адрес репозитория Git» укажите HTTPS-адрес репозитория, а в поле «Основной файл» - index.js, а также токен бота Discord к токену из портала. Для бота на Python основной файл называется «App.py» и содержит bot.py.
Для частного репозитория заполните поля «Имя пользователя Git» и «Токен доступа Git». Скрипт установки переписывает адрес, добавляя в него эти данные, поэтому в этом случае используйте HTTPS-адрес репозитория.
Ознакомьтесь с вкладкой «Startup» и консолью
Как только контейнер установки клонирует репозиторий и устанавливает зависимости, сервер запускается автоматически. На вкладке «Запуск» отображается, какие процессы будет запускать сервер и с какими параметрами. В случае с пакетом Node.js egg команда запуска загружает репозиторий, если включена функция «Автообновление», устанавливает все дополнительные пакеты, запускает npm install когда а package.json существует и запускает главный файл.
На вкладке «Файлы» отображается информация о том, что было скопировано установщиком. Для бота Node.js это index.js, package.json, и node_modules папка, а также скрытые .git папка, из которой переменная «Автообновление» сможет впоследствии извлечь данные.
Консоль - это место, где бот сообщает о том, что он находится в сети. При наличии действительного токена первой строкой после запуска будет Logged in as сообщение из кода, и бот отвечает /ping на любом сервере, к которому он присоединился. Если токен когда-либо будет отклонен, в консоли отобразится собственное сообщение Discord, например: An invalid token was provided, поэтому вставьте токен ещё раз на вкладке «Запуск» и нажмите «Пуск».
Демон также отслеживает работу процесса. Он отказывается перезапускать сервер, если с момента его последнего сбоя прошло менее минуты, что предотвращает бесконечный цикл перезапусков неисправного бота, а переменная «Auto Update», установленная в значение 1, загружает новые коммиты из репозитория при каждом запуске.
Если вы увидите ts-node В трассировке стека Node.js нет никаких ошибок: команда запуска egg сверяет имя главного файла с текстом в кавычках *.js, поэтому он обрабатывает файлы с помощью ts-node, который также поддерживает обычный JavaScript. Используйте имя файла, заканчивающееся на .ts если вы пишете бота на TypeScript.
В заключение
- Бот Discord - это постоянно работающая программа, которая подключается к Discord, поэтому ей требуется выделенный ресурс, но не нужен публичный IPv4-адрес.
- Универсальные пакеты для Node.js и Python клонируют репозиторий Git, устанавливают его зависимости и запускают главный файл.
- A
DISCORD_TOKENПеременная в поле «яйцо» не позволяет поместить токен в репозиторий. - В консоли отображается строка входа в систему бота, а демон не перезапускает сервер, который вышел из строя менее минуты назад.
В следующем разделе вы присвоите серверу Minecraft собственный публичный IPv4-адрес через туннель Taipan.