في Minecraft: Java Edition، اختر Java وفق إصدار Minecraft المحدد وبرنامج الخادم، وليس ببساطة أحدث Java على جهازك. تستخدم Vanilla من 1.20.5 إلى 1.21.11 إصدار Java 21؛ وتستخدم الإصدارات 26.1–26.3 إصدار Java 25. للإصدارات الأقدم متطلبات مختلفة، وقد يغيّر Paper أو حزمة مودات الاختيار العملي.
تم التحقق في 8 نوفمبر 2026: يحدد بيان الإصدارات الرسمي من Mojang الإصدار 26.3 بوصفه أحدث إصدار مستقر. لا تدخل إصدارات Snapshot في هذا الوصف. يتناول الدليل عملاء Java Edition وخوادمها المخصصة، وليس Bedrock Edition.
الحد الأدنى وبيئة تشغيل المشغّل والتوصية أمور مختلفة
يبيّن الحد الأدنى التاريخي جيل Java الذي تطلبه إصدار Vanilla الأصلي. أما بيئة تشغيل المشغّل فهي تثبيت Java الذي يختاره المشغّل اليوم. والتوصية هي بيئة التشغيل التي ينصح بها مشروع الخادم أو مشرف حزمة المودات لبناء محدد. من الطبيعي أن تختلف هذه الأرقام.
تكتسب هذه التفرقة أهمية خاصة مع Minecraft القديمة. تعيّن بيانات Mojang الوصفية التي تجري صيانتها Java 8 لعدة إصدارات أقدم بكثير؛ وهذا لا يثبت أن Java 8 كانت الحد الأدنى الأصلي لها. وبالمثل، لا تعني توصية Paper باستخدام Java 21 لفرع معين أنها كانت متطلب Vanilla الأصلي لكل إصدار في ذلك الفرع.
استخدم العمود التاريخي لفهم التوافق، لا بوصفه تعليمات لتثبيت بيئة تشغيل متقادمة. عند النشر الفعلي، اتبع توثيق الخادم ومحمّل المودات والإضافات المحددة، واختر توزيعة Java تجري صيانتها حيث يدعمها البرنامج.
Minecraft وJava: جدول توافق Vanilla
تصف صفوف الإصدارات القديمة المتطلبات وقت الإصدار؛ أما الصفوف الأحدث فتوضح جيل Java المطلوب ونقطة البداية المعتادة للاختيار. ليست هذه ضماناً بأن كل لعبة قديمة تعمل مع كل JVM أحدث.
| Minecraft Java Edition | الحد الأدنى التاريخي / الجيل المطلوب | نقطة البداية العملية |
|---|---|---|
| 1.4.x–1.5.2 | Java 5 | استخدم ملف تشغيل منفصلاً للإصدار القديم؛ تختار بيانات Mojang التي تجري صيانتها للإصدارين 1.4.7 و1.5.2 إصدار Java 8. تحقق من جميع مكونات المنظومة. |
| 1.6.1–1.11.2، بما فيها 1.7.10 و1.8.x | Java 6 | Java 8 أساس شائع للإصدارات القديمة، وتختارها بيانات Mojang للإصدار 1.8.9؛ قد تتطلب الفروع المعدلة والمودات إصداراً أعلى. |
| 1.12–1.16.5 | Java 8 | Java 8 لخوادم Vanilla؛ تحقق من توصيات التنفيذ المحدد قبل تغييرها. |
| 1.17–1.17.1 | Java 16 | طابق بيئة المشغّل أو متطلبات الخادم الدقيقة؛ تختلف توصية Paper كما هو موضح لاحقاً. |
| 1.18–1.20.4 | Java 17 | Java 17 لخوادم Vanilla؛ لا تمدد هذا الصف ليشمل 1.20.5. |
| 1.20.5–1.21.11 | Java 21 | Java 21؛ أضاف الإصدار 1.20.5 أيضاً شرط نظام تشغيل 64 بت. |
| 26.1–26.3 | Java 25 | Java 25؛ الإصدار 26.3 هو أحدث إصدار مستقر تم التحقق منه لهذا الدليل. |
بالنسبة إلى الحد الفاصل القديم، تسجل Minecraft Wiki متطلب Java 5 للإصدار 1.4.7، وJava 6 للإصدار 1.6.1، وJava 6 للإصدار 1.8. يؤيد فحص عينات ممثلة من ملفات JAR الرسمية للخادم أجيال الشيفرة الوسيطة، لكنه ليس اختبار لعب أو اختبار توافق كامل لبيئة التشغيل.
للإصدارات الأحدث، تحدد ملفات JSON الخاصة بكل إصدار والمرتبطة من بيان Mojang إصدار Java 8 للإصدارين 1.12 و1.16.5، وJava 16 للإصدار 1.17، وJava 17 للإصدارين 1.18 و1.20.4، وJava 21 للإصدارين 1.20.5 و1.21.11، وJava 25 للإصدارين 26.1 و26.3. وتعلن ملاحظات إصدار 1.20.5 وملاحظات إصدار 26.1 من Mojang صراحة تغييرات المتطلبات المقابلة.
هل يحتاج Minecraft 1.4 إلى Java 7؟ وهل يحتاج 1.8 إلى Java 8؟
لا تصف أي من العبارتين الحد الأدنى الأصلي لـ Vanilla بدقة. في 1.4، لا تمثل Java 7 الحد التاريخي الأدنى: فالمرجع الخاص بـ 1.4.7 يسجل Java 5. وفي 1.8، المتطلب الأصلي هو Java 6، وليس Java 8.
ومع ذلك، قد تكون نصيحة «استخدم Java 8 لخادم 1.8 قديم» معقولة لتنفيذ محدد. تستخدم بيانات مشغّل Mojang التي تجري صيانتها Java 8 للإصدار 1.8.9، بينما يوصي Paper باستخدام Java 8 لنطاق 1.7.10–1.11. ويمكن لإضافة جرى تجميعها لاستهداف Java 8 أن ترفع الحد الأدنى الفعلي، حتى إن لم تتطلبها اللعبة الأصلية.
لا تحوّل هذه الأرقام التاريخية إلى تعليمات لتنزيل Java 5 أو 6 أو 7. إنها أجيال متقادمة. وتعد Java 8 أيضاً أساساً قديماً: تعتمد الصيانة الأمنية على التوزيعة ومسار التحديثات، لا على الرقم «8» وحده. لا تصلح JVM أحدث بمفردها الثغرات في خادم قديم أو مكتباته. افصل البيئات القديمة وراجع إصلاحاتها الأمنية قبل إتاحتها للعامة.
لدى Paper توصياته الخاصة
يعرض توثيق بدء الاستخدام في Paper حالياً جدول التوصيات التالي، وليس جدول حدود دنيا عامة لـ Vanilla:
| إصدار Paper | إصدار Java الموصى به |
|---|---|
| 1.7.10–1.11 | 8 |
| 1.12–1.16.4 | 11 |
| 1.16.5 | 16 |
| 1.17–1.19 | 17 |
| 1.20–1.21.11 | 21 |
| 26.1+ | 25 |
يتطلب الإصدار الحالي Java 25 على الأقل. اقرأ هذا الشرط مع جدول الإصدارات، لا بوصفه أمراً بنقل كل بناء مؤرشف من Paper إلى Java 25. كما أن التوصية ببيئة تشغيل لا تعني استمرار حصول فرع قديم على إصلاحات. للفروع الأخرى والإضافات المنفردة سياسات دعم خاصة بها.
حزم المودات وForge وNeoForge وFabric: تحقق منها على حدة
في الخادم المعدّل، ابدأ بـ إصدار الحزمة المحدد، ثم إصدار محمّل المودات وتعليمات التثبيت. جدول Vanilla معلومات أساسية، وليس بديلاً عن متطلبات الحزمة. قد تعتمد المحمّلات القديمة على سلوك تغيّر في إصدارات Java اللاحقة؛ وقد تتطلب المودات الأحدث مستوى شيفرة وسيطة أعلى من اللعبة التي تعمل عليها.
استخدم توثيق المشروع نفسه، مثل دليل Fabric لتثبيت Java ودليل مستخدم NeoForge، مع التحقق من إصدار Minecraft وإصدار التوثيق المختار. لا تعمم صف «الأحدث» في صفحة على جيل جديد من Minecraft. سجل الحزمة والمحمّل وتوزيعة Java وإصدارها الرئيسي معاً حتى يتمكن مسؤول آخر من إعادة إنشاء الإعداد.
تحقق من Java التي تشغّل الخادم فعلاً
قبل تثبيت أي شيء، حدد إصدار التصحيح الدقيق لـ Minecraft، وما إذا كان الخادم Vanilla أو Paper أو معدلاً، وأمر بدء التشغيل. ثم نفذ:
java -version
يعرض هذا الملف التنفيذي الذي تصل إليه تلك الطرفية. وهو لا يثبت أن لوحة الاستضافة أو الحاوية أو الخدمة أو المشغّل تستخدم الملف التنفيذي نفسه. تحقق من محدد بيئة التشغيل أو صورة النظام وسجل بدء التشغيل. إذا كان الأمر يشير إلى مسار Java صريح، فتحقق من ذلك الملف التنفيذي بدلاً من غيره. على جهاز العميل، افحص ملف تثبيت المشغّل قبل تغيير Java العامة في جهازك.
مثلاً، يندرج Vanilla 1.20.4 في صف Java 17، بينما يندرج Vanilla 1.20.5 في صف Java 21. أما Paper 1.20.4 فتشمله توصية Paper باستخدام Java 21. هذه ثلاثة قرارات مختلفة رغم تشابه أرقام Minecraft. اختر بيئة التشغيل للعملية التي تعالج عطلها، لا لتثبيت آخر يعمل مصادفة.
أصلح أخطاء بدء التشغيل دون تخمين
تعني UnsupportedClassVersionError عادة أن JVM المختارة لا تستطيع قراءة صنف جرى تجميعه لجيل أحدث من Java. قد تسمي رسالة الخطأ الخادم أو محمّلاً أو إضافة واحدة فقط. في مواصفة ملفات الأصناف في JVM، تقابل أرقام الإصدارات الرئيسية للأصناف 52 و61 و65 و69 إصدارات Java 8 و17 و21 و25. هذه أرقام للشيفرة الوسيطة، وليست إصدارات Minecraft.
إذا احتاجت إضافة إلى Java 21 بينما لا يدعم خادمك القديم إلا بيئة أقدم، فقد تؤدي ترقية Java وحدها إلى تعطل شيء آخر. ابحث عن بناء متوافق للإضافة، أو حدّث المنظومة المدعومة كاملة، أو أعد النظر في استخدام الإضافة. وفي المقابل، قد تصبح خيارات JVM القديمة غير صالحة في Java الأحدث؛ احتفظ فقط بالخيارات الموثقة لبيئة التشغيل المختارة.
غياب الأمر java يشير أولاً إلى مشكلة في التثبيت أو اختيار مسار الملف التنفيذي. ولا يثبت فشل تخصيص الذاكرة أو تعارض المنافذ خطأ الإصدار الرئيسي لـ Java. اقرأ أول خطأ ذي صلة والسطور التي تسبقه مباشرة قبل تغيير إعدادات غير مرتبطة.
قائمة تحقق لتغيير آمن
- انسخ العالم والإعدادات والإضافات/المودات وإعدادات بدء التشغيل الحالية احتياطياً قبل تغيير البيئة.
- تأكد من الإصدار والتنفيذ المحددين، ثم اختر إصدار Java الموثق لهما. استخدم مصدراً موثوقاً للتوزيعة أو محدد بيئة التشغيل المدعوم لدى مستضيفك، لا تنزيلاً عشوائياً بعنوان «إصلاح Java».
- غيّر بيئة Java المختارة فقط أولاً. سجل الإعداد السابق؛ ولا تجمع ذلك مع ترقية إصدار العالم.
- أعد التشغيل بطريقة سليمة وافحص سجل بدء التشغيل. اختبر على نسخة عند الإمكان الاتصال وتحميل العالم والإضافات أو المودات التي تستخدمها فعلاً.
- إذا فشل التشغيل، أعد بيئة التشغيل والإعدادات السابقة. وإذا رقّى تغيير آخر بيانات العالم، فاستعد النسخة الاحتياطية المطابقة بدلاً من افتراض أن خادماً خُفّض إصداره يمكنه قراءتها بأمان.
عند الاستضافة لدى مزود، قارن استضافة Minecraft من SharpHeberg بمتطلبات خادمك أو حزمة موداتك المحددة، وتأكد من توفر بيئة التشغيل قبل الطلب. نقطة البداية الصحيحة هي توافق Minecraft وبرنامج الخادم وJava، وليست قاعدة عامة تقول «ثبّت أحدث Java».