[Spring Boot] Discord Bot(디스코드 봇) 만들기

 

 

 

 

전자정부 표준 프레임워크의 양대 핵심 기술 세트 : 스프링 + 마이바티스

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

 

 

 

🗂 목차

1. [Spring Boot] Discord Bot(디스코드 봇) 만들기
2. [Spring Boot] Discord Bot(디스코드 봇) 만들기 - Spring Boot(스프링 부트)를 이용한 간단한 API 만들기 feat.Mybatis(마이바티스)

3. [Spring Boot] Discord Bot(디스코드 봇) 만들기 - JAVA를 이용한 API 호출

4. [Spring Boot] Discord Bot(디스코드 봇) 만들기 - 디스코드 봇을 이용하여 API 호출

 

 

 

 

 

GitHub - junyharang-personal-project/juny-discord-bot-test: JDA를 이용한 Spring Boot Discord Bot 연습이에요.

 

 

 

 

 

 

🚀 초기 구성

최초 디스코드 봇을 등록하고, 주니가 만든 Server(서버)에 초대하는 부분을 해주어야 해요.

Discord Developer Portal — API Docs for Bots and Developers

 

최초 위 Site(사이트)에 접속해 줍니다.

최초 로그인을 하면 이런 Page(페이지)를 만날 수 있어요.

이 곳에서 위 오른쪽에 New Application을 눌러 줍니다.

위와 같이 이름을 정의해주고, 이용 약관에 동의를 해 준 뒤 Create를 눌러 줍니다.

Bot Tab으로 이동하여 Add Bot 버튼을 클릭하여 줄게요.

Yes, do it! 을 눌러 줍니다. 

MESSAGE CONTENT INTENT를 위와 같이 허용을 해주어야 디스코드에서 메시지를 입력했을 때, 스프링 부트에서 받을 수 있어요.

만약 이렇게 하지 않는다면 스프링 부트에서는 공백값만 들어오게 될거에요.

이거 찾느라 많이 고생했어요...

 

 

 

 

이렇게 하면 Bot이 만들어 진걸 확인 할 수 있어요.

그런 뒤 TOKEN에 COPY를 누르면 BOT 관련 TOKEN 값을 얻을 수 있어요.

실제 JAVA에서 이 TOKEN 값을 써야 하기 때문에 잘 저장해 두어야 해요.

 

그럼 위와 같이 APPLICATION ID, PUBLIC KEY가 만들어진 걸 확인할 수 있어요.

OAuth2 Tab에 들어가 보면 위와 같이 CLIENT ID를 얻을 수 있어요.

 

OAuth2 -> URL Generator

 

이 곳에서 BOT에 권한도 설정해 줄 수 있어요.

OAuth2 -> URL Generator

 

주니는 위와 같이 BOT에게 권한을 주려고 해요.

OAuth2 -> URL Generator

 

밑에 위와 같이 URL이 하나 만들어질텐데, 그걸 브라우저에 입력 해 줍니다.


 

url :&nbsp;https://discord.com/api/oauth2/authorize?client_id=&nbsp;&permissions=8&scope=bot https://discord.com/api/oauth2/authorize?client_id=<CLIENT ID>&permissions=8&scope=bot

접속을 하면 위와 같은 페이지로 이동할 수 있어요.

위와 같이 추가할 디스코드 서버를 선택하고, 승인을 눌러 줍니다.

 

주니가 만든 test-bot이 채널에 들어온 걸 확인할 수 있어요.


이제 Bot 준비를 완료하였으니 스프링 부트 Project(프로젝트)를 만들어 주도록 할게요.

주니는 InteliJ Ultimate (인텔리제이 얼티메이트) Version(버전)을 통해 위와 같이 프로젝트를 만들어 주려고 해요.

스프링 부트 버전과 Dependency(의존성)은 이렇게 설정을 하고 시작해 보려고 해요.

GitHub - DV8FromTheWorld/JDA: Java wrapper for the popular chat & VOIP service: Discord https://discord.com

주니는 JDA라는 것을 이용해서 개발을 즐겨보려고 해요.

 

 

build.gradle

 

 

JDA 의존성을 build.gradle에 추가해 주었어요.

repositories {
  mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    compileOnly 'org.projectlombok:lombok'
    developmentOnly 'org.springframework.boot:spring-boot-devtools'
    runtimeOnly 'com.h2database:h2'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    // Discord Bot 사용을 위한 JDA 의존성
    implementation 'net.dv8tion:JDA:5.0.0-beta.5'
}

반응형

 

이제 즐겁게 코딩을 즐겨 볼게요.

 

 

    🔽  코드 작성 및 초기 설정

application.yml

 

최초 디스코드 봇 Token(토큰) 값을 안전하게 관리하기 위해 application.yml에 위와 같이 값을 넣어 주었어요.

com/junyss/discordbottest/DiscordBotTestApplication.java 1 ~ 30번째 줄

 

최초 위와 같이 main()이 있는 곳에 Login이 안 되었을 때 처리를 위한 LoginException을 처리하도록 해 주었어요.

