ClassiCube

ClassiCube هو عميل مخصص متوافق مع Minecraft Classic ومكتوب بلغة C من البداية.

مهم

لا ينتمي ClassiCube إلى (أو يدعمه) Mojang AB أو Minecraft أو Microsoft بأي شكل من الأشكال.

لا يحاول ClassiCube تكرار لعبة Minecraft الحديثة.
لن يدعم أبدًا البقاء أو حسابات Minecraft أو خوادم Minecraft الحديثة.

ما هو كلاسي كيوب

يهدف ClassiCube إلى تكرار عميل Minecraft Classic لعام 2009 مع تقديم تحسينات اختيارية لتحسين طريقة اللعب. يمكن تشغيل ClassiCube على العديد من الأنظمة، بما في ذلك سطح المكتب والويب والهاتف المحمول وحتى بعض وحدات التحكم.

الميزات (انقر للتوسيع)

• أداء أفضل بكثير وأقل استخدام للذاكرة مقارنةً بـ Minecraft Classic الأصلية
• التحسينات الاختيارية بما في ذلك الكتل والنماذج وألوان البيئة المخصصة
• يدعم جزئيًا بعض ميزات إصدارات Minecraft Classic قبل 0.30
• يعمل بشكل فعال مع جميع بطاقات الرسومات التي تدعم OpenGL أو Direct3D 9
• يعمل على أنظمة التشغيل Windows وmacOS وLinux وAndroid وiOS وفي متصفح الويب
• يعمل أيضًا على OpenBSD، وFreeBSD، وNetBSD، وSolaris، وHaiku، وIRIX، وSerenityOS
• على الرغم من أنه في مراحل مختلفة من التطوير المبكر، إلا أنه يعمل أيضًا على وحدات تحكم مختلفة

يمكنك تنزيل ClassiCube هنا وأحدث الإصدارات هنا.

نحن بحاجة لمساعدتكم

تسعى ClassiCube جاهدة لتكرار تجربة Minecraft Classic الأصلية من خلال الالتزام الصارم بنهج الهندسة العكسية للغرفة النظيفة .

إذا كنت مهتمًا بتوثيق سلوك لعبة Minecraft Classic الأصلية أو التحقق منها، فيرجى الاتصال على ClassiCube Discord

كيف تلعب

في البداية، ستحتاج إلى تشغيل ClassiCube.exe لتنزيل الأصول المطلوبة من minecraft.net وclassicube.net.
ما عليك سوى النقر فوق "موافق" للوصول إلى قائمة الحوار التي تظهر عند بدء تشغيل المشغل.

ملحوظة: عند التشغيل من داخل VirtualBox، قم بتعطيل Mouse Integration، وإلا فلن تعمل الكاميرا داخل اللعبة بشكل صحيح.

وضع اللاعب المنفرد قم بتشغيل ClassiCube.exe، ثم انقر فوق Singleplayer في القائمة الرئيسية.

وضع متعدد اللاعبين قم بتشغيل ClassiCube.exe. يمكنك الاتصال بخوادم LAN/المستضافة محليًا وخوادم classicube.net إذا كان لديك حساب ClassiCube.

عالقة على برنامج OpenGL 1.1؟

السبب الأكثر شيوعًا للتوقف في OpenGL 1.1 هو عدم عمل برامج تشغيل وحدة معالجة الرسومات - لذلك، إذا أمكن، يجب عليك محاولة تثبيت أو تحديث برامج التشغيل لوحدة معالجة الرسومات الخاصة بك.

خلاف ذلك:

• على نظام التشغيل Windows، لا يزال بإمكانك تشغيل إصدار OpenGL من ClassiCube على أي حال.
  (يمكنك تجربة تنزيل برنامج MESA واستخدامه من هنا للحصول على أداء أفضل قليلًا)
• في أنظمة التشغيل الأخرى، سيتعين عليك تجميع اللعبة بنفسك.
  لا تنس إضافة -DCC_BUILD_GL11 إلى سطر أوامر الترجمة بحيث تدعم اللعبة المترجمة OpenGL 1.1.

الأنظمة المدعومة

يعمل ClassiCube على:

