Minecraft 플러그인 DiscordSRV

🔌 DiscordSRV 소개

DiscordSRV는 Minecraft 서버와 Discord 서버를 연결하는 Minecraft 플러그인입니다. 게임 내 채팅을 Discord로 전달하고(Discord 메시지도 게임으로 전달), Minecraft와 Discord 계정 간 계정 연동을 지원하며, 역할/그룹 및 여러 서버 이벤트를 위한 동기화 훅을 제공합니다.

🎯 목적

DiscordSRV의 핵심 목적은 Minecraft 서버와 Discord 사이에 신뢰할 수 있고 설정 가능한 다리를 제공하여, 커뮤니티가 두 플랫폼 모두에서 소통하고, 스태프가 상황을 파악하며, 설정 시 멤버십/역할 정보를 동기화할 수 있게 하는 것입니다.

⚙️ 기능

• Minecraft와 Discord 채널 간 양방향 채팅 동기화(채널별 설정 가능).
• 플레이어를 위한 Minecraft <-> Discord 계정 연동.
• 역할/그룹 동기화 훅(LuckPerms 같은 권한 플러그인을 위한 통합 지점).
• Minecraft에서 Discord로 보내는 방송 및 스태프 메시지.
• 연동, 연동 상태 확인, 관리자 작업(reload, resync, debug)용 명령어.
• 채널 매핑, 언어/메시지, 동기화, 음성 기능을 위한 여러 설정 파일.
• 공개 이슈 트래커와 릴리스를 갖춘 오픈 소스 코드.

🧩 대상

• Minecraft와 Discord 전반에서 커뮤니티 채팅을 통합하고 싶은 서버 소유자와 관리자.
• Discord에서 서버 이벤트를 확인해야 하는 모더레이션 팀.
• Discord와 역할 또는 그룹 동기화를 원하고 권한 플러그인을 사용하는 네트워크.

🏗️ 사용 예시

• 전역 또는 채널별 Minecraft 채팅을 특정 Discord 채널로 전달해 서버 밖 사용자도 대화를 따라가게 하기.
• 플레이어 계정을 Discord ID와 연결해 Discord 역할을 부여하거나 플랫폼 간 사용자 확인하기.
• 서버 입장/퇴장/콘솔 로그를 Discord 모더레이션 채널로 보내기.

⌨️ 명령어

플레이어 하위 명령어:

스태프 명령어:

(이전 구독 시스템과 관련된 폐기된 명령어는 기록에 문서화되어 있지만 현재 동작에서는 제거되었습니다.)

🔐 권한

⚙️ 설치

📥 설정

• 공식 배포(프로젝트 페이지 / 카탈로그 / 릴리스)에서 DiscordSRV 공식 .jar 파일을 다운로드하세요.
• jar 파일을 Bukkit/Spigot 호환 서버의 plugins/ 폴더에 넣으세요.
• 서버를 재시작하고 콘솔 로그를 확인해 DiscordSRV가 로드되었는지 확인하세요.
• 생성된 설정 파일을 사용해 초기 설정(bot 토큰, 채널 매핑, 연동 옵션)을 완료하세요.

📦 설정 파일

DiscordSRV는 여러 설정 파일을 사용합니다. 확인된 파일 이름은 다음과 같습니다.

• config.yml
• messages.yml
• linking.yml
• synchronization.yml
• voice.yml
• alerts.yml

Discord bot 토큰, 채널 매핑, 동기화 설정을 지정하려면 해당 파일을 편집하세요. 일부 기능(역할/그룹 동기화, 음성 연동)은 추가 설정이 필요합니다.

🧠 기술 참고

• 소스 코드와 릴리스는 공개 저장소에서 관리됩니다.
• 이 프로젝트는 GPL-3.0으로 배포됩니다.
• 확인된 선택적 통합에는 LuckPerms(contexts/그룹 동기화)와 PlaceholderAPI(플레이스홀더)가 포함됩니다.
• 명령어와 권한은 공식 문서에 설명되어 있으며, resync 및 reload 같은 관리자 작업이 있고 운영자 권한이 필요할 수 있습니다.

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

Minecraft 서버와 Discord 커뮤니티 사이에서 일관되고 설정 가능한 양방향 채팅과 계정 연동이 필요하다면, DiscordSRV는 해당 기능을 운영하는 데 필요한 다리, 통합 훅, 설정 파일을 제공하며 일반적인 서버 플러그인과도 함께 연동할 수 있습니다.