마인크래프트 Paper 서버에 접속 메시지 추가하기

마인크래프트 접속 메시지와 서버 목록 MOTD, 뭐가 다를까?

접속 메시지는 플레이어가 접속한 뒤에 나타나요. MOTD는 그보다 먼저, 멀티플레이 목록에서 서버 이름 아래에 나타나요. motd 값을 server.properties에서 바꾸면 후자가 바뀌는데, 이는 Paper 문서에 설명돼 있어요. 이 가이드에서 만드는 채팅 인사말은 그렇게 만들어지지 않아요.

이 방법은 NimBlock의 블록 에디터와 별도로 제공되는 무료 런타임을 사용해요. 규칙을 저장하는 데는 NimBlock 계정만 있으면 돼요. 규칙을 실행하려면 플러그인 파일 업로드를 허용하는 기존 Minecraft Java 서버가 필요해요. 아래 단계는 Java 21을 쓰는 Paper 1.21.11 기준이에요. NimBlock이 호스팅하는 서버는 필요하지 않아요.

스튜디오에서 접속 메시지 만들기

1. NimBlock에서 내 플러그인을 열고 새 플러그인을 만들어요. 에디터에는 처음부터 환영 규칙이 들어 있어요.
2. 트리거 플레이어가 접속했을 때와 액션 플레이어에게 메시지 보내기는 그대로 두세요. 접속할 때마다 실행되도록 규칙에 조건은 넣지 마세요.
3. 메시지를 쓸모 있는 내용으로 바꿔요. 예: {player}님, 환영합니다! 채팅은 서로 예의를 지켜 주세요. {player}는 그대로 두세요. 런타임이 플레이어 이름으로 바꿔 줘요.
4. 플러그인을 저장해요. 플러그인 페이지에 표시되는 JSON 전체를 복사해서, UTF-8로 저장한 일반 텍스트 파일 welcome.json에 붙여 넣어요.

스튜디오가 만드는 것은 JSON 규칙이지, 독립 실행형 Java 플러그인이 아니에요. 다른 호스팅에서는 런타임을 한 번만 설치하고, 그 JSON 파일을 넘겨 주면 돼요. 사용할 수 있는 트리거와 액션은 공개 문법에 나와 있어요.

이미 쓰고 있는 Paper 서버에 설치하기

1. NimBlock 런타임을 내려받아요. 서버를 끄고, 런타임의 .jar 파일을 plugins/에 바로 넣은 다음 서버를 시작해요.
2. /plugins로 NimBlock이 활성화됐는지 확인해요. 로드에 실패했을 때 원인을 찾는 방법은 Paper의 플러그인 설치 가이드에 나와 있어요.
3. welcome.json을 plugins/NimBlock/specs/에 업로드해요. 폴더 이름의 대문자는 그대로 유지하세요. 폴더가 없으면 업로드하기 전에 먼저 만드세요.
4. 서버 관리자(OP)로 /nimblock reload를 실행하고, 이어서 /nimblock list를 실행해요. 저장한 플러그인 이름이 보여야 해요. 서버 콘솔에서는 맨 앞의 슬래시를 빼고 입력하세요.

reload 중에 오류가 나오면 테스트하기 전에 먼저 고치세요. /plugins에 런타임이 보이면 런타임이 로드됐다는 것만 증명할 뿐, JSON 규칙이 로드됐다는 뜻은 아니에요. 두 번째 확인에는 /nimblock list를 써요.

플레이어에게 실제로 어떻게 보이는지 확인하기

Minecraft Java 계정으로 접속해 봐요. 내 이름이 들어간 인사말이 보여야 해요. 접속을 끊었다가 다시 접속하면 같은 인사말이 다시 나타나야 해요. 이미 접속해 있는 다른 플레이어가 있다면, 그 플레이어에게 내 개인 인사말이 가지 않는지 확인해 달라고 부탁하세요. 그 플레이어에게도 Minecraft의 기본 접속 알림은 여전히 보일 수 있어요.

모두에게 접속을 알리고 싶다면 스튜디오의 전체 공지(브로드캐스트) 액션을 고르세요. 이러면 공개 메시지가 추가되지만, 기본 알림이 사라지지는 않아요. 접속할 때마다 모두의 채팅이 넘치지 않도록, 개인 안내와 공개 공지는 나눠서 쓰세요.

런타임을 다시 설치하지 않고 문구 바꾸기

스튜디오에서 메시지를 고치고 새 버전으로 저장해요. 같은 welcome.json 파일의 내용을 새로 저장한 JSON으로 교체하고, /nimblock reload를 실행하세요. 다시 접속해서 확인해요. 메시지만 바꾸는 경우에는 서버를 재시작하지 않아도 돼요. 예전 파일과 새 파일을 둘 다 두면 두 규칙이 모두 로드되어 인사말이 두 번 나올 수 있어요.

접속 메시지가 안 뜨거나 두 번 뜰 때

• 런타임 목록에 아무것도 없을 때: 폴더, .json 확장자, reload 오류를 확인하세요. welcome.json.txt라는 파일은 같은 파일 형식이 아니에요.
• 규칙은 로드됐는데 아무 메시지도 없을 때: 트리거가 플레이어 접속인지, 조건이 없는지, 규칙을 로드한 뒤에 실제로 다시 접속했는지 확인하세요. 규칙을 로드해도 이전 접속이 다시 재생되지는 않아요.
• 사용자 지정 인사말이 두 개 보일 때: 두 번째 JSON 파일이나, 환영 메시지를 보내는 다른 플러그인이 있는지 확인하세요. 개인 인사말 하나와 함께 기본 접속 알림이 나오는 것은 정상이에요.
• 새로 온 플레이어에게만 인사하고 싶을 때: 조건을 하나 더 넣어야 해요. 이 방법은 일부러 다시 접속한 플레이어에게도 인사해요.

NimBlock 호스팅을 사지 않아도, 호환되는 내 Paper 서버에서 런타임을 쓸 수 있어요. 규칙은 직접 열어 볼 수 있는 JSON 파일로 남아 있어서, 서버 백업과 함께 보관할 수 있어요.