마인크래프트 플러그인 만드는 법

단계별 안내

1. 1.서버 소프트웨어와 버전 고르기

   플러그인은 Bukkit 기반 서버인 Spigot, Paper, Folia(프록시는 BungeeCord와 Velocity)에서 실행돼요. 서버가 실행하는 Minecraft 버전(1.8~26.x)을 고르세요.

2. 2.플러그인이 무엇을 하는지 설명하기

   명령어, 권한, 게임에서 일어나는 일, 설정할 수 있어야 하는 것을 적으세요. 예: "/sethome, /home, /delhome, 플레이어당 최대 3개의 홈, 3초 대기, 메시지는 config.yml에".

3. 3.Codexe가 작성하고 컴파일하게 하기

   Codexe가 Java 클래스, plugin.yml, config.yml, pom.xml을 작성하고, 실제 빌드를 실행하고, 프로젝트를 준비 완료로 표시하기 전에 컴파일 오류를 고쳐요.

4. 4.실제 서버에서 테스트하기

   지금 체험하기를 누르면 플러그인이 설치된 비공개 Minecraft 서버에 접속해요. Codexe의 테스트 플레이어가 모든 명령어를 실행하고 요청한 내용을 확인해요.

5. 5..jar 다운로드하고 설치하기

   빌드된 .jar를 다운로드해서 서버의 plugins/ 폴더에 넣고 서버를 재시작하세요. 설정 파일은 plugins/<PluginName>/에 생겨요.

Minecraft 플러그인이란

플러그인은 Minecraft 서버가 plugins/ 폴더에서 불러오는 .jar 파일이에요. 서버에서만 명령어, 게임 규칙, 경제, 미니게임 등을 추가해요. 플레이어는 일반 게임으로 접속하며 모드가 필요 없어요.

플러그인은 서버 API에 맞춰 Java(또는 Kotlin)로 작성해요. 게임 서버에는 Spigot과 Paper, 프록시에는 BungeeCord나 Velocity를 써요. 플러그인에는 서버에 이름, 메인 클래스, 명령어, 권한을 알려 주는 plugin.yml도 필요해요.

직접 만드는 방법: Java, Maven, Spigot 또는 Paper API

배우는 데 시간이 더 걸리지만 완전히 제어할 수 있어요. Codexe는 같은 종류의 프로젝트를 만들어 주므로, 생성된 플러그인으로 시작해서 직접 이어서 작업할 수 있어요.

1. JDK(1.20.5~1.21.x는 Java 21, 26.x는 Java 25)와 IntelliJ IDEA 같은 IDE를 설치하세요.
2. Maven 또는 Gradle 프로젝트를 만들고 내 버전의 paper-api 또는 spigot-api 의존성을 provided 범위로 추가하세요.
3. JavaPlugin을 상속하고 onEnable()과 onDisable()이 있는 메인 클래스를 작성하세요.
4. src/main/resources에 name, version, main, api-version, 명령어가 있는 plugin.yml을 추가하세요.
5. getCommand("name").setExecutor(...)로 명령어를, getServer().getPluginManager().registerEvents(...)로 리스너를 등록하세요.
6. mvn package로 빌드하고, target/의 .jar를 테스트 서버의 plugins/ 폴더에 복사한 뒤 재시작하세요.

질문