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. 2つのプラグインが同じシステムを上書きしています（たとえば、どちらもプレイヤーエンティティに干渉している場合）。
3. ハイブリッドコア: MODとプラグインが同じオブジェクトを異なる方法で処理しています — ハイブリッド。

対処方法

• コアのバージョンに合わせてプラグインを更新してください。
• 同じシステムを扱っている2つ目のプラグインを特定し、どちらかを削除してください — プラグインによるサーバー障害。
• ハイブリッドの場合は、プラグインに相当するMODが存在するか確認してください。

起動時にエラーが発生する場合

プラグインはまったく読み込まれません。プレイヤーの操作時に発生する場合は、一部の機能が動作せず、ログが増え続けます。