• ويندوز - 95 والإصدارات الأحدث
• macOS - 10.5 أو أحدث (يمكن تجميعه لـ 10.3/10.4 بالرغم من ذلك)
• Linux - يحتاج إلى libcurl و libopenal
• أندرويد - 2.3 أو أحدث
• دائرة الرقابة الداخلية - 8.0 أو في وقت لاحق
• معظم متصفحات الويب (حتى تعمل على IE11)

ويعمل أيضًا على:

• Raspberry Pi - يحتاج إلى libcurl و libopenal
• FreeBSD - يحتاج إلى حزم libexecinfo و curl و openal-soft (يمكن تنزيلها من هنا)
• NetBSD - يحتاج إلى حزم libexecinfo و curl و openal-soft (يمكن تنزيلها من هنا)
• OpenBSD - يحتاج إلى حزم libexecinfo و curl و openal
• سولاريس - يحتاج إلى حزم curl openal
• Haiku - يحتاج إلى حزمة openal (إذا كان لديك حساب GitHub، يمكنك التنزيل من هنا)
• BeOS - لم يتم اختباره على الأجهزة الفعلية
• IRIX - يحتاج إلى حزم curl openal
• SerenityOS - يحتاج إلى SDL2
• نظام التشغيل Mac الكلاسيكي (النظام 7 والإصدارات الأحدث)
• Dreamcast - غير مكتمل، ولكنه قابل للاستخدام (يمكن تنزيله من هنا)
• زحل - مشكلات العرض والاستقرار الرئيسية غير المكتملة (يمكن التنزيل من هنا)
• التبديل - غير مكتمل، ولكنه قابل للاستخدام (يمكن تنزيله من هنا)
• Wii U - مشكلات رئيسية غير مكتملة، معطلة على أجهزة حقيقية (يمكن التنزيل من هنا)
• Wii - غير مكتمل، ولكنه قابل للاستخدام (يمكن تنزيله من هنا)
• لعبة GameCube - غير مكتملة، ولكنها قابلة للاستخدام (يمكن تنزيلها من هنا)
• Nintendo 64 - مشكلات العرض المعتدلة وغير المكتملة (يمكن التنزيل من هنا)
• 3DS - غير مكتمل، ولكنه قابل للاستخدام (يمكن تنزيله من هنا)
• DS/DSi - مشكلات العرض غير المكتملة (يمكن تنزيلها من هنا)
• PS Vita - مشكلات العرض غير المكتملة (يمكن تنزيلها من هنا)
• PSP - مشكلات العرض غير المكتملة (يمكن التنزيل من هنا)
• PS3 - مشكلات العرض غير المكتملة (يمكن التنزيل من هنا)
• PS2 - مشكلات العرض والاستقرار الرئيسية غير المكتملة (يمكن التنزيل من هنا)
• PS1 - مشكلات العرض والاستقرار الرئيسية غير المكتملة (يمكن التنزيل من هنا)
• Xbox 360 - غير مكتمل تمامًا، معطل على أجهزة حقيقية (يمكن تنزيله من هنا)
• Xbox - مشكلات العرض الرئيسية غير المكتملة (يمكن التنزيل من هنا)

تجميع

ملاحظة: تقوم الإرشادات الواردة أدناه بتجميع ClassiCube تلقائيًا مع الإعدادات الافتراضية الموصى بها للنظام الأساسي.
إذا كنت (غير مستحسن) تريد تجاوز الإعدادات الافتراضية (على سبيل المثال، لتجميع إصدار OpenGL على نظام التشغيل Windows)، راجع هنا للحصول على التفاصيل.

تجميع - ويندوز

باستخدام فيجوال ستوديو

1. افتح ClassiCube.sln (ملف -> فتح -> المشروع/الحل)
2. تجميع/إنشاء (إنشاء -> إنشاء الحل) .

إذا حصلت على خطأ في الترجمة The Windows SDK version 5.1 was not found ، فراجع هنا لمعرفة كيفية الإصلاح

استخدام Visual Studio (سطر الأوامر)

1. استخدم "أدوات المطور لبرنامج Visual Studio" من قائمة "ابدأ".
2. انتقل إلى الدليل باستخدام كود مصدر ClassiCube
3. قم بتشغيل cl.exe *.c /link user32.lib gdi32.lib winmm.lib dbghelp.lib shell32.lib comdlg32.lib /out:ClassiCube.exe

باستخدام MinGW-w64

