Kotlin으로 Minecraft 플러그인 만드는 법

단계별 안내

1. 1.Kotlin DSL로 Gradle 프로젝트 만들기

   kotlin("jvm") 플러그인, Minecraft 버전에 맞는 Java 툴체인(17, 21, 25), PaperMC 저장소가 들어간 build.gradle.kts.

2. 2.서버 API 추가하기

   compileOnly("io.papermc.paper:paper-api:<version>"). Java와 마찬가지로 실행할 때 서버가 제공하므로 절대 번들하지 않아요.

3. 3.메인 클래스 작성

   override fun onEnable()이 있는 class MyPlugin : JavaPlugin(). 명령어와 리스너는 Java와 똑같이 등록하세요.

4. 4.Kotlin 표준 라이브러리 가져오기

   Shadow 플러그인으로 .jar 안에 번들하거나, plugin.yml의 libraries 목록으로 서버가 시작할 때 내려받게 하세요. 둘 중 하나가 없으면 플러그인이 NoClassDefFoundError: kotlin/...로 실패해요.

5. 5.plugin.yml 작성

   Java 플러그인과 같은 파일이에요: 이름, 버전, main(Kotlin 클래스), api-version, 명령어, 권한.

6. 6.빌드와 테스트

   ./gradlew shadowJar(또는 build)를 실행하고, build/libs/의 .jar를 테스트 서버에 복사한 뒤 시작할 때 콘솔을 읽어 보세요.

서버에 Kotlin 넣기

• 셰이딩하기: Shadow Gradle 플러그인이 Kotlin 표준 라이브러리와 다른 런타임 라이브러리를 .jar 안에 복사해요. 모든 버전에서 작동하고 가장 흔히 쓰는 방법이에요.
• plugin.yml의 libraries: Spigot 1.16.5부터 플러그인은 서버가 내려받아 불러올 Maven Central 라이브러리를 나열할 수 있어요. .jar는 작게 유지되지만, 처음 시작할 때 서버에 인터넷 연결이 필요해요.
• 직접 추가하는 라이브러리: kotlinx-coroutines는 표준 라이브러리가 아닌 별도 라이브러리라서 함께 번들해야 해요. 내 패키지로 리로케이션하면 다른 버전을 번들한 다른 플러그인과 충돌하지 않아요.

코루틴과 메인 스레드

코루틴은 서버를 멈추지 않고 데이터베이스에서 데이터를 불러오는 깔끔한 방법이지만, Bukkit API(월드, 엔티티, 인벤토리)는 여전히 메인 스레드에서 써야 해요. 느린 작업은 백그라운드 디스패처에서 하고, 게임을 건드리기 전에 스케줄러로 서버 스레드로 돌아오세요. 코루틴 스코프를 플러그인에 묶어서 onDisable()에서 취소되게 하세요.

Java인가요, Kotlin인가요?

Codexe로 하기

Bukkit/Spigot/Paper (Kotlin)을 고르세요. Codexe는 build.gradle.kts, Paper API, 서버가 제공하지 않는 것을 번들하는 Shadow 플러그인이 들어간 Gradle 프로젝트를 생성하고, 코드에서 코루틴을 쓰면 번들하고 리로케이션해요. 준비 완료 전에 플러그인을 컴파일하고, Kotlin 플러그인도 Java 플러그인처럼 테스트 서버에서 체험하고 테스트 플레이어가 확인할 수 있어요. Kotlin 플러그인 생성기를 참고하세요.

"Bounties라는 Kotlin으로 작성한 Paper 1.21.4 플러그인: Vault를 통한 /bounty set <player> <amount>, 처치한 플레이어가 보상을 받음, /bounty top으로 상위 10개 표시, 데이터베이스 접근에 코루틴을 쓰고 SQLite에 저장. 데이터 클래스와 확장 함수를 쓰고, Bukkit API 호출은 메인 스레드에서."

질문