Skip to content
호스팅 · 플러그인

Discord와의 채팅 연동

Millida 서버에서의 DiscordSRV: 게임에서 Discord로, 다시 게임으로 오는 채팅, 접속-퇴장과 사망, 닉네임 연동, 후원 역할을 다뤄요.

업데이트 2026년 8월 4일

DiscordSRV는 서버 채팅을 Discord 채널과 연결해 줘요. 메시지는 양방향으로 오가고, 접속, 퇴장, 사망, 업적 소식도 그곳에 표시돼요. 서버 커뮤니티의 절반은 바로 그 채널에 살고 있으니까요.

설치

  1. "플러그인과 모드" 섹션 → DiscordSRV → 재시작하세요. 플러그인이 plugins/DiscordSRV/config.yml 파일을 만들어 줘요.
  2. 봇을 만드세요: discord.com/developers → New Application → Bot 탭 → Reset Token, 토큰을 복사하세요.
  3. 같은 곳에서 Message Content Intent와 Server Members Intent를 활성화하세요. 이게 없으면 봇이 메시지를 보지 못해요.
  4. OAuth2 탭 → URL Generator에서 bot과 권한 Send Messages, Read Message History, Manage Roles를 체크한 뒤, 생성된 링크로 봇을 서버에 초대하세요.
  5. config.yml에서 BotToken을 채우고, Channels에는 채널 ID를 넣으세요:
BotToken: "your-token"
Channels: {global: "123456789012345678"}

채널 ID는 Discord에서 개발자 모드를 켠 뒤 채널을 마우스 오른쪽 버튼으로 클릭하면 얻을 수 있어요.

  1. 서버를 재시작하세요. 콘솔에 [DiscordSRV] Enabled가 표시되어야 해요.

토큰은 봇의 비밀번호예요. 로그 스크린샷에 넣지 마세요. 설정 파일은 백업에도, 지원 대화에도 남게 되니까요.

다음으로 설정할 것들

  • 무엇을 전달할지: 접속, 퇴장, 사망, 업적 — MessageJoinServer 블록과 그 주변 항목이에요. 필요 없는 것은 빈 값으로 꺼 두세요.
  • 메시지 형식 — DiscordChatChannelPrefix와 messages.yml의 템플릿이에요. LuckPerms의 접두사는 자동으로 가져와요.
  • 콘솔을 별도 채널로 — DiscordConsoleChannelId예요. 편리하지만 채널은 반드시 비공개로 두세요. 비밀번호가 포함된 명령까지 모든 것이 보이니까요.
  • 계정 연동: 플레이어가 /discord link를 입력하면 코드를 받아 봇에게 보내요. 연동이 끝나면 서버 그룹에 따라 Discord 역할을 지급할 수 있어요(GroupRoleSynchronizationGroupsAndRolesToSync). 이렇게 하면 후원 랭크가 Discord에서 자동으로 그 사람을 물들여 줘요.

자주 발생하는 문제

증상원인
봇은 온라인인데 메시지가 전달되지 않음인텐트가 활성화되지 않았거나 채널 ID가 잘못됨
Discord에서 게임으로는 되는데 반대는 안 됨봇이 채널을 볼 수 없음: 채널 권한 설정에서 권한이 부족함
콘솔에 Invalid token 표시토큰이 전부 복사되지 않았거나 재설정됨
역할이 지급되지 않음봇의 역할 우선순위가 지급하려는 역할보다 낮음 — 역할 목록에서 봇을 위로 올리세요

제어판 알림

호스팅 알림과 혼동하지 마세요. Millida 자체가 서버 충돌, 요금제 만료, 작업 결과를 Telegram이나 Discord로 보내 줘요. 자세한 내용은 서버 알림을 참고하세요.

Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기