20~22번째 줄 코드는 application.yml에 입력한 Token값을 main()에서 가져오게 하기 위해 만든 부분이에요.

24번째 줄에 JDABuilder를 통해 application.yml에 입력된 Token값을 가져오게 해줍니다.

25번째 줄에 문자열을 넣게 되면 

위와 같이 상태 메세지를 처리해 줄 수 있어요.

26번째 줄에 GatewayIntent를 통해 Message를 디스코드에서 받을 수 있도록 처리해 줘야 해요.

그런 뒤 27번째 줄에 EventListener에서 Listener 객체를 만들어 Message를 주고 받을 수 있게 처리해 줄 수 있어요.

com/junyss/discordbottest/DiscordBotTestApplication.java 32 ~ 40번째 줄

 

위 부분에서 application.yml에 있는 Token 값을 가져와서 Getter를 통해 main()에서 Token값을 가져올 수 있도록 처리해 주었어요.

 

 

com/junyss/discordbottest/listener/JunyssDiscordListener.java 1 ~ 28번째 줄

 

 

728x90

 

 

이번에는 실제로 메시지 처리를 담당할 DiscordListener를 만들어 주었어요.

18번째 줄에 매개 변수 event 안에 디스코드에서 메시지를 보낸 사람의 정보를 가져오도록 하여 주고,

19번째 줄에 봇이 메시지를 보낼 디스코드 Channel(채널) 정보를 가져올 수 있도록 하여 주었어요.

그런 뒤 20번째 줄에 디스코드 쪽에서 전달된 메시지를 받을 수 있는 변수들을 만들어 주었어요.

24번째 줄에 메시지 보낸 사람의 정보가 봇이라면 아무  동작을 하지 않도록 처리하여 주었고, 메시지로 들어온 내용이 공백이라면 27번째 줄 동작이 처리될 수 있게 해 주었어요.

com/junyss/discordbottest/listener/JunyssDiscordListener.java 1 ~ 28번째 줄

 

주니는 디스코드에서 들어온 메시지를 띄어쓰기 즉, 공백을 기준으로 잘라서 처리를 하고 싶었기 때문에 30번째 줄 처럼 공백을 기준으로 messageArray에 각각의 문자열이 들어갈 수 있도록 하여 주었어요.

그런 뒤 32번째 줄에 메시지의 첫번째 문자열이 주니야라면 34 ~ 38번째 줄 처리가 되도록 하여주었어요.

참고로 equalsIgnoreCase()는 대, 소문자를 구분하지 않고, 들어온 값을 식별하기 위해 사용하는 Method(메서드)에요.

34번째 줄을 보면 messageArray에 값 중 맨 첫 배열값인 주니야는 이제 필요가 없기 때문에 해당 값을 제외한 나머지 문자열들을 새롭게 messageArgs 배열에 넣어 주었어요.

36번째에 해당 문자열 배열 개수만큼 반복하게 하여 sendMessage()에서 event와 메시지 내용을 받아 봇이 반환할 메시지를 만들어 반환받을 수 있도록 해 주었어요.

그런 뒤 38번째 줄에 반환 받은 봇에 대답을 디스코드 해당 채널로 보내질 수 있게 해 주었어요.

com/junyss/discordbottest/listener/JunyssDiscordListener.java 43 ~ 60번째 줄

 

이 곳에서 디스코드 봇이 대답할 문자열을 만들어 줄 수 있게 해 주었어요.

45번째 줄에 event.getAuthor()를 통해 메시지를 보낸 사용자의 정보를 가져올 수 있는 객체를 user 변수에 넣어 주었고, 봇이 반환할 대답 문자열 변수 returnMessage를 공백으로 초기화 해 주었어요.

그런 뒤 매개 변수로 전달된 message 즉, 사용자가 보낸 메시지를 가지고, 분기문(switch)가 처리 되도록 하였는데, 안녕 이라는 문자열이 들어온다면 대답 문자열 변수에 보낸 사용자가 설정한 디스코드 이름값과 함께 반환될 문자열을 넣어주었어요.

51번째 case에 사용자가 test라는 문자열을 보냈다면 사용자 계정의 Tag 정보값과 함께 문자열이 대답 문자열 변수에 들어갈 수 있도록 하여 주었어요.

 

마지막으로 누구야라는 문자열이 들어온다면 사용자를 Mention(멘션)하여 부른 뒤 뒤에 문자열이 들어갈 수 있도록 처리해 주었어요.

이렇게 디스코드를 통해 봇과 대화할 수 있는 프로그램을 만들어 보았어요.

다음에는 Data Base(데이터 베이스)에 저장된 값을 조회할 수 있는 기능을 만들어 보도록 할게요.

 

소스코드는 이 곳에 준비해 두었어요.

 

 

 

전자정부 표준 프레임워크의 양대 핵심 기술 세트 : 스프링 + 마이바티스

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

 

🧐 참고 자료

GitHub - DV8FromTheWorld/JDA: Java wrapper for the popular chat & VOIP service: Discord https://discord.com