ClassCastException

java.lang.ClassCastException: class org.bukkit.craftbukkit.v1_20_R3.entity.CraftPlayer
cannot be cast to class com.example.CustomPlayer

코드가 예상한 객체 유형과 다른 객체를 받았어요.

흔한 원인

1. 플러그인 버전이 코어와 맞지 않아요. 오류 문구에 나오는 v1_20_R3 클래스는 버전 바인딩의 직접적인 신호예요 — 호환성.
2. 두 플러그인이 같은 시스템을 덮어써요 (예: 둘 다 플레이어 엔티티에 간섭해요).
3. 하이브리드 코어: 모드와 플러그인이 같은 객체를 다르게 처리해요 — 하이브리드.

어떻게 해야 하나요

• 코어 버전에 맞게 플러그인을 업데이트하세요.
• 같은 시스템을 다루는 두 번째 플러그인을 찾아 하나를 제거하세요 — 플러그인이 서버를 망가뜨려요.
• 하이브리드에서는 플러그인의 모드 대응 버전이 있는지 확인하세요.

시작할 때 오류가 발생한다면

플러그인이 아예 로드되지 않아요. 플레이어 행동 중에 발생한다면 일부 기능이 작동하지 않고 로그가 계속 커져요.