Discord Bot - ep.1 (建立Discord機器人)

Discord 機器人範例圖片

前置作業

安裝 Node.js®

請先至 Node.js® 下載並安裝

安裝後,開啟 CLI介面 並輸入

1
node -v && npm -v

檢查是否出現版本號,確認是否安裝成功

安裝 VSCode

請先至 Visual Studio Code - Code Editing. Redefined 下載並安裝

在桌面創建 Discord 資料夾

請按照以下步驟在桌面上創建一個 Discord 資料夾:

  • 在桌面上右鍵點擊空白處
  • 選擇 New(新建)
  • 選擇 Folder(資料夾)
  • 命名資料夾依個人喜好進行設定


建立開發環境

安裝 discord.js

請先打開 VSCode 並使用 ctrl + ~ 打開終端機

在終端機中輸入以下指令來初始化你的機器人並安裝 discord.js 套件:

1
2
3
npm init -y		//初始化機器人

npm i discord.js //安裝discord.js

這將初始化你的機器人,並在資料夾中創建 package.json 檔案,同時下載並安裝 discord.js 套件。

在這個過程中,你還將得到三個檔案:

功能分別是

  • node_modules 用來存放下載好的第三方套件
  • package.json 套件的資訊清單檔 包含套件的所有中繼資料,包括相依性、標題、作者等
  • package-lock.json 鎖定安裝模塊的版本號

這些檔案和資料夾將有助於管理你的機器人的相依套件和版本。確保不要刪除或更改它們,以免導致機器人的正常運作受到影響。

現在,你已經成功在桌面的 “Discord” 資料夾中建立了開發環境,並安裝了 discord.js 套件,準備開始編寫你的 Discord 機器人程式碼。


申請 Discord 機器人

創建機器人

請按照以下步驟在 Discord 開發者門戶網站上創建一個 Discord 機器人:

獲取機器人 token

以下是獲取機器人令牌的步驟:

  • 在你創建的應用程式頁面中,選擇 “Bot” 選項
  • 點擊 “Add Bot” (若已自動新增可忽略)
  • Token 區域,點擊 Reset Token 按鈕,然後確認重設

  • 點擊 Copy 按鈕以複製機器人令牌。

打開 VSCode 並新增 config.json 檔案並將Token放入

![]https://imgur.com/9KqRnJa.jpg)

撰寫 Discord 機器人程式

啟動機器人

請按照以下步驟編寫 index.js 以啟動 Discord 機器人:

1
2
3
4
5
6
7
8
9
10
11
12
const { Client, GatewayIntentBits } = require('discord.js');
const { token } = require("./config.json"); // 從 config.json 檔案中獲取機器人token

const client = new Client({
intents: [GatewayIntentBits.Guilds], // 設置機器人的 GatewayIntents
});

client.once('ready', () => {
console.log(`已登入帳號:${client.user.tag}!`); // 當機器人成功登入後,在控制台輸出登入訊息
});

client.login(token); // 使用機器人token登入 Discord

使用以上程式碼後,在終端機中執行 node .node index.js 即可啟動你的 Discord 機器人

程式碼可以讓你的機器人登入 Discord,並在收到訊息內容為 “ping” 時回覆 “Pong!”

你可以根據需要擴展這個程式碼,並添加更多的事件處理程序和指令來定製你的機器人功能


邀請機器人進入 Discord 群組

邀請連結取得方式

要邀請機器人進入你的 Discord 群組,需要以下步驟:

  • Discord Developer Portal — Documentation — Intro ,找到你創建的機器人應用程式
  • 選擇左側選單中的 OAuth2
  • Scopes 區域中,勾選 bot
  • Bot Permissions 區域中,選擇機器人需要的權限。根據你的機器人的功能,選擇適當的權限
  • Scopes 區域下方,將自動生成一個授權連結
  • 點擊 Copy 按鈕以複製授權連結
  • 現在,你可以將複製的授權連結發送給你的 Discord 群組管理員或其他成員,讓他們使用連結邀請你的機器人進入群組

當機器人被成功邀請進入群組後,你的機器人將在該群組中顯示為一個成員,並可以開始使用它的功能

請注意,你需要管理員權限或適當的權限才能邀請機器人進入群組。同時,確保你的機器人已經在開發者門戶網站上正確設置了適當的權限和範圍,以便在群組中執行所需的操作