بافتراض أنك استخدمت برنامج التثبيت من https://sourceforge.net/projects/mingw-w64/ :

1. قم بتثبيت MinGW-W64
2. استخدم إما تشغيل Terminal من قائمة ابدأ أو قم بتشغيل mingw-w64.bat في مجلد التثبيت
3. انتقل إلى الدليل باستخدام كود مصدر ClassiCube
4. قم بتشغيل gcc -fno-math-errno *.c -o ClassiCube.exe -mwindows -lwinmm

باستخدام MinGW

بافتراض أنك استخدمت برنامج التثبيت من https://osdn.net/projects/mingw/ :

1. قم بتثبيت MinGW. أنت بحاجة إلى حزم mingw32-base-bin وmsys-base-bin.
2. قم بتشغيل msys.bat في المجلد C:MinGWmsys1.0 .
3. انتقل إلى الدليل باستخدام كود مصدر ClassiCube
4. قم بتشغيل gcc -fno-math-errno *.c -o ClassiCube.exe -mwindows -lwinmm

استخدام TCC (مترجم Tiny C)

إعداد TCC:

1. قم بتنزيل واستخراج tcc-0.9.27-win64-bin.zip من https://bellard.org/tcc/
2. قم بتنزيل winapi-full-for-0.9.27.zip من https://bellard.org/tcc/
3. انسخ مجلد winapi و_ _mingw_dxhelper.h من winapi-full-for-0.9.27.zip إلى مجلد include الخاص بـ TCC

التجميع باستخدام TCC:

1. انتقل إلى الدليل باستخدام كود مصدر ClassiCube
2. في ExtMath.c ، قم بتغيير fabsf إلى fabs و sqrtf إلى sqrt
3. قم بتشغيل tcc.exe -o ClassiCube.exe *.c -lwinmm -lgdi32 -luser32 -lcomdlg32 -lshell32
   (ملاحظة: قد تحتاج إلى تحديد المسار الكامل لـ tcc.exe بدلاً من tcc.exe فقط)

تجميع - لينكس

باستخدام دول مجلس التعاون الخليجي/clang

1. قم بتثبيت مكتبات تطوير X11 وXInput2 وOpenGL إذا لزم الأمر.
   بالنسبة لـ Ubuntu، هذه هي الحزم libx11-dev و libxi-dev و libgl1-mesa-dev
