Paper 서버에서 신규 플레이어에게 마인크래프트 기본템 주는 방법

처음 접속할 때 주는 마인크래프트 기본템, 어떻게 작동할까

이 가이드의 기본템은 돌 검, 돌 곡괭이, 빵 16개이고, 그 뒤에 방금 무엇을 받았는지 알려 주는 개인 채팅 메시지가 한 줄 나가요. 플레이어가 서버에 처음 접속하면 자동으로 지급돼요. 입력할 명령어도, 설정할 권한도 없어요.

여기서 "처음"은 Paper가 이미 알고 있는 기준이에요: 접속하기 전까지 서버가 한 번도 저장한 적 없는 플레이어라는 뜻이에요. 런타임은 자체 목록도, 카운터도 따로 두지 않아요. 그래서 이미 운영 중인 서버에서도 기본템이 작동하고, 같은 이유로 아래에 정리한 몇 가지는 할 수 없어요.

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

스튜디오에서 기본템 규칙 만들기

1. NimBlock에서 내 플러그인을 열고 새 플러그인을 만들어요. 에디터는 환영 규칙이 들어 있는 상태로 시작해요. 그대로 둬도 되고 지워도 돼요.
2. 규칙에서 새 규칙을 플러그인 안으로 끌어다 놓고, 이름을 기본템으로 정해요.
3. 트리거에서 플레이어가 접속했을 때를 규칙의 언제 칸에 넣어요.
4. 조건에서 플레이어가 처음 방문했을 때를 규칙의 만약 칸에 넣어요.
5. 액션에서 플레이어에게 아이템 지급하기를 세 번 추가해요: STONE_SWORD 수량 1, STONE_PICKAXE 수량 1, BREAD 수량 16.
6. 마지막으로 플레이어에게 메시지 보내기를 추가해요. 예를 들면 환영해요 {player}! 시작할 때 쓸 기본템이에요.처럼요. {player}는 적힌 그대로 둬야 해요: 런타임이 이 부분을 플레이어 이름으로 바꿔 줘요.
7. 플러그인을 저장해요. 플러그인 페이지에 보이는 JSON 전체를 복사해서 starter-kit.json이라는 이름의 일반 텍스트 파일에 붙여 넣고, UTF-8로 저장해요.

아이템은 IRON_AXE나 COOKED_BEEF처럼 Minecraft 이름으로 적어요. 세 아이템을 원하는 기본템으로 바꿔도 돼요: 아이템 하나에 동작 하나, 각각 수량을 정해 주면 돼요. 사용할 수 있는 모든 트리거, 조건, 동작은 공개 문법에 정리되어 있어요.

이미 운영 중인 Paper 서버에 설치하기

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

테스트하기 전에 다시 불러오는 동안 나온 오류를 모두 고쳐요. 잘못된 아이템 이름은 규칙이 실행될 때에야 잡히니까, 첫 테스트 전에 아이템 이름 철자를 하나하나 확인해요.

한 번도 접속한 적 없는 계정으로 테스트하기

내 계정은 이미 서버에서 플레이한 적이 있어서 기본템을 받지 않아요. 규칙이 제대로 작동하고 있다는 뜻이에요. 이 서버에 한 번도 접속한 적 없는 Minecraft Java 계정(예를 들어 친구 계정)으로 테스트하거나, 새 월드를 만든 서버 복사본에서 테스트해요. 그 계정이 처음 접속하면 검, 곡괭이, 빵, 메시지를 받아야 해요. 접속을 끊고 잠시 기다린 뒤 다시 접속해 보세요: 더 이상 아무것도 지급되지 않아야 해요.

규칙을 설치하기 전에 접속했던 플레이어는 신규 플레이어가 아니라서 기본템을 받지 않아요. 규칙을 불러와도 이전 접속이 다시 처리되지는 않아요.

첫 접속 기본템의 한계

• 서버가 기억하는 동안 플레이어당 한 번: 조건은 Paper 자체의 플레이어 데이터를 읽어요. 새 월드를 시작하면 모두가 다시 신규 플레이어가 되어 기본템을 또 받아요. 어떤 플레이어의 데이터를 지우면 그 플레이어만 다시 신규 플레이어가 되어 기본템을 또 받아요.
• 첫 세션 내내 참: 이 조건은 접속하는 순간만이 아니라, 그 플레이어가 접속을 끊을 때까지 계속 참이에요. 그 사이에 서버가 저장해도 달라지지 않아요. 그러니 플레이어가 접속했을 때 아래에 두세요. 리스폰 같은 다른 트리거 아래에 두면, 신규 플레이어가 첫 세션 동안 기본템을 두 번 받을 수 있어요.
• 일일 기본템, 쿨타임, 카운터 없음: 런타임은 이벤트에 반응할 뿐 아무것도 기억하지 않아서, "하루에 한 번"이나 "플레이어당 세 번" 같은 기본템은 줄 수 없어요.
• 일반 아이템만: 이 동작은 아이템 종류와 수량만 지급해요. 마법 부여나 사용자 지정 이름은 포함되지 않아요.
• 인벤토리가 가득 찼을 때: 들어가지 않는 아이템은 플레이어 발밑에 떨어져요. 신규 플레이어의 인벤토리는 보통 비어 있어서 이런 일은 거의 없어요.

런타임을 다시 설치하지 않고 기본템 바꾸기

스튜디오에서 규칙을 고치고 새 버전으로 저장해요. 같은 starter-kit.json 파일의 내용을 새로 저장한 JSON으로 바꾼 다음 /nimblock reload를 실행해요. 다음 신규 플레이어는 새 기본템을 받고, 이미 예전 기본템을 받은 플레이어에게는 더 지급되지 않아요. 예전 파일과 새 파일을 둘 다 두면 두 규칙이 모두 불러와져서 기본템이 두 번 지급돼요.

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