Discord Integration

Discord Integration 소개

Discord Integration은 마인크래프트 서버의 채팅을 디스코드 서버의 특정 채널과 연결해 주는 모드 겸 플러그인입니다. 게임 안에서 오간 대화가 디스코드 채널에 올라가고, 반대로 디스코드에서 쓴 메시지가 게임 채팅에 표시됩니다. 제작자는 이것이 클라이언트가 아닌 서버 채팅을 연결하는 도구라는 점을 강조하고 있어, 서버 관리자가 설치하는 프로젝트라고 이해하면 됩니다.

채팅 중계 외에도 죽음과 발전 과제 메시지 전달, 디스코드 계정과 마인크래프트 계정 연동, 화이트리스트 모드, 웹훅 모드 등 커뮤니티 운영에 쓸 만한 기능이 함께 들어 있습니다. Forge, NeoForge, Fabric 같은 모드 서버와 Paper, Spigot 플러그인 서버를 모두 지원해 서버 형태에 상관없이 비슷한 방식으로 디스코드를 붙일 수 있습니다.

Discord Integration 정보

항목	내용
종류	마인크래프트 플러그인 (모드 겸용)
제작자	ErdbeerbaerLP
지원 버전	1.12.2 ~ 26.2
플랫폼·로더	Fabric, Forge, NeoForge, Paper, Spigot
카테고리	관리, 소셜, 유틸리티
다운로드	27만 회 이상
최초 공개	2021-03-06
최근 업데이트	2026-09-13
라이선스	MIT
배포처	Modrinth

주요 특징

• 양방향 채팅 - 디스코드와 마인크래프트 사이에서 채팅 메시지를 주고받습니다.
• 게임 이벤트 알림 - 플레이어의 죽음과 발전 과제 달성 메시지를 디스코드로 전달합니다.
• 계정 연동 - 디스코드와 마인크래프트 계정을 연결할 수 있고, 화이트리스트 모드도 지원합니다.
• 명령어와 웹훅 - 초대 링크를 보내 주는 /discord 명령어, 웹훅 모드, 명령어 기능을 제공합니다.
• Forge 전용 감지 기능 - 서버 크래시와 플레이어 타임아웃 감지가 있으나 Forge 전용이며 항상 작동하지는 않을 수 있습니다.
• Dynmap 연동과 API - Dynmap 연동과 모드 개발자를 위한 메시지·명령어 API를 갖췄습니다.

서버 설정과 사용 방법

Discord Integration을 쓰려면 먼저 디스코드 봇을 만들어야 합니다. 제작자 안내에 따르면 봇에는 웹후크 수정, 메시지 보내기와 읽기, 채널 관리 권한이 필요하고, 봇 생성 페이지에서 Server Members Intent도 켜 두어야 합니다. 이 권한이 빠져 있으면 채팅 중계나 계정 연동이 제대로 동작하지 않을 수 있으니 처음 설정할 때 꼼꼼히 확인하세요.

Paper·Spigot 서버는 plugins 폴더에, Forge·NeoForge·Fabric 서버는 mods 폴더에 파일을 넣고 서버를 한 번 실행하면 설정 파일이 만들어집니다. 여기에 봇 토큰과 연결할 채널 정보를 입력한 뒤 재시작하는 것이 일반적인 흐름입니다. 세부 항목은 배포처의 빠른 설정 가이드를 따라가면 됩니다.

참고로 제작자는 현재 이 프로젝트가 "생명 유지" 상태라고 밝히고 있습니다. 대부분의 업데이트는 외부 기여로 들어오며 주로 새 마인크래프트 버전 지원 위주라는 뜻이므로, 큰 신규 기능보다는 꾸준한 버전 대응을 기대하는 편이 맞습니다.

디스코드 연동을 운영에 활용하는 방법

채팅 연동은 단순히 메시지를 옮겨 주는 것 이상으로 서버 커뮤니티 운영에 쓸모가 많습니다. Discord Integration의 기능을 바탕으로 다음과 같은 활용을 생각해 볼 수 있습니다.

• 전용 채널 운영 - 서버 채팅만 흘러가는 채널을 따로 만들면 일반 대화 채널이 어지러워지지 않습니다.
• 화이트리스트 관리 - 계정 연동과 화이트리스트 모드를 함께 쓰면 디스코드 멤버만 서버에 들어오게 할 수 있습니다.
• 활동 기록 - 죽음과 발전 과제 메시지가 남아 있어 접속하지 못한 멤버도 서버 소식을 따라갈 수 있습니다.
• 초대 안내 - 게임 안에서 /discord 명령어로 커뮤니티 초대 링크를 바로 받을 수 있게 해 둡니다.

일반적으로 채팅 연동 채널에는 슬로우 모드나 역할 제한 같은 디스코드 기본 기능을 함께 쓰면 도배를 줄이는 데 도움이 됩니다.

이런 분께 추천합니다

디스코드 커뮤니티와 게임 서버를 하나로 묶고 싶은 운영자에게 잘 맞습니다.

• 게임에 접속하지 않은 멤버도 서버 채팅을 보고 대화하길 원하는 분
• 디스코드 계정 연동으로 화이트리스트를 관리하고 싶은 분
• 모드 서버와 플러그인 서버를 모두 운영하며 같은 도구를 쓰고 싶은 분
• Dynmap을 쓰고 있어 연동 기능을 활용하고 싶은 분

다운로드 및 설치 방법

1. 서버 형태(Paper, Spigot, Forge, NeoForge, Fabric)와 게임 버전을 확인합니다.
2. 페이지의 Modrinth에서 다운로드 버튼으로 이동해 맞는 파일을 받습니다.
3. 플러그인 서버는 plugins, 모드 서버는 mods 폴더에 넣고 서버를 실행합니다.
4. 생성된 설정 파일에 디스코드 봇 토큰과 채널 정보를 입력한 뒤 재시작합니다.

클라이언트에는 설치할 필요가 없는 서버용 도구입니다. Fabric 서버라면 일반적으로 Fabric API가 필요한 경우가 많으니 함께 확인하세요.

자주 묻는 질문

플레이어도 설치해야 하나요?

아닙니다. 서버 채팅을 연결하는 도구이므로 서버에만 설치하면 됩니다.

크래시 감지는 모든 서버에서 되나요?

서버 크래시와 플레이어 타임아웃 감지는 Forge 전용이며, 제작자도 항상 작동하지는 않을 수 있다고 안내합니다.

메시지가 디스코드로 넘어가지 않아요.

봇 권한(웹후크 수정, 메시지 읽기·쓰기, 채널 관리)과 Server Members Intent 설정을 다시 확인해 보세요.

새 기능이 계속 추가되나요?

현재는 유지 관리 위주로, 주로 새 마인크래프트 버전 지원 업데이트가 이루어지고 있습니다.

마무리

Discord Integration은 서버 채팅과 디스코드 채널을 이어 커뮤니티를 하나로 묶어 주는 도구입니다. 계정 연동과 화이트리스트, 게임 이벤트 알림까지 갖춰 운영 편의도 높습니다. 봇 권한만 올바르게 설정해 서버와 디스코드를 연결해 보세요.