가이드

Spigot 플러그인 만드는 법

2026년 10월 7일 업데이트

Spigot 플러그인은 Bukkit/Spigot API를 쓰므로 Spigot과 Paper를 포함한 모든 포크에서 실행돼요. 플러그인이 어디서 실행될지 모를 때 가장 폭넓은 선택이에요. 이 가이드는 프로젝트, 코드, 빌드를 다뤄요.

예시를 내 서버에 맞게 바꿔 보세요.

단계별 안내

1.Java와 빌드 도구 설정
Minecraft 버전에 맞는 JDK(17, 21, 25)를 설치하고 Maven이나 Gradle을 사용하세요.
2.Spigot API 추가
Spigot 저장소에서 내 버전의 spigot-api를 provided 범위로 추가하세요. 컴파일할 때만 필요하며, 실행 시에는 서버가 제공해요.
3.명령어와 리스너 작성
getCommand("name").setExecutor(...)로 CommandExecutor를, registerEvents로 이벤트 리스너를 등록하세요.
4.plugin.yml 작성
이름, 버전, 메인 클래스, api-version(1.13부터), 명령어, 권한.
5.빌드하고 설치
mvn package를 실행하고, target/의 .jar를 서버의 plugins/ 폴더에 복사한 뒤 재시작하세요.

많은 미니게임 서버가 아직 1.8을 써요. API가 더 오래되어(api-version 없음, 머티리얼 이름이 다름) 1.21 튜토리얼을 복사하지 말고 그 버전용으로 플러그인을 작성해야 해요. Codexe는 버전을 물어보고 그 API에 맞춰 코드를 작성해요.

플러그인을 설명하고 "Spigot"과 버전을 말하세요. Codexe가 Maven 프로젝트를 생성하고, 컴파일하고, 오류를 고치고, 다운로드하기 전에 그 버전의 테스트 서버에서 테스트할 수 있게 해 줘요.

Spigot 서버를 실행하거나 NMS(서버 내부 코드)를 쓸 때만 필요해요. 일반 API에 대해 컴파일하려면 spigot-api 의존성이면 충분해요.

어디서나 실행되어야 한다면 Spigot, 서버가 Paper이고 추가 API가 필요하다면 Paper를 고르세요. Paper 플러그인 만드는 법을 참고하세요.

이 프롬프트는 바로 보낼 수 있는 상태로 열려요:

“Kits라는 Spigot 1.8.8 플러그인: /kit <name>은 설정 가능한 아이템 세트를 키트별 쿨다운과 함께 지급하고, 키트는 config.yml에서 정의하고, 키트별 권한은 kits.<name>이고, 쿨다운은 재시작해도 저장돼야 해.”