문제 해결
자주 생기는 플랫폼 오류
Codexe 결과물을 실행할 때 생기는 오류의 해결 방법이에요. 플러그인이 로드되지 않을 때, 모드 충돌, 데이터팩 미적용, Skript 파싱 오류, 그리고 Java 17 대상 모드를 Java 21로 빌드하는 이유를 다뤄요.
업데이트됨
#플러그인
| 증상 | 해결 방법 |
|---|---|
/plugins에 플러그인이 없음 | 시작 로그에서 플러그인 이름을 찾아보세요. "Invalid plugin.yml"이나 "main class not found"는 디스크립터가 잘못됐다는 뜻이에요. 채팅에 plugin.yml을 고쳐 달라고 요청하세요. |
| "Unsupported API version" | 플러그인이 서버보다 새로운 Minecraft API로 빌드됐어요. 서버 버전을 알려 주고 그 버전으로 다시 빌드해 달라고 요청하세요. |
다른 플러그인 이름이 나오는 NoClassDefFoundError | 의존 플러그인(Vault, PlaceholderAPI, …)이 설치되어 있지 않아요. |
재시작하면 되는데 /reload 후에 깨짐 | 많은 플러그인이 /reload를 지원하지 않아요. 대신 서버를 재시작하세요. |
#모드
| 증상 | 해결 방법 |
|---|---|
| 전용 서버에서 게임이 충돌함 | 공통 코드나 메인 코드에 클라이언트 전용 코드가 있어요. 채팅에 클라이언트 코드를 분리해 달라고 요청하세요. |
| "Incompatible mod set" / 잘못된 게임 버전 | 모드가 다른 Minecraft나 로더 버전을 대상으로 해요. 둘 다 분명하게 적으세요. |
| 시작할 때 의존성 누락(Fabric) | mods/에 Fabric API(그리고 목록에 있는 다른 의존성)를 설치하세요. |
#Java 17 대상 모드를 왜 Java 21로 빌드하나요?
1.20.5 이전 Minecraft 버전의 모드는 Java 17을 대상으로 해요. 그런데 Fabric의 빌드 도구(Loom)는 Java 21 이상에서만 실행돼요. Codexe는 Gradle을 Java 21로 실행하면서도 모드는 Java 17용으로 컴파일하므로, JAR는 Java 17 서버나 클라이언트에서 동작해요. 정상적인 동작이며, Fabric 1.20.1 빌드 로그에 Java 21이 나오는 이유이기도 해요.
#데이터팩
| 증상 | 해결 방법 |
|---|---|
/datapack list에 보이지 않음 | ZIP의 최상위에 pack.mcmeta가 있어야 하고, world/datapacks/에 들어 있어야 해요. |
| 로드는 됐는데 레시피나 함수가 동작하지 않음 | 버전에 맞지 않는 pack_format이나 폴더 이름이에요. 정확한 Minecraft 버전을 알려 주세요. |
#Skript
| 증상 | 해결 방법 |
|---|---|
/sk reload에서 파싱 오류 발생 | 대개 애드온이 빠진 경우예요. 스크립트가 쓰는 애드온을 확인하고(모르겠다면 채팅에 물어보세요) 설치하세요. |
player's balance 같은 표현식이 없다고 나옴 | Vault와 경제 플러그인을 설치하세요. |
#Discord 봇
Discord 봇: 자주 생기는 문제를 참고하세요.