마인크래프트 서버 연결

마인크래프트 서버와 디스코드를 연결해서, 게임 안 채팅을 디스코드로 보내고 디스코드 채팅을 게임으로 보내고, 접속 인원을 채널 이름에 표시하는 기능이에요.

[!주의] 지금은 끝까지 설정할 수 없어요 이 연동은 마인크래프트 서버에 설치할 플러그인이 있어야 동작해요. 그 플러그인이 아직 배포되지 않았어요. 패널 쪽 화면과 연결 절차는 완성되어 있지만, [플러그인 다운로드] 자리에는 "플러그인 다운로드가 설정되지 않았습니다" 가 떠요.

그래서 이 페이지는 "지금 하는 방법"이 아니라 "준비되면 이렇게 됩니다" 예요. 화면을 열어 보시는 건 괜찮지만, 실제 서버를 붙이시려면 플러그인을 기다려야 해요.

패널 화면 위쪽에도 베타 기능 안내 가 붙어 있어요. 설정 항목과 동작이 바뀔 수 있다는 뜻이에요.

먼저 설치해야 열려요

마켓플레이스에서 설치해야 왼쪽 메뉴에 마인크래프트 연동 이 나타나요.

어떤 마인크래프트 서버가 대상인가요

Paper 또는 Spigot 계열 서버예요. 플러그인을 넣을 수 있는 서버라는 뜻이에요. 바닐라 서버나 콘솔·모바일 에디션은 대상이 아니에요.

연결이 어떻게 되나요

준비되면 이런 순서예요.

1. 패널에서 플러그인을 받아 마인크래프트 서버의 plugins 폴더에 넣고 서버를 다시 켜요.
2. 마인크래프트 서버 콘솔에서 /sole setup 을 실행해요. XXXX-XXXX 형태의 코드가 나와요.
3. 패널의 서버 연결 에 그 코드를 넣고 [확인] 을 눌러요. 어떤 서버인지 보여 줘요.
4. 내가 붙이려던 서버가 맞으면 [연결하기] 를 눌러요.

다른 사람의 승인을 기다리는 절차가 아니에요. 코드를 만든 쪽과 넣는 쪽이 같은 사람이라는 걸 확인하는 절차예요. 코드는 한 번만 쓸 수 있고 만료 시각이 있어요.

연결한 뒤 정할 것들

채널

어떤 종류를 보낼지는 하나씩 켜고 끌 수 있어요 — 게임→디스코드 채팅, 디스코드→게임 채팅, 디스코드에서 명령 실행, 입장·퇴장, 사망, 발전과제, 상태.

[추천 채널 자동 생성] 을 쓰면 위 채널들을 한 번에 만들어 줘요.

[!주의] 디스코드에서 게임 명령을 실행하는 건 위험할 수 있어요 디스코드에서 명령 실행을 켜면, 명령 채널에 글을 쓸 수 있는 사람이 게임 서버에 명령을 보낼 수 있게 돼요. 그 채널의 쓰기 권한을 운영진 역할로 좁혀 두세요.

메시지 템플릿

채팅·입장·퇴장·사망·발전과제·상태가 각각 어떤 문구로 나갈지 정할 수 있어요. 디스코드→게임 방향의 문구도 따로 있어요.

상태 반영 방식

두 가지 중에 골라요.

LuckPerms 역할 동기화

디스코드 역할과 LuckPerms 그룹을 짝지어 두면 한쪽 변화가 다른 쪽에 반영돼요. 방향(디스코드→게임, 게임→디스코드, 양방향)을 매핑마다 정할 수 있어요.

계정을 연결한 사람에게 자동으로 줄 연동 완료 역할 도 지정할 수 있어요.

키를 다루는 법

연결하면 공개 키 와 시크릿 키 가 생겨요. 시크릿 키는 만든 직후에만 전체가 보이고, 그 뒤에는 마지막 4자리만 보여요.

• 시크릿 키는 마인크래프트 서버 쪽 설정에만 넣어요. 채팅이나 문의에 붙이지 마세요.
• 잃어버렸거나 남에게 보였다면 [시크릿 키 재발급] 으로 새로 만들고, 게임 서버 쪽 설정도 같이 바꿔 주세요. 재발급하면 예전 키는 바로 못 쓰게 돼요.

설정을 게임 서버로 보내기

패널에서 바꾼 값을 게임 서버에 보내는 [설정 업로드] 가 있어요. 먼저 [설정 저장] 을 해야 눌려요.

업로드는 플러그인이 받았다고 답할 때까지 기다려요. 답이 없으면 "아직 플러그인 확인 응답이 없습니다" 로 알려 줘요 — 플러그인이 안 돌고 있거나 네트워크가 막힌 경우예요.

상태 카드의 마지막 heartbeat, 마지막 이벤트 수신, 플러그인 버전, 대기열 수 가 지금 연결이 살아 있는지 말해 줘요.

다음은요?

잘 안 되나요?