Minecraft 플러그인 DiscordSRV
DiscordSRV는 Minecraft 서버와 Discord를 연결해 채팅, 계정 연결, 역할/그룹 동기화, 서버 이벤트를 플랫폼 간에 동기화하는 Minecraft 플러그인입니다.
DiscordSRV이(가) 있는 서버 찾기
DiscordSRV을(를) 보고한 서버: 130
- LinkCraft 18명 온라인JavaProgression
- J's Hideout SMP 26명 온라인Java + Bedrock
- play.vcraft.fr:23020 20명 온라인Java + Bedrock
- PUREMC FAMILY FRIENDLY 4명 온라인
- Server.Pro Official [26.3] Anarchy Ignites! Server Now Live 11명 온라인Java
- Come start your magical adventure! 7명 온라인Java + Bedrock
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 모더레이션 채널로 보내기.
⌨️ 명령어
| 명령어 | 설명 | 권한 | 접근 |
|---|---|---|---|
/discord /discordsrv | 설정된 DiscordSRV 메시지를 표시합니다(messages.yml 기준). | discordsrv.discord | 관리자 |
플레이어 하위 명령어:
| 명령어 | 설명 | 권한 | 접근 |
|---|---|---|---|
help / ? | 사용자가 권한을 가진 옵션 목록을 표시합니다. | discordsrv.help | 플레이어 |
linked | Minecraft 계정이 Discord 계정과 연동되었는지 표시합니다. | discordsrv.linked | 플레이어 |
link | Minecraft 계정을 Discord 계정과 연동하는 방법을 보냅니다. | discordsrv.link | 플레이어 |
unlink / clearlinked | Discord 계정을 Minecraft 계정에서 연동 해제합니다. | discordsrv.unlink | 플레이어 |
스태프 명령어:
| 명령어 | 인자 | 설명 | 권한 | 접근 |
|---|---|---|---|---|
broadcast / bcast | <#ChannelID/#ChannelName> <Message> | 설정된 Discord 채널로 메시지를 방송합니다. | discordsrv.bcast | 관리자 |
linked | <Name/UUID/DiscordID/DiscordTag> | 다른 사용자의 연동 상태를 확인합니다. | discordsrv.linked.others | 관리자 |
link | <Name/UUID> <DiscordID/DiscordTag> | 다른 사용자를 위한 연동 안내를 보냅니다. | discordsrv.link.others | 관리자 |
unlink / clearlinked | <Name/UUID/DiscordID/DiscordTag> | 다른 사용자의 Discord 계정을 연동 해제합니다. | discordsrv.unlink.others | 관리자 |
resync | 그룹 동기화를 트리거합니다(동기화 설정 필요). | discordsrv.resync | 관리자 | |
reload | 플러그인 설정을 다시 불러옵니다. | discordsrv.reload | 관리자 | |
language / lang | <Language> [-confirm] | 플러그인 언어를 변경합니다. | discordsrv.language | 관리자 |
debugger | <start [categories...]/stop/upload> | 디버그 정보를 덤프하고 필요하면 디버그 추적을 업로드합니다. | discordsrv.debug | 관리자 |
(이전 구독 시스템과 관련된 폐기된 명령어는 기록에 문서화되어 있지만 현재 동작에서는 제거되었습니다.)
🔐 권한
| 권한 | 설명 | 기본값 |
|---|---|---|
discordsrv.discord | /discord와 /discordsrv 사용을 허용합니다. | true |
discordsrv.help | 도움말 하위 명령어에 접근할 수 있습니다. | 지정되지 않음 |
discordsrv.link | 연동 하위 명령어를 사용할 수 있습니다. | 지정되지 않음 |
discordsrv.unlink | 연동 해제 하위 명령어를 사용할 수 있습니다. | 지정되지 않음 |
discordsrv.linked | 개인 연동 상태를 확인할 수 있습니다. | 지정되지 않음 |
discordsrv.bcast | Discord 채널로 방송 메시지를 보낼 수 있습니다. | 지정되지 않음 |
discordsrv.linked.others | 다른 플레이어의 연동 상태를 볼 수 있습니다. | 지정되지 않음 |
discordsrv.link.others | 다른 플레이어에게 연동 안내를 보낼 수 있습니다. | 지정되지 않음 |
discordsrv.unlink.others | 다른 플레이어의 연동을 해제할 수 있습니다. | 지정되지 않음 |
discordsrv.resync | 그룹/역할 동기화를 실행할 수 있습니다. | 지정되지 않음 |
discordsrv.reload | 플러그인을 다시 불러올 수 있습니다. | 지정되지 않음 |
discordsrv.language | 플러그인 언어를 변경할 수 있습니다. | 지정되지 않음 |
discordsrv.debug | 디버거를 실행하고 디버그 추적을 업로드할 수 있습니다. | 지정되지 않음 |
⚙️ 설치
📥 설정
- 공식 배포(프로젝트 페이지 / 카탈로그 / 릴리스)에서 DiscordSRV 공식
.jar파일을 다운로드하세요. - jar 파일을 Bukkit/Spigot 호환 서버의
plugins/폴더에 넣으세요. - 서버를 재시작하고 콘솔 로그를 확인해 DiscordSRV가 로드되었는지 확인하세요.
- 생성된 설정 파일을 사용해 초기 설정(bot 토큰, 채널 매핑, 연동 옵션)을 완료하세요.
📦 설정 파일
DiscordSRV는 여러 설정 파일을 사용합니다. 확인된 파일 이름은 다음과 같습니다.
config.ymlmessages.ymllinking.ymlsynchronization.ymlvoice.ymlalerts.yml
Discord bot 토큰, 채널 매핑, 동기화 설정을 지정하려면 해당 파일을 편집하세요. 일부 기능(역할/그룹 동기화, 음성 연동)은 추가 설정이 필요합니다.
🧠 기술 참고
- 소스 코드와 릴리스는 공개 저장소에서 관리됩니다.
- 이 프로젝트는 GPL-3.0으로 배포됩니다.
- 확인된 선택적 통합에는 LuckPerms(contexts/그룹 동기화)와 PlaceholderAPI(플레이스홀더)가 포함됩니다.
- 명령어와 권한은 공식 문서에 설명되어 있으며, resync 및 reload 같은 관리자 작업이 있고 운영자 권한이 필요할 수 있습니다.
🤝 이 플러그인이 유용한 경우
Minecraft 서버와 Discord 커뮤니티 사이에서 일관되고 설정 가능한 양방향 채팅과 계정 연동이 필요하다면, DiscordSRV는 해당 기능을 운영하는 데 필요한 다리, 통합 훅, 설정 파일을 제공하며 일반적인 서버 플러그인과도 함께 연동할 수 있습니다.
댓글
아직 댓글이 없습니다
첫 댓글을 남겨 보세요.
서버 관리자용
- 개발자
- Scarsz, DiscordSRV
- 라이선스
- GPL-3.0
- 지원 플랫폼
- Bukkit, Spigot
- 지원 버전
- 1.7–1.21
- 의존성
- LuckPerms, PlaceholderAPI
링크
서버가 보고한 내용
서버 플랫폼
- Paper102
- Purpur13
- CraftBukkit6
- Leaf3
- Arclight2
- Cauldron1
- Yatopia1
- Magma1
- CatServer1
플러그인 버전
- 1.30.584
- 1.30.411
- 1.29.05
- 1.30.35
- 1.30.15
- 1.30.04
- 1.27.04
- 1.26.03
- 1.30.63
- 1.28.02
- 1.25.11
- 1.20.01
- 1.24.01
- 1.30.21
MSHQ가 확인할 때 플러그인 목록을 공개하는 서버의 수치입니다. 많은 서버가 목록을 숨기므로 실제 사용량은 더 많습니다.