NoSuchFieldError

java.lang.NoSuchFieldError: PROTOCOL_VERSION

코드가 라이브러리의 로드된 버전에 존재하지 않는 클래스 필드에 접근했어요. 의미상으로는 NoSuchMethodError와 비슷해요.

원인

거의 항상 버전 불일치 때문이에요:

• 플러그인이 라이브러리의 최신 버전을 기준으로 빌드되었지만, 더 오래된 버전이 설치되어 있는 경우
• plugins에 같은 라이브러리의 두 버전이 동시에 있는 경우
• 라이브러리가 한 플러그인에 내장되어 있고, 별도로 설치된 라이브러리와 충돌하는 경우

해결 방법

1. 스택 트레이스의 필드 이름과 패키지로 라이브러리를 확인하세요.
2. 플러그인이 요구하는 버전으로 업데이트하세요.
3. plugins에서 중복된 .jar 파일이 있는지 확인하세요 — 구버전과 신버전이 나란히 있는 경우예요.
4. 내장 라이브러리와 외부 라이브러리가 충돌한다면, 별도로 설치된 것을 제거하거나 플러그인 문서를 확인하세요.

흔한 원인

ProtocolLib, PlaceholderAPI, Vault, Adventure/MiniMessage, Kotlin 라이브러리 — ProtocolLib, Vault, PlaceholderAPI.