가이드
Minecraft 미니게임 플러그인 만드는 법
2026년 10월 18일 업데이트
미니게임 플러그인은 라운드를 진행해요. 플레이어가 로비에서 기다리고, 카운트다운이 시작되고, 게임이 고유 규칙대로 진행되고, 누군가 이기면 다음 라운드를 위해 아레나가 초기화돼요. 스플리프부터 배드워즈까지 모든 미니게임은 같은 뼈대를 가지고 있어요. 이 뼈대만 제대로 잡으면 게임 규칙은 쉬운 부분이에요.
이 예시에서 시작해서 규칙을 바꿔 보세요.
Codexe로 이걸 생성하기단계별 안내
1.한 라운드의 규칙 적기
플레이어 수, 라운드가 시작하고 끝나는 방식, 승리 조건, 죽었을 때 일어나는 일(탈락, 리스폰, 관전자), 시작할 때 플레이어가 받는 것.
2.아레나 설정 계획하기
아레나를 만들고 로비, 스폰 지점, 경계를 지정하는 관리자 명령어. 예:
/mg create <name>,/mg setspawn <name>. 아레나는 파일에 저장돼서 재시작 후에도 남아요.3.게임 상태 정의하기
대기, 시작(카운트다운), 진행, 종료. 상태마다 허용되는 게 달라요. 로비에서는 아무도 블록을 부술 수 없고, 진행 중인 게임에는 아무도 들어올 수 없어요.
4.아레나 초기화 방식 정하기
라운드 중에 바뀐 블록을 추적해서 되돌리거나, 템플릿 월드의 사본을 다시 불러오세요. 초기화하지 않으면 두 번째 라운드는 망가진 맵에서 시작돼요.
5.플레이어에게 보여 줄 것 추가하기
남은 플레이어와 시간을 보여 주는 사이드바 스코어보드, 카운트다운용 보스 바나 타이틀, 처치와 승자를 알리는 채팅 메시지.
6.생성하고, 빌드하고, 한 라운드 플레이하기
Codexe에 설명하고 컴파일을 맡긴 다음, 지금 체험하기로 테스트 서버에 접속하세요. 라운드가 시작될 수 있도록 테스트하는 동안에는 최소 인원을 낮게 설정하세요.
게임 상태
미니게임 버그의 대부분은 플레이어가 잘못된 상태에서 무언가를 할 때 생겨요. 요청에 상태를 적어 두면 AI가 그 상태를 중심으로 플러그인을 만들어요.
| 상태 | 일어나는 일 | 일반적인 규칙 |
|---|---|---|
| 대기 | 플레이어가 로비에 들어옴 | 피해 없음, 블록 파괴 불가, 아이템이나 명령어로 나가기 |
| 시작하는 중 | 최소 인원이 모이면 카운트다운 | 플레이어가 나가서 최소 인원보다 적어지면 카운트다운 중지 |
| 진행 | 게임 규칙이 적용됨 | 참가 불가, 죽으면 탈락하거나 리스폰, 나가면 패배로 처리 |
| 종료 | 승자 발표, 보상 지급 | 몇 초 뒤 플레이어를 돌려보내고 아레나 초기화 |
아레나 초기화하기
- 변경 기록 후 되돌리기: 라운드 중에 블록이 바뀌기 전에 각 블록을 저장해 두고 끝나면 원래대로 돌려놓아요. 플레이어가 블록을 몇 개만 부수거나 놓는 작은 아레나에 빨라요.
- 템플릿 월드: 맵의 깨끗한 사본을 보관해 두고, 라운드가 끝나면 플레이한 월드를 언로드한 뒤 템플릿을 덮어씌워요. 파괴되는 맵에 간단하고 안정적이에요.
- 변경 금지: 파쿠르나 PvP 결투 같은 게임에서는 블록 변경을 아예 취소하면 초기화할 게 없어요.
설명 예시
"Paper 1.21.4 스플리프 미니게임 플러그인. 관리자는 /spleef create <name>, /spleef setlobby, /spleef setfloor(눈 바닥의 두 모서리)로 아레나를 만들어요. 플레이어는 /spleef join <arena>로 참가해요. 2명이 모이면 15초 뒤에 라운드가 시작되고, 최대 8명까지. 플레이어는 다이아몬드 삽을 받고, 눈을 즉시 부수며, 바닥 아래로 떨어지면 탈락해요. 마지막까지 남은 플레이어가 Vault로 50코인을 받아요. 탈락한 플레이어는 관전자가 돼요. 라운드가 끝날 때마다 눈 바닥이 복구돼요. 남은 플레이어와 시간을 보여 주는 사이드바. 아레나는 arenas.yml에, 최소 인원과 보상은 config.yml에 저장."
미니게임 테스트하기
미니게임은 코드만 보고 판단하기 어려워요. 직접 한 라운드를 플레이해 봐야 해요. 지금 체험하기는 플러그인이 설치된 내 버전의 비공개 Paper 서버를 보통 평지 월드로 시작하고, 서버 접근 목록에 친구를 추가하면 친구도 들어올 수 있어요. 테스트 서버 인원은 무료 플랜 2명, Pro 5명, Business 10명, Enterprise 20명이에요.
테스트하는 동안 1이나 2로 바꿀 수 있도록 최소 인원을 config.yml에 넣어 달라고 요청하세요. 테스트 플레이어도 접속해서 참가 명령어와 관리자 명령어를 실행하고 메시지를 확인하므로, 직접 플레이하기 전에 고장 난 명령어를 잡아낼 수 있어요.
질문
아레나는 하나? 여러 개?
처음부터 여러 아레나를 요청하세요. 나중에 단일 아레나 플러그인을 다중 아레나로 바꾸려면 플레이어와 게임 상태를 저장하는 방식을 다시 짜야 해요.
1.8 PvP 미니게임도 만들 수 있나요?
네. 요청에 Spigot 또는 Paper 1.8.8이라고 적으세요. Codexe가 그 예전 API에 맞춰 코드를 작성하고, 테스트 서버는 1.8부터 26.3까지의 버전을 실행해요.
미니게임 네트워크는 어떻게 작동하나요?
큰 네트워크는 BungeeCord나 Velocity 프록시 뒤에서 게임마다 별도 서버를 돌리고, 로비 서버가 플레이어를 비어 있는 게임으로 보내요. 프록시 플러그인과 게임 플러그인, 두 개의 프로젝트가 되는 거예요.
내 미니게임 만들기
이 프롬프트는 바로 보낼 수 있는 상태로 열려요:
“Paper 1.21.4 스플리프 미니게임 플러그인: /spleef create, setlobby, setfloor로 아레나 생성, /spleef join으로 참가, 2명이 모이면 15초 뒤 라운드 시작(최대 8명), 다이아몬드 삽, 바닥 아래로 떨어지면 탈락, 마지막 플레이어가 Vault로 50코인 획득, 탈락한 플레이어는 관전자, 라운드마다 눈 바닥 복구, 남은 플레이어와 시간을 보여 주는 사이드바, 아레나는 arenas.yml에 저장.”
Codexe로 이걸 생성하기