[Discord.js] Node.js를 활용해 디스코드 봇을 만들어 보자 (1)

안녕하세요. 디스코드에서 제공하는 API를 기반으로 만든 discord.js 를 이용하여 디스코드 봇을 간단하게 만들어보려 합니다. 첫번째 게시물에서는 node.js를 컴퓨터에 설치하는 법과 개발에 필요한 개발환경을 구축하고, 디스코드에 봇을 만들기 위한 설정들을 해주는 것으로 포스팅 해보려합니다.

1. node.js 설치

일단 node.js가 설치되어 있어야 패키지 매니저 및 디스코드 봇을 구동하는 코드를 실행 할 수 있기 때문에 반드시 먼저 설치하여야 합니다.
구글에 간단하게 nodejs 다운로드 라고 검색하여 받아도 되고, https://nodejs.org/ko/download 에 접속하여 개발하려는 운영체제에 맞게 설치하면 됩니다.
현재 블로그 포스팅을 하는 기점으로는 LTS (Long Term Support) 버전이 18.16.0 버전으로 가장 안정화 된 버전이라고 볼 수 있습니다. 또한 포스팅에서 사용할 discord.js의 v14 버전이 최소 v16.9.0 버전이상의 node.js를 요구하므로 본인이 추가로 설치할 패키지의 요구 버전을 확인해야 합니다.
이번에 저는 Windows O/S의 64bit 이므로 .msi 파일을 다운받아 설치하도록 하겠습니다.

별다른 것 없이 Next 만 누르고 설치를 진행하면 윈도우에 성공적으로 node.js를 설치 하였습니다. 설치의 마지막으로 정말 성공적으로 설치 되었는지 확인을 위해서는 다음과 같이 터미널(명령 프롬포트) 창을 열어 node -v, npm -v를 각각 입력해서 버전이 정상적으로 출력이 된다면 성공적으로 설치 하였다고 봐도 됩니다.

2. Visual Studio Code 설치하기

사실 IDE(Integrated Development Environment)는 정말 개인별로 취향이 갈리기 때문에 무조건 "어떤어떤 프로그램을 사용하여 개발하세요!"보다는 지금껏 본인이 가장 편하게 사용해왔던 IDE를 깔아서 사용하시는 것을 추천드립니다. 만약 잘 모르겠다는 분이 계신다면 Visual Studio Code를 검색하여, 다운 받아 설치하는 것을 추천 드릴 수 있을 것 같습니다.

우선 구글에 Visual Studio Code 혹은 vscode라고 입력 후 다운로드 페이지( https://code.visualstudio.com/download) 에서 프로그램 설치 파일을 다운 받습니다. node.js와 마찬가지로 본인이 가지고 있는 운영체제에 맞는 버전의 설치파일을 다운 받으면 됩니다.

별도로 작업 할 필요 없이 그냥 기존과 똑같이 다음 눌러서 설치한 후 Visual Studio Code를 성공적으로 실행 하면 됩니다.

3. 디스코드 봇 생성하기

먼저 디스코드 봇을 만들기 위해서는 디스코드 사이트에 로그인 하여, 개발자 사이트에서 봇 토큰을 생성해야 합니다. 디스코드 개발자 포털 ( https://discord.com/developers/applications) 에 접속하여 로그인 합니다.

성공적으로 로그인 하였다면 맨 오른쪽 상단에 New Application 버튼을 눌러 봇을 생성합니다. 저는 이미 만들어 놓고 테스트나 운영하는 봇이 몇 가지 있어 목록에 표시되고 있네요.

버튼을 눌러 새로운 팝업창에서 봇의 이름을 지어 줄 수 있고, 봇을 만드는데에 있어 디스코드 개발 약관에 동의를 체크한 후 Create 버튼을 눌러 봇을 생성 할 수 있습니다.

생성을 하고 나면 다음과 같은 페이지로 자동으로 이동이 될 텐데, 여기서 봇의 프로필 사진을 업로드하거나, 자세히 보면 PUBLIC KEY 라는 영문과 숫자로 조합된 봇 토큰을 얻을 수 있습니다. 지금은 제가 포스팅을 위해 공개해 이미지를 올려두었지만 github나 다른 사이트에 해당 "토큰"을 공유해 버린다면 개발하는 봇을 다른 개발자가 마음데로 사용할 수 있으므로 반드시 조심해야 합니다.

먼저 좌측의 메뉴 중 OAuth2에서 URL Generator를 눌러서 봇을 초대할 수 있는 코드를 생성함과 동시에 봇이 할 수 있는 권한을 부여해 줄 수 있습니다. 아마 혼자 봇을 개발하면서 "왜 똑같이 했는데 안되지?" 하고 구글링 해서 해결하시는 분들이 있을 수 있는데 이 권한 문제로 봇이 특정 이벤트를 감지하지 못하고 작동이 안하는 경우가 있습니다.

이번 포스팅에서 사용하는 봇은 대부분의 권한을 가질 수 있는 Administrator권한으로 설정하 였습니다. "SCOPES"와 "BOT PERMISSION"을 설정하고 나면 맨 밑에 화면에서 초대 URL이 생성된 것을 볼 수 있습니다.

그럼 이제 브라우저에서 저 URL을 복사 한 후 붙여주면 디스코드에서 본인이 관리자 혹은 생성자로 있는 서버를 골라 봇을 초대할 수 있습니다.

그러면 이제 디스코드가 새로운 채널에 추가 된 것을 디스코드 앱을 통해서 볼 수 있습니다. 이렇게 첫번째 포스팅으로 디스코드 개발 환경을 구축하고 디스코드 봇 토큰을 발급 받아 서버에 추가하는 것 까지 진행 하였습니다. 다음 포스팅에서는 기본적인 코드의 설명과 코드를 통해 봇을 실행하고 간단한 명령어를 사용하는 포스팅을 진행 해 보겠습니다. (아마 주말 마다 포스팅이 가능할 것 같네요..)

 

이와같은 내용은 Discord.js의 Guide에 첫번째 세션인 "INSTALLATIONS & PREPARATIONS" (https://discordjs.guide/preparations/) 에서 자세하게 확인 할 수 있습니다.