Skip to content
الاستضافة · تحليل الأخطاء

ClassCastException

فشل تحويل النوع: غالبًا يكون تعارض إصدارات بين إضافة ونواة، أو إضافتين تتنازعان على النظام نفسه.

آخر تحديث 13 أغسطس 2026

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. نواة هجينة: يتعامل مود ومكوّن إضافي مع الكائن نفسه بطريقتين مختلفتين — الأنوية الهجينة.

ما الذي يجب فعله

  • حدّث المكوّن الإضافي ليتوافق مع إصدار النواة لديك.
  • حدّد المكوّن الإضافي الثاني الذي يعمل على النظام نفسه واحذف أحدهما — المكوّن الإضافي يعطّل الخادم.
  • في النواة الهجينة، تحقق مما إذا كان هناك مود مكافئ للمكوّن الإضافي.

إذا ظهر الخطأ عند بدء التشغيل

لن يُحمَّل المكوّن الإضافي إطلاقًا. أما إذا ظهر عند قيام اللاعب بإجراء ما، فستتعطل بعض الوظائف وسيستمر السجل في النمو.

استضافة Minecraftخادمك يعمل أثناء عدم اتصالكإنشاء خادم