Как создать свой первый бот Discord с Node.js

Обратите внимание на разницу между обеими командами:

• msg.reply : msg.reply исходного пользователя, отправившего сообщение
• msg.channel.send : отправляет сообщение на канал, не отмечая никого.

Попробуйте запустить бота с node index.js и отправить сообщение ping на general канал. Проверьте, видите ли вы тот же результат.

Ищите пользователей с тегами

Чтобы добавить новую команду, мы должны расширить предложение if с помощью else … if :

 if (msg.content === 'ping') { msg.reply('pong'); msg.channel.send('pong'); } else if (msg.content.startsWith('!kick')) { if (msg.mentions.users.size) { const taggedUser = msg.mentions.users.first(); msg.channel.send(`You wanted to kick: ${taggedUser.username}`); } else { msg.reply('Please tag a valid user!'); } } 

Допустим, мы хотим кого-то пнуть, отправив сообщение типа !kick @username . Итак, сначала мы ищем !kick в содержании сообщения. Если мы находим сообщение, начинающееся с !kick , мы можем проверить, были ли пользователи помечены в сообщении свойством msg.mentions.users .

Если есть пользователи с тегами, мы можем выбрать первого упомянутого пользователя с помощью msg.mentions.users.first() . Далее мы отвечаем на канал с именем пользователя в сообщении.

Шаг 6: Проблема с else … if цепь

Далее, давайте обсудим проблему со всеми этими else … if утверждениями. Если у вас есть только несколько команд, определенных для прослушивания в событии сообщения, код вполне читабелен.

Однако, когда мы решаем построить обширный проект таким образом, мы в конечном итоге получаем цепочку else … if утверждений. Вот небольшой список причин, почему вы не должны использовать else … if цепочки для чего-то, что не маленький проект:

• легче стать жертвой кода спагетти
• код трудно читать
• это не легко отладить
• сложно организовать код
• по мере роста кода его нелегко поддерживать.

Поэтому давайте посмотрим на шаблон команды, который мы можем использовать.

Реализация обработчика команд

Обработчик команд — это подход, который поддерживается пакетом discord.js . Прежде чем мы продолжим, ознакомьтесь с advanced веткой с помощью git checkout advanced . Эта ветвь содержит реализацию обработчика команд.

Папка команд

Сначала давайте рассмотрим папку команд. Эта папка содержит файл index.js который экспортирует все команды, которые мы определим. Для простоты мы определим только одну команду, ping :

 module.exports = { Ping: require('./ping'), }; 

Далее, давайте посмотрим на реализацию команды ping , которая в основном экспортирует объект, который содержит следующее:

• name : имя команды.
• description : рекомендуется добавлять описание для каждой команды.
• execute : функция, которая принимает msg и args . Эта функция содержит ту же логику, что и в нашей цепочке else … if .

 module.exports = { name: 'ping', description: 'Ping!', execute(msg, args) { msg.reply('pong'); msg.channel.send('pong'); }, }; 

Импорт команд

Продолжая, давайте импортируем команды в файл index.js . Обратите внимание, что мы определяем коллекцию команд на боте Discord. Мы перебираем все команды и добавляем их одну за другой в коллекцию команд.

Функция bot.commands.set принимает имя команды и весь объект команды:

 const Discord = require('discord.js'); const bot = new Discord.Client(); bot.commands = new Discord.Collection(); const botCommands = require('./commands'); Object.keys(botCommands).map(key => { bot.commands.set(botCommands[key].name, botCommands[key]); }); 

После этого мы должны удалить нашу цепочку else … if и заменить ее динамическим кодом, чтобы найти правильную команду, которую мы хотим вызвать:

 bot.on('message', msg => { const args = msg.content.split(/ +/); const command = args.shift().toLowerCase(); console.info(`Called command: ${command}`); if (!bot.commands.has(command)) return; try { bot.commands.get(command).execute(msg, args); } catch (error) { console.error(error); msg.reply('there was an error trying to execute that command!'); } }); 

Сначала мы пытаемся разделить содержимое сообщения по .split(/ +/) используя .split(/ +/) . Мы предполагаем, что первым элементом в этом массиве args является наша команда. Чтобы проверить, существует ли команда в нашей коллекции, коллекция предоставляет функцию has() , которая просто возвращает true или false. Если команда не существует, мы возвращаем пустой ответ.

Однако, если команда существует, мы используем функцию get() чтобы получить правильную команду и выполнить ее с входными параметрами msg и args .

Это простой для чтения, динамический способ вызова команд без написания спагетти-кода. Это позволяет вам масштабировать ваш проект до нескольких сотен команд, если это необходимо.

Опять же, если вы хотите протестировать новую версию нашего кода, не забудьте проверить advanced ветку с помощью git checkout advanced . Затем установите все зависимости с помощью npm install и запустите бот с node index.js .

Завершение

Поначалу установка и настройка нового бота Discord может показаться слишком сложной. Однако API, предлагаемый пакетом discord.js , прост, и на сайте Discord есть отличные примеры .

Поскольку в этом руководстве рассматриваются только два разрешения, можно найти гораздо больше. Вы можете узнать больше о разрешениях на сайте Discordjs.guide .

Удачи в создании вашего первого бота Discord!