【Discord Bot】01: 建立一個自己的聊天機器人

從開始使用Discord大概3~4年了，Discord的功能真的是非常強大完整，不管是遊戲群組、實況主社群，或是幣圈都非常喜歡使用Discord，而這半年參與了很多幣圈項目，也看到非常多強大的Discord bot，無論是玩小遊戲(大逃殺、德州撲克)，還是即時追蹤各種鏈上資訊(錢包交易、合約讀寫)，或是協助MOD的管理機器人，我覺得Discord加入機器人後完全是另一個世界啊✨ 因此自己就稍微研究了一下怎麼部署一個bot，並整理下來!

建立Discord Bot

要使用Discord bot當然要有自己的Discord帳號，接著到Discord Developer Portal申請一個application，這個名字以後都可以進行更改。

接著點選左側的Bot並新增一個Bot，將頭像旁邊的Token記錄下來(若沒出現可以點選Reset Token)

到Bot頁面最底下選取需要的權限，不同權限對應不同的編碼。

將General Information裡面的APPLICATION ID以及剛剛產生的權限碼分別替換下面的APPLICATION_ID、PERMISSIONS_INTEGER，產生的網址就可以將你的bot加入你自己的server。

1	https://discordapp.com/oauth2/authorize?&client_id=APPLICATION_ID&scope=bot&permissions=PERMISSIONS_INTEGER

利用Discord.js與機器人互動

Prerequisite

整個bot是基於Node.js的架構去編寫，所以需要先安裝Node.js的環境，若還沒下載可以參考之前的這篇文章
新增一個Folder存放所有檔案(ex: Demo-bot/)

下載Discord.js

在Demo-bot/按照指令依序執行:

1 2	npm init -y npm install discord.js

Initial files

分別建立 config.json、index.js

config.json: 記錄clientId(上面的Application ID), guildId(如何找到伺服器ID?), token(圖二)

{
    "clientId":"YOUR_APPLICATION_ID",
    "guildId": "YOU_SERVER_ID",
    "token": "YOUR_TOKEN"
}

index.js: main file，將來執行機器人的主要文件

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

// Create a new client instance
const client = new Client({ intents: [GatewayIntentBits.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);

新增完兩個文件後，執行 node index.js，若console出現 Ready! 就代表bot成功運行!
目前的檔案架構:

Demo-bot/
├── node_modules/
├── config.json
├── index.js
├── package-lock.json
└── package.json

一切就緒後，就可以註冊指令讓bot在Discord內和大家互動了!

建立互動指令

首先需要安裝 @discordjs/rest

1	npm install @discordjs/rest

並建立 deploy-commands.js 用來處理指令。

const { SlashCommandBuilder, Routes } = require('discord.js');
const { REST } = require('@discordjs/rest');
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: '10' }).setToken(token);

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

執行 node deploy-commands.js 完成指令註冊，往後只要更動過指令就需要重新執行一次。

經過註冊的指令才可以在discord裡面跳出提示框(如下圖)

回到 index.js 加入事件監聽:

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

const client = new Client({ intents: [GatewayIntentBits.Guilds] });

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

+ client.on('interactionCreate', async interaction => {
+ 	if (!interaction.isChatInputCommand()) 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);

到此就完成最基本的Discord bot了，可以自動回覆關鍵字~ 接下來會講一下 Command handling、Event handling，雖然不是必要的內容，但會讓整個專案架構比較系統化，不會讓code又臭又長!

Che Blog