التثبيت والتحديث
يدعم GPCL Windows 10 / 11 بنسخة 64 بت فقط. لا تتضمن حزمة التثبيت Java؛ إذ يضيف المشغّل ما يلزم بحسب إصدار اللعبة.
التنزيل
احصل على حزمة التثبيت من قسم التنزيل في الموقع أو من GitHub Releases؛ اسم الملف GPCL-<version>-Setup.exe.
لا تحصل على حزمة التثبيت من خدمات التخزين السحابي أو ملفات المجموعات أو مواقع تنزيل طرف ثالث: قد تكون هذه الملفات مستبدلة، ولا يستطيع المشغّل التحقق من مصدرها.
التثبيت
- انقر نقرًا مزدوجًا على حزمة التثبيت واختر مجلد التثبيت.
- بعد الانتهاء شغّل GPCL من سطح المكتب أو من قائمة ابدأ.
- في التشغيل الأول تُنشأ الإعدادات والسجلات ومجلد اللعبة الافتراضي.
لا حاجة إلى إزالة التثبيت قبل الترقية من إصدار أقدم. تتولى حزمة التثبيت التثبيت السابق في مكانه (بما في ذلك حزم NSIS الأقدم)، ويبقى اختصار سطح المكتب والبيانات كما هي.
أين تُحفظ اللعبة والإعدادات
كل شيء في %APPDATA%\gpcl وليس في مجلد التثبيت:
| المسار | المحتوى |
|---|---|
%APPDATA%\gpcl\.minecraft | إصدارات اللعبة والمكتبات والمواد والمودات وحفظ اللعبة |
%APPDATA%\gpcl\gpcl\config\setting.ini | إعدادات المشغّل |
%APPDATA%\gpcl\gpcl\log | سجلات المشغّل |
%APPDATA%\gpcl\gpcl\updata | حزم التثبيت التي نزّلها التحديث التلقائي وسجلات التقدّم |
إذا غيّرت مجلد اللعبة، تنتقل الإصدارات والمواد إلى الموقع الجديد، لكن الإعدادات والسجلات تبقى في %APPDATA%\gpcl.
ضبط لغة اللعبة تلقائيًا
خيار الإعدادات ← اللعبة ← ضبط لغة اللعبة تلقائيًا مُفعّل افتراضيًا، واللغة المختارة هي الصينية المبسّطة. قبل كل تشغيل يغيّر GPCL قيمة lang: في options.txt الذي يستخدمه الإصدار الحالي فعليًا إلى القيمة المختارة، ويترك بقية الأسطر كما هي.
تُكتب القيمة للإصدارات المعزولة في versions/<version-name>/options.txt، ولغير المعزولة في options.txt بجذر مجلد اللعبة. وإيقاف هذا الخيار يعني عدم لمس إعدادات اللعبة إطلاقًا.
التحديث
خياران مفعّلان افتراضيًا:
- التحقق التلقائي من التحديثات: يتحقق عند التشغيل، وإذا وُجد إصدار جديد يظهر تنبيه في أعلى اليمين.
- تثبيت التحديثات تلقائيًا: يُنزّل التحديث بصمت في الخلفية دون استخدام صفحة التنزيل ودون تغيير شريط الحالة. بعد نجاح التحقق يُثبَّت بصمت عند خروجك من المشغّل.
تعرض الشارة الدائرية في أعلى اليمين تقدّم التنزيل؛ وبالنقر عليها ترى رقم الإصدار وما الجديد فيه. ويمكنك أيضًا النقر على «التنزيل الآن» هناك، وبعد التثبيت يُعاد فتح المشغّل تلقائيًا.
يمكنك في الإعدادات ← حول إيقاف التحقق التلقائي أو التثبيت التلقائي، أو النقر على «التحقق من التحديثات» يدويًا.
تُتحقق حزمة التحديث بـ SHA1 قبل التثبيت، ولا تُثبَّت إذا فشل التحقق. وإذا انقطع التثبيت في المنتصف، يظهر عند التشغيل التالي تنبيه «التحديث السابق لم يكتمل» مع إمكانية إعادة المحاولة؛ وبعد ثلاث محاولات فاشلة متتالية يرشدك المشغّل إلى تنزيل حزمة التثبيت من الموقع من جديد.
الإصدارات القديمة لا تعرف بعد معاملات التثبيت الصامت، لذا سيعرض هذا التحديث معالج التثبيت القديم مرة واحدة. بدءًا من 1.6.0 يصبح التثبيت صامتًا بالكامل.
إذا لم يفتح المشغّل بعد التحديث، فاطّلع أولًا على أحدث سجل في %APPDATA%\gpcl\gpcl\log ثم أرسل بريدًا مع السجل.
استيراد إصدار محلي
في صفحة التشغيل افتح لوحة «اختيار الإصدار» وانقر على «استيراد إصدار محلي». يمكن استيراد:
- مجلد إصدار (يجب أن يحتوي على
<version-name>.json)؛ - أرشيف zip أو jar؛ حيث يفكّه المشغّل ويبحث تكراريًا عن المجلد الذي يحتوي
<version-name>.json؛
حزم المودات (التي يحتوي manifest.json فيها على قسم minecraft) لا يمكن استيرادها حاليًا؛ يرفضها المشغّل مباشرة ولا يثبّت جزءًا منها.
إزالة التثبيت
أزل GPCL من «التطبيقات والميزات» في Windows. برنامج إزالة التثبيت لا يحذف %APPDATA%\gpcl، لذا تبقى اللعبة والإعدادات بعد إعادة التثبيت.
إذا تأكدت أنك لن تستخدمه، يمكنك حذف مجلد %APPDATA%\gpcl بالكامل يدويًا. خذ نسخة احتياطية من ملفات الحفظ قبل الحذف.