discord.js bot 만들기 (1)

 

Node.js 설치하고 npm init

 

https://thebook.io/080229/

더북(TheBook): Node.js 교과서 개정 2판

 

 

https://discordjs.guide/preparations/#installing-node-js

discord.js Guide

 

 

discord.js 설치

npm install discord.js

 

 

https://discordjs.guide/preparations/#opening-the-terminal

discord.js Guide

 

bot application 설정

OAuth2 URL generator 로 가서 bot, applications.commands 선택 하고 Copy한 URL 들어가서 원하는 서버에 봇 초대! 

 

 

 

https://discordjs.guide/preparations/setting-up-a-bot-application.html#creating-your-bot

discord.js Guide

 

 

 

봇 코드 작성 시작

config.json 파일 만들어서 token 입력

 

{
	"token": "your-token-goes-here"
}

 

index.js

// Require the necessary discord.js classes
const { Client, Intents } = require('discord.js');
const { token } = require('./config.json');

// Create a new client instance
const client = new Client({ intents: [Intents.FLAGS.GUILDS] });

// When the client is ready, run this code (only once)
client.once('ready', () => {
	console.log('Ready!');
});

// Login to Discord with your client's token
client.login(token);

 

 

 

https://discordjs.guide/creating-your-bot/#creating-configuration-files

discord.js Guide

 

 

커맨드 생성

deploy-commands.js 파일을 생성함. 이 파일로 내 봇에 슬래시 커맨드를 등록하고 업뎃 한다.

 

npm 설치가 필요함 !

 

npm install @discordjs/builders @discordjs/rest discord-api-types

 

deploy-commands.js

 

const { SlashCommandBuilder } = require('@discordjs/builders');
const { REST } = require('@discordjs/rest');
const { Routes } = require('discord-api-types/v9');
const { clientId, guildId, token } = require('./config.json');

const commands = [
	new SlashCommandBuilder().setName('ping').setDescription('Replies with pong!'),
	new SlashCommandBuilder().setName('server').setDescription('Replies with server info!'),
	new SlashCommandBuilder().setName('user').setDescription('Replies with user info!'),
]
	.map(command => command.toJSON());

const rest = new REST({ version: '9' }).setToken(token);

rest.put(Routes.applicationGuildCommands(clientId, guildId), { body: commands })
	.then(() => console.log('Successfully registered application commands.'))
	.catch(console.error);

 

아래 명령어를 실행해서 커맨드를 내 길드에 등록하자! 한번만 실행하면 된다.

커맨드를 수정하거나 추가했을 경우 다시 실행해야 한다.

 

node deploy-commands.js

 

 

 

config.json  수정

• clientId: Discord Developter Portal / General Information 에서 APPLICATION ID
• guildId: 서버 ID

{
	"clientId": "123456789012345678",
	"guildId": "876543210987654321",
	"token": "your-token-goes-here"
}

 

index.js 수정

 

const { Client, Intents } = require('discord.js');
const { token } = require('./config.json');

const client = new Client({ intents: [Intents.FLAGS.GUILDS] });

client.once('ready', () => {
	console.log('Ready!');
});

client.on('interactionCreate', async interaction => {
	if (!interaction.isCommand()) return;

	const { commandName } = interaction;

	if (commandName === 'ping') {
		await interaction.reply('Pong!');
	} else if (commandName === 'server') {
		await interaction.reply(`Server name: ${interaction.guild.name}\nTotal members: ${interaction.guild.memberCount}`);
	} else if (commandName === 'user') {
		await interaction.reply(`Your tag: ${interaction.user.tag}\nYour id: ${interaction.user.id}`);
	}
});

client.login(token);

 

 

 

 

 

https://discordjs.guide/creating-your-bot/creating-commands.html#command-deployment-script

discord.js Guide

 

 

Command handling

내 봇 프로젝트의 규모가 작아도 하나의 파일에 커맨드를 if / else if 로 늘리는건 좋지 않다.

커맨드 핸들러를 구현하자!

 

npm install @discordjs/rest discord-api-types

 

index.js

 

const { Client, Intents } = require('discord.js');
const { token } = require('./config.json');

const client = new Client({ intents: [Intents.FLAGS.GUILDS] });

client.once('ready', () => {
	console.log('Ready!');
});

client.on('interactionCreate', async interaction => {
	if (!interaction.isCommand()) return;

	const { commandName } = interaction;

	if (commandName === 'ping') {
		await interaction.reply('Pong!');
	} else if (commandName === 'beep') {
		await interaction.reply('Boop!');
	}
});

client.login(token);

 

deploy-commands.js

 

const { REST } = require('@discordjs/rest');
const { Routes } = require('discord-api-types/v9');
const { clientId, guildId, token } = require('./config.json');

const commands = [];

const rest = new REST({ version: '9' }).setToken(token);

rest.put(Routes.applicationGuildCommands(clientId, guildId), { body: commands })
	.then(() => console.log('Successfully registered application commands.'))
	.catch(console.error);

 

 

commands 폴더를 만들자. 여기에 모든 커맨드를 저장할 것이다.

 

아까 설치 했는데, 또 설치 하라고 나옴(?)

 

npm install @discordjs/builders

 

 

commands/ping.js 파일을 만든다. execute() 함수 안에 아까 작성한 부분 추가

 

const { SlashCommandBuilder } = require('@discordjs/builders');

module.exports = {
	data: new SlashCommandBuilder()
		.setName('ping')
		.setDescription('Replies with Pong!'),
	async execute(interaction) {
		await interaction.reply('Pong!');
	},
};

 

 

index.js 파일에 다음을 추가

 

const fs = require('node:fs');
const path = require('node:path');
const { Client, Collection, Intents } = require('discord.js');
const { token } = require('./config.json');

const client = new Client({ intents: [Intents.FLAGS.GUILDS] });

client.commands = new Collection();

 

fs.readdirSync() 메소드는 디렉토리에서 모든 파일명 리스트를 리턴한다. e.g. ['ping.js', 'beep.js']

 

Dynamically executing commands

커맨드 실행을 세팅하는 client.commands Collection을 사용할 수 있다.

interactionCreate 이벤트 안에 if / else if 없애고 다음으로 대체하자.

 

먼저 Collection 에서 커맨드 네임으로 커맨드를 가져와서 command 변수에 할당한다.

해당 커맨드가 존재하면 .interaction 변수를 인자로 execute() 를  호출한다.

 

client.on('interactionCreate', async interaction => {
	if (!interaction.isCommand()) return;

	const command = client.commands.get(interaction.commandName);

	if (!command) return;

	try {
		await command.execute(interaction);
	} catch (error) {
		console.error(error);
		await interaction.reply({ content: 'There was an error while executing this command!', ephemeral: true });
	}
});

 

 

새로운 커맨드를 만드려면 commands 폴더에 새 파일을 만들면 된다.! (파일명은 슬래시 커맨드랑 동일하게)

그리고 커맨드를 등록하려면 node deploy-commands.js 실행시키는걸 잊지말자!

 

 

 

https://github.com/discordjs/guide/tree/main/code-samples/creating-your-bot/command-handling

GitHub - discordjs/guide: The official guide for discord.js, created and maintained by core members of its community

 

https://discordjs.guide/creating-your-bot/command-handling.html#individual-command-files

discord.js Guide