Skip to content
호스팅 · 오류 분석

플러그인이 이 버전과 호환되지 않아요

시작 시 플러그인 비호환에 대한 코어 메시지: 무엇을 의미하는지, 언제 무시해도 되는지, 언제 안 되는지 알아봐요.

업데이트 2026년 8월 13일

[WARN]: Loaded class ... from ExamplePlugin v1.0 which is not a depend or softdepend
[WARN]: ExamplePlugin does not specify an api-version
[ERROR]: Unsupported API version 1.21

자주 혼동되는 세 가지 메시지예요.

Loaded class ... which is not a depend

플러그인이 의존성을 선언하지 않은 채 다른 플러그인의 클래스를 사용하고 있어요. 보통은 문제가 없지만, 두 번째 플러그인을 제거하면 첫 번째 플러그인이 깨져요. 따로 할 일은 없고, 이 짝을 기억해 두면 돼요.

Does not specify an api-version

오래된 플러그인이라 코어가 호환 모드를 켜서 실행하고 있어요. 동작은 하지만 방치된 플러그인의 신호예요 — 호환성.

Unsupported API version

플러그인이 사용 중인 코어보다 더 새로운 코어용으로 빌드됐어요. 로드되지 않아요. 사용 중인 버전에 맞는 플러그인을 구하거나 서버를 업데이트해야 해요 — 서버 업데이트.

처리 순서

앞의 두 가지는 경고이고, 세 번째는 오류예요. 로그에서 ERROR와 Could not load를 특히 찾아보세요. 나머지는 누구에게나 있는 잡음이에요 — 로그.

Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기