2. تشغيل إما:
   • make linux أو
   • cc -fno-math-errno src/*.c -o ClassiCube -rdynamic -lpthread -lX11 -lXi -lGL -ldl

التجميع المتقاطع لنظام التشغيل Windows (32 بت):

1. قم بتثبيت MinGW-w64 إذا لزم الأمر. (أوبونتو: حزمة gcc-mingw-w64 )
2. قم بتشغيل i686-w64-mingw32-gcc -fno-math-errno src/*.c -o ClassiCube.exe -mwindows -lwinmm

التجميع المتقاطع لنظام التشغيل Windows (64 بت):

1. قم بتثبيت MinGW-w64 إذا لزم الأمر. (أوبونتو: حزمة gcc-mingw-w64 )
2. قم بتشغيل x86_64-w64-mingw32-gcc -fno-math-errno src/*.c -o ClassiCube.exe -mwindows -lwinmm

راسبيري بي

على الرغم من أن إشارات تجميع Linux العادية ستعمل بشكل جيد، إلا أنه لتحقيق الاستفادة الكاملة من الأجهزة:

gcc -fno-math-errno src/*.c -o ClassiCube -DCC_BUILD_RPI -rdynamic -lpthread -lX11 -lXi -lEGL -lGLESv2 -ldl

التجميع - macOS

1. قم بتثبيت مترجم C إذا لزم الأمر. أسهل طريقة للحصول عليها هي تثبيت Xcode .
2. تشغيل إما:
   • make darwin أو
   • cc -fno-math-errno src/*.c src/*.m -o ClassiCube -framework Cocoa -framework OpenGL -framework IOKit -lobjc

باستخدام واجهة المستخدم الرسومية Xcode

1. افتح مشروع misc/macOS/CCMAC.xcodeproj في Xcode
2. تجميع المشروع

تجميع - لنظام Android

ملاحظة: إذا كنت تقوم بتوزيع نسخة معدلة، فيرجى تغيير معرف الحزمة من com.classicube.android.client إلى شيء آخر - وإلا فلن يتمكن مستخدمو Android من تثبيت كل من ClassiCube والإصدار المعدل في نفس الوقت على أجهزة الكمبيوتر الخاصة بهم. جهاز أندرويد

باستخدام Android Studio GUI

افتح مجلد android في Android Studio (شرح المهام بمزيد من التفصيل)

استخدام سطر الأوامر (gradle)

قم بتشغيل gradlew في مجلد Android (شرح المهام بمزيد من التفصيل)

التجميع - لنظام iOS

سيواجه إصدار iOS مشكلات لأنه غير مكتمل ولم يتم اختباره إلا في iOS Simulator

ملاحظة: إذا كنت تقوم بتوزيع نسخة معدلة، فيرجى تغيير معرف الحزمة من com.classicube.ios.client إلى شيء آخر - وإلا فلن يتمكن مستخدمو iOS من تثبيت كل من ClassiCube والإصدار المعدل في نفس الوقت على أجهزة الكمبيوتر الخاصة بهم. جهاز iOS

باستخدام واجهة المستخدم الرسومية Xcode

1. افتح مشروع misc/ios/CCIOS.xcodeproj في Xcode
2. تجميع المشروع

استخدام سطر الأوامر (Xcode)

xcodebuild -sdk iphoneos -configuration Debug (TODO شرح أكثر تفصيلا)

تجميع - عميل الويب

1. قم بتثبيت emscripten إذا لزم الأمر.
2. تشغيل إما:
   • make web أو
   • emcc src/*.c -s ALLOW_MEMORY_GROWTH=1 -s TOTAL_STACK=1Mb --js-library interop_web.js

يحتوي ملف جافا سكريبت الذي تم إنشاؤه على بعض المشكلات. انظر هنا لمعرفة كيفية الإصلاح

للحصول على تفاصيل حول كيفية دمج عميل الويب في موقع ويب، راجع هنا

تجميع - لوحات المفاتيح

تحتاج جميع منافذ وحدة التحكم إلى مساعدة من شخص لديه خبرة في تطوير البيرة المنزلية - إذا كنت مهتمًا، فيرجى الاتصال على ClassiCube Discord.

وحدات تحكم نينتندو (انقر للتوسيع)

يُحوّل

قم بتشغيل make switch . ستحتاج إلى libnx و mesa

ملحوظة: يوصى بشدة بتثبيت حزم devkitpro المترجمة مسبقًا من هنا - تحتاج إلى مجموعة switch-dev وحزم switch-mesa switch-glm )

وي يو

قم بتشغيل make wiiu . سوف تحتاج wut

ملحوظة: يوصى بشدة بتثبيت حزم devkitpro المترجمة مسبقًا من هنا - تحتاج إلى مجموعة wiiu-dev )

3DS

تشغيل make 3ds . ستحتاج إلى libctru

ملحوظة: يوصى بشدة بتثبيت حزم devkitpro المترجمة مسبقًا من هنا - أنت بحاجة إلى مجموعة 3ds-dev )

وي

قم بتشغيل make wii . ستحتاج إلى libogc

ملحوظة: يوصى بشدة بتثبيت حزم devkitpro المترجمة مسبقًا من هنا - تحتاج إلى مجموعة wii-dev )

لعبة المكعب

تشغيل make gamecube . ستحتاج إلى libogc

ملحوظة: يوصى بشدة بتثبيت حزم devkitpro المترجمة مسبقًا من هنا - تحتاج إلى مجموعة gamecube-dev )

نينتندو دي إس/دي إس آي

تشغيل make ds . ستحتاج إلى BlockDS

نينتندو 64

تشغيل make n64 . ستحتاج إلى فرع opengl من libdragon

وحدات تحكم سوني (انقر للتوسيع)

بلاي ستيشن فيتا

تشغيل make vita . سوف تحتاج إلى vitasdk

بلاي ستيشن محمولة

تشغيل make psp . ستحتاج إلى pspsdk

ملاحظة: يوصى بتثبيت إصدار pspsdk المترجم مسبقًا من هنا

بلاي ستيشن 3

تشغيل make ps3 . ستحتاج إلى PSL1GHT

بلاي ستيشن 2

تشغيل make ps2 . ستحتاج إلى ps2sdk

بلاي ستيشن 1

تشغيل make ps1 . ستحتاج إلى PSn00bSDK

وحدات تحكم Microsoft (انقر للتوسيع)

اكس بوكس ​​360

تشغيل make 360 . سوف تحتاج ليبزينون

اكس بوكس ​​(الأصلي)

تشغيل make xbox ​​. ستحتاج إلى nxdk

وحدات تحكم SEGA (انقر للتوسيع)

وحدات تحكم سيجا

دريم كاست

قم بتشغيل make dreamcast . سوف تحتاج إلى KallistiOS

زحل

تشغيل make saturn . سوف تحتاج libyaul

التجميع - الأنظمة الأساسية الأخرى (انقر للتوسيع)

فري بي إس دي

1. قم بتثبيت حزم libxi و libexecinfo و curl و openal-soft إذا لزم الأمر
2. تشغيل إما:
   • make freebsd أو
   • cc src/*.c -o ClassiCube -I /usr/local/include -L /usr/local/lib -lm -lpthread -lX11 -lXi -lGL -lexecinfo

أوبن بي إس دي

1. قم بتثبيت الحزم libexecinfo و curl و openal إذا لزم الأمر
2. تشغيل إما:
   • make opensd أو
   • cc src/*.c -o ClassiCube -I /usr/X11R6/include -I /usr/local/include -L /usr/X11R6/lib -L /usr/local/lib -lm -lpthread -lX11 -lXi -lGL -lexecinfo

نت بي إس دي

1. قم بتثبيت حزم libexecinfo و curl و openal-soft إذا لزم الأمر
2. تشغيل إما:
   • make netbsd أو
   • cc src/*.c -o ClassiCube -I /usr/X11R7/include -I /usr/pkg/include -L /usr/X11R7/lib -L /usr/pkg/lib -lpthread -lX11 -lXi -lGL -lexecinfo

اليعسوب BSD

1. قم بتثبيت حزم libxi و libexecinfo و curl و openal-soft إذا لزم الأمر
2. تشغيل إما:
   • make dragonfly أو
   • cc src/*.c -o ClassiCube -I /usr/local/include -L /usr/local/lib -lm -lpthread -lX11 -lXi -lGL -lexecinfo

سولاريس

1. قم بتثبيت الحزم المطلوبة إذا لزم الأمر
2. تشغيل إما:
   • make sunos أو
   • gcc -fno-math-errno src/*.c -o ClassiCube -lsocket -lX11 -lXi -lGL

هايكو

1. قم بتثبيت حزم gcc و haiku_devel و openal_devel إذا لزم الأمر
2. تشغيل إما:
   • make haiku أو
   • cc -fno-math-errno src/*.c src/*.cpp -o ClassiCube -lGL -lnetwork -lstdc++ -lbe -lgame -ltracker

بيوس

1. تثبيت مترجم C
2. تشغيل إما:
   • make beos أو
   • cc -fno-math-errno src/*.c src/*.cpp -o ClassiCube -lGL -lbe -lgame -ltracker

إيريكس

1. قم بتثبيت الحزم المطلوبة إذا لزم الأمر
2. تشغيل إما:
   • make irix أو
   • دول مجلس التعاون الخليجي -fno-math-errno src/*.c -o ClassiCube -lGL -lX11 -lXi -lpthread -ldl`

سيرينيتيOS

1. قم بتثبيت منفذ SDL2 إذا لزم الأمر
2. تشغيل إما:
   • make serenityos أو
   • cc src/*.c -o ClassiCube -lgl -lSDL2

نظام التشغيل ماك الكلاسيكي

1. قم بتثبيت Retro68
2. تشغيل إما
   • make macclassic_68k (لبناء M68k)
   • make macclassic_ppc (لإنشاء PPC)

عادةً ما يكون أداء إصدار PowerPC أفضل بكثير

أنظمة أخرى

سيكون عليك كتابة الكود اللازم. يجب عليك قراءة portability.md في مجلد doc.

التوثيق

يتم توثيق الوظائف والمتغيرات في ملفات .h في الغالب.

يمكن العثور على مزيد من المعلومات (على سبيل المثال النمط) للكود المصدري لـ ClassiCube في مجلدات doc وmisc.

أخطاء التجميع المعروفة

إصلاحات لأخطاء الترجمة عند استخدام musl أو glibc القديم لمكتبة C القياسية

نصائح

• اضغط على مفتاح الهروب (بعد الانضمام إلى العالم) أو توقف مؤقتًا للتبديل إلى قائمة الإيقاف المؤقت.

• قائمة الإيقاف المؤقت -> الخيارات -> عناصر التحكم تسرد جميع مجموعات المفاتيح التي يستخدمها العميل.

• لاحظ أن تبديل "vsync" إلى وضع التشغيل سيؤدي إلى تقليل استخدام وحدة المعالجة المركزية، بينما سيؤدي إيقاف تشغيله إلى زيادة سرعة تحميل القطعة إلى الحد الأقصى.

• اضغط على F لتدوير مسافة العرض. يمكن أن تؤدي مسافات الرؤية المنخفضة إلى تحسين الأداء.

• إذا قام الخادم بتعطيل عمليات الاختراق، فلن تفعل مجموعات المفاتيح مثل الطيران والسرعة أي شيء.

• لرؤية قائمة الأوامر المضمنة، اكتب /client .

• لرؤية تعليمات لأمر مضمّن، اكتب /client help <command name> .

تقنيات مفتوحة المصدر (انقر للتوسيع)

• حليقة - HTTP/HTTPS لنظام التشغيل Linux وmacOS
• FreeType - التعامل مع الخطوط لجميع المنصات
• دول مجلس التعاون الخليجي - يجمع العميل لينكس
• MinGW-w64 - يجمع العميل لنظام التشغيل Windows
• Clang - يجمع العميل لنظام التشغيل macOS
• Emscripten - يجمع العميل للويب
• RenderDoc - تصحيح أخطاء الرسومات
• BearSSL - دعم SSL/TLS على وحدات التحكم
• libnx - الواجهة الخلفية للتبديل
• Ryujinx - المحاكي المستخدم لاختبار منفذ التبديل
• wut - الواجهة الخلفية لجهاز Wii U
• Cemu - محاكي يستخدم لاختبار منفذ Wii U
• libctru - الواجهة الخلفية لـ 3DS
• citro3D - تقديم الواجهة الخلفية لـ 3DS
• Citra - محاكي يستخدم لاختبار منفذ 3DS
• libogc - الواجهة الخلفية لأجهزة Wii وGameCube
• libfat - الواجهة الخلفية لنظام الملفات لـ Wii/GC
• Dolphin - محاكي يستخدم لاختبار منفذ Wii/GC
• libdragon - الواجهة الخلفية لنينتندو 64
• آريس - المحاكي المستخدم لاختبار منفذ نينتندو 64
• BlocksDS - الواجهة الخلفية لنينتندو DS
• melonDS - المحاكي المستخدم لاختبار منفذ Nintendo DS
• vitasdk - الواجهة الخلفية لـ PS Vita
• Vita3K - المحاكي المستخدم لاختبار منفذ Vita
• pspsdk - الواجهة الخلفية لـ PSP
• PPSSPP - المحاكي المستخدم لاختبار منفذ PSP
• PSL1GHT - الواجهة الخلفية لجهاز PS3
• RPCS3 - المحاكي المستخدم لاختبار منفذ PS3
• ps2sdk - الواجهة الخلفية لـ PS2
• PCSX2 - المحاكي المستخدم لاختبار منفذ PS2
• PSn00bSDK - الواجهة الخلفية لجهاز PS1
• duckstation - محاكي يستخدم لاختبار منفذ PS1
• libxenon - الواجهة الخلفية لأجهزة Xbox 360
• nxdk - الواجهة الخلفية لأجهزة Xbox
• xemu - المحاكي المستخدم لاختبار منفذ Xbox
• cxbx-reloaded - المحاكي المستخدم لاختبار منفذ Xbox
• KallistiOS - الواجهة الخلفية لـ Dreamcast
• GLdc - أساس عرض الواجهة الخلفية لـ Dreamcast
• flycast - المحاكي المستخدم لاختبار منفذ Dreamcast
• libyaul - الواجهة الخلفية لزحل
• mednafen - محاكي يستخدم لاختبار منفذ Saturn

اعتمادات الصوت

يستخدم ClassiCube الأصوات من Freesound.org
يتم سرد الاعتمادات الكاملة في doc/sound-credits.md