Minecraft 플러그인 EssentialsDiscord

🔌 EssentialsX Discord 소개

EssentialsX Discord(ESSentialsDiscord 모듈로 배포)는 Minecraft 서버와 Discord 서버를 연동하는 EssentialsX의 공식 모듈입니다. 핵심 EssentialsX 모듈과 함께 플러그인 JAR로 동작하며, 설정된 봇 토큰으로 Discord에 연결해 채팅과 이벤트를 전달하고, 작은 API를 기반으로 Discord 측 상호작용을 제공합니다.

🎯 목적

이 모듈의 핵심 목적은 두 가지입니다. 선택한 Minecraft 채팅/이벤트를 Discord 채널로 전달하고, 선택한 Discord 메시지/명령을 Minecraft 서버로 전달하는 것입니다. Discord와 EssentialsX 기반 Minecraft 서버 사이에서 직접적이고 설정 가능한 소통과 제한된 원격 제어를 원하는 서버 관리자를 위해 만들어졌습니다.

⚙️ 기능

• 메시지 유형별로 설정할 수 있는 채널 매핑(채팅, 입장/퇴장, 스태프 등).
• Minecraft 채팅을 Discord로 전달하고, 선택적으로 Discord 메시지를 Minecraft 채팅으로 전달.
• Discord 측 슬래시 명령으로 콘솔 명령 실행, 플레이어에게 메시지 전송, 플레이어 목록 표시 가능(설정 가능하며 역할로 제한됨).
• 세분화된 메시지 유형 시스템과 유형별 서식이 플러그인 설정에 정의됨.
• 제공되는 DiscordService API를 통해 사용자 지정 메시지 유형과 Discord 상호작용 명령을 등록할 수 있는 개발자용 API.

🧩 대상 사용자

• Discord ↔ Minecraft 채팅 동기화를 원하는 EssentialsX 사용 서버 소유자.
• 게임 내 스태프와 비공개 스태프 채널을 연결하고 싶은 운영팀.
• Discord에 간단한 상호작용이나 사용자 지정 메시지 훅을 노출하고 싶은 플러그인 개발자.

🏗️ 사용 예시

• 전역 채팅을 전용 Discord 채널로 보내면서 스태프 전용 Discord 메시지는 게임 내 스태프에게만 전달.
• 검증된 Discord 역할이 공개하지 않고도 설정된 서버 조회나 명령을 슬래시 명령으로 실행하도록 허용.
• 다른 플러그인이 EssentialsX Discord API에 사용자 지정 메시지 유형을 등록해 구조화된 알림을 Discord로 전송.

⌨️ 명령어

EssentialsX Discord는 일반적인 Minecraft 채팅 명령이 아니라, 설정 가능한 Discord 측 슬래시 명령(Discord에 등록됨)을 제공합니다. 이러한 명령(공식 문서의 예시 포함)은 Discord에서 실행되며 콘솔 명령 실행, 플레이어에게 메시지 전송, 플레이어 목록 표시가 가능합니다. 명령 사용 가능 여부와 고급 기능은 플러그인 설정의 역할/ID 구성으로 제어됩니다.

🔐 권한

⚙️ 설치

📥 설정

• EssentialsX Discord 모듈 JAR을 다운로드해 핵심 EssentialsX JAR과 함께 서버의 plugins/ 디렉터리에 넣습니다.
• 서버를 시작해 모듈 설정을 생성한 뒤, 서버를 중지합니다.
• 문서에 따라 plugins/EssentialsDiscord/config.yml에서 봇 토큰, 채널 ID, 메시지 유형, 명령 역할 설정을 구성한 다음 다시 시작합니다.

📦 의존성

• EssentialsX (core) — 이 모듈은 EssentialsX 플러그인 모음의 애드온으로 동작합니다.

🧠 기술 노트

• 이 모듈은 다른 플러그인이 사용자 지정 메시지 유형을 등록하고 설정된 Discord 채널로 메시지를 보낼 수 있도록 서비스 API(DiscordService)를 제공합니다.
• Discord 측 명령은 표준 Minecraft 권한 노드가 아니라 플러그인 설정에 구성된 역할/ID로 제어됩니다.
• 봇 토큰, 채널 ID, 메시지 서식, 명령 역할 ID 같은 관리자형 설정은 첫 실행 시 생성되는 모듈 설정 파일에서 진행됩니다.

🤝 이 플러그인이 유용한 경우

Discord 커뮤니티와 EssentialsX 기반 Minecraft 서버 사이에 역할 제한 Discord 명령과 개발자 훅을 포함한, 관리되고 설정 가능한 양방향 통신이 필요할 때, EssentialsX Discord는 메시지 매핑과 연동을 위한 작은 API를 처리하는 특화 모듈을 제공합니다.