HypixelSkyBlock

هذا هو تنفيذ Minestom للاستجمام Hypixel-SkyBlock المستضاف على الخادم الخاص بي على discord.gg/theatlas. هذا التنفيذ ليس قريبًا من الاكتمال وليس جاهزًا للإنتاج. لا تزال هناك أجزاء من قاعدة التعليمات البرمجية فوضوية ولا تتبع ممارسات Minestom القياسية المناسبة.

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

إعادة إنشاء 1.8 إلى 1.21 لـ HypixelSkyBlock باستخدام Minestom، بهدف الحصول على قاعدة تعليمات برمجية مجردة بشكل صحيح وقابلة للتطوير.

الإصدارات

يتم نشر الإصدارات تلقائيًا عند الضغط على صفحة إصدارات GitHub والتي يمكن العثور عليها هنا. يتم أيضًا إرسال التحديثات بشكل دوري داخل خادم Discord الموجود على discord.gg/theatlas.

جافادوكس

يمكن العثور على Javadocs هنا.

مواصفات الجهاز الموصى بها

ليس المقصود من هذا المشروع أن يكون خادمًا صغيرًا، وعلى هذا النحو، فهو يتطلب قدرًا لا بأس به من الموارد لتشغيله. فيما يلي الحد الأدنى من المواصفات لتشغيل هذا الخادم:

• ذاكرة وصول عشوائي (RAM) سعة 16 جيجابايت (4 جيجابايت لـ MongoDB، و12 جيجابايت عبر الخوادم والخدمات)
• 6 نوى (للحصول على خيوط متعددة كافية)
• 15 جيجابايت من التخزين

دليل الإعداد

يمكن العثور على مقطع فيديو لي وأنا أتصفح الدليل هنا

1. تأكد من استيفاء مواصفات الجهاز الموصى بها أعلاه.
2. ابدأ تشغيل خدمة MongoDB إما محليًا أو عن بعد، ويمكن العثور على دليل التثبيت هنا.
3. تأكد من تثبيت Java 21 SDK.
4. قم بتشغيل خادم Redis، إذا كنت تستخدم نظام التشغيل Windows، فيمكنك تشغيل برنامج التثبيت هنا
5. اتبع "دليل إعداد الوكيل" أدناه. (ملاحظة، إذا كنت تريد تشغيل خادم متصدع، فيجب عليك تعيين "require-authentication" على "صحيح" في التكوين الخاص بك)
6. اتبع "دليل إعداد خادم اللعبة" أدناه. (ملاحظة، إذا كنت تريد تشغيل خادم متصدع، فيجب عليك تعيين "require-authentication" على "صحيح" في التكوين الخاص بك)
7. اتبع "دليل إعداد الخدمة" أدناه.
8. اتبع "دليل إعداد حزمة الموارد" أدناه.
9. لتمنح نفسك المسؤول، قم بتسجيل الدخول والخروج من الخادم، وانتقل إلى بوصلة MongoDB، وانقر فوق Minestom -> البيانات، وابحث عن ملف التعريف الخاص بك وقم بتعيين رتبتك إلى "ADMIN". قم بتسجيل الدخول مرة أخرى وسيكون لديك.

دليل إعداد الوكيل

1. قم بتنزيل "SkyBlockProxy.jar" من صفحة الإصدارات هنا
2. قم بتحميل وكيل السرعة من هنا
3. قم بتنزيل velocity.toml من هنا وانقله إلى المكان الذي تريد تشغيل الخادم الوكيل فيه.
4. انقل وكيل Velocity JAR إلى هذا المجلد أيضًا، وقم بتشغيل الوكيل باستخدام java -jar velocity-3.3.0-SNAPSHOT-400.jar كأمر في هذا الدليل.
5. أغلق هذا الوكيل بمجرد إنشاء مجلد plugins ، فقط بالضغط على CTRL + C أو إغلاق موجه CMD.
6. انقل SkyBlockProxy.jar من السابق إلى مجلد المكونات الإضافية.
7. قم بإنشاء مجلد جديد حيث يوجد ملف velocity.toml الخاص بك وقم بتسميته configuration
8. قم بتحميل resources.json من هنا
9. انقل هذا الملف إلى مجلد configuration الذي قمت بإنشائه للتو.
10. ابدأ تشغيل الوكيل مرة أخرى باستخدام java -jar velocity-3.3.0-SNAPSHOT-400.jar . يجب أن يكون هذا قيد التشغيل حتى تعمل خوادم اللعبة.

دليل إعداد خادم اللعبة

1. قم بتنزيل "SkyBlockCore.jar" من صفحة الإصدارات هنا
2. قم بإنشاء مجلد يسمى configuration في نفس الدليل مثل ملف JAR. (لاحظ أنه يجب وضع هذا بشكل مختلف عن مكان وجود الوكيل الخاص بك)
3. قم بتحميل resources.json من هنا
4. انقل هذا الملف إلى مجلد configuration الذي قمت بإنشائه للتو.
5. قم بتنزيل ملفات العالم الخاصة بعالمي Hub وIsland.
6. احصل على Hypixel SkyBlock hub من التنزيل أعلاه وضعه في مجلد التكوين الذي قمت بإنشائه تحت اسم hypixel_hub .
7. احصل على القالب الافتراضي لـ Hypixel Island من التنزيل أعلاه وضعه في مجلد التكوين الذي قمت بإنشائه تحت الاسم hypixel_island_template .
8. يجب أن يكون هناك ملف forwarding.secret حيث يوجد Velocity JAR الخاص بك، خذ هذا الملف وضعه في resources.json الخاص بك ضمن velocity-secret .
9. قم بتشغيل الجرة باستخدام java -jar {Insert the JAR file} ISLAND ، سيؤدي هذا إلى إنشاء خادم Island الذي سيلتصق بالوكيل قيد التشغيل.
10. لإنشاء خوادم ألعاب أخرى للجزر الأخرى، ما عليك سوى تشغيل الأمر أعلاه مرة أخرى ولكن مع أنواع جزر مختلفة، يمكنك رؤية جميع الأنواع الممكنة هنا.
11. قم بتحميل NanoLimbo-1.7-all.jar من هنا، وقم بتنزيل ملف التكوين الخاص به من نفس المكان. ابدأ تشغيله في الخلفية باستخدام java -jar NanoLimbo-1.7-all.jar .
12. قم بتنزيل Minestom.regions.csv من هنا وقم بتحميلها إلى مجموعة regions التي تم إنشاؤها في Mongo بعد بدء تشغيل الخادم. بمجرد الانتهاء من ذلك، قم بإعادة تشغيل الخادم الخاص بك.
13. (اختياري) إذا كنت ترغب في الحصول على أرواح خرافية، فقم بتنزيل Minestom.fairysouls.csv من هنا وقم بتحميلها إلى مجموعة fairysouls التي تم إنشاؤها في Mongo بعد بدء تشغيل الخادم. بمجرد الانتهاء من ذلك، قم بإعادة تشغيل الخادم الخاص بك.
14. (اختياري) إذا كنت ترغب في الحصول على بلورات Hub (يمكنك أيضًا /addcrystal فقط)، قم بتنزيل Minestom.crystals.csv من هنا وقم بتحميلها إلى مجموعة crystals التي تم إنشاؤها في Mongo بعد بدء تشغيل الخادم. بمجرد الانتهاء من ذلك، قم بإعادة تشغيل الخادم الخاص بك.
15. (اختياري) إذا كنت ترغب في الحصول على الأغاني على الخادم الخاص بك، فانسخ مجلد songs من هنا، ثم ضعه داخل مجلد التكوين الخاص بك.

دليل إعداد الخدمة

1. نظرًا لطبيعة SkyBlock، قد يكون هناك مجموعة متنوعة من الخدمات التي يلزم تشغيلها. انتقل إلى صفحة الإصدارات هنا وقم بتنزيل أي ملفات .JAR تبدأ بـ Service .
2. انقل ملفات JAR هذه إلى نفس الدليل مثل خوادم اللعبة لديك، وسوف تشارك تكوين JSON مع الخدمات.
3. قم بتشغيلها باستخدام java -jar {Insert the JAR file} .

دليل إعداد حزمة الموارد

1. استعدادًا للإصدار 1 من SkyBlock، لدينا بالفعل إعداد نظام حزمة الموارد. للبدء، قم بتنزيل SkyBlockPacker.jar من صفحة الإصدارات هنا.
2. قم بتنزيل مجلدات pack_textures وSkyBlockPack وانقلها إلى مكان وجود برنامج التعبئة JAR.
3. قم بتشغيل أداة التعبئة JAR باستخدام java -jar SkyBlockPacker.jar -v (Location of SkyBlockPack) -o (Output Directory) -t (Location of Pack Textures) .
4. بمجرد الانتهاء من ذلك، يجب أن يكون لديك حزمة موارد في دليل الإخراج الذي حددته. ما عليك سوى تطبيق هذا على Minecraft وستكون جاهزًا للانطلاق.

القضايا المشتركة

1. redis.clients.jedis.exceptions.JedisConnectionException: Failed to connect to any host resolved for DNS name.

   => جهاز Memurai الخاص بك لا يعمل.

2. Preview features are not enabled for... Try running with '--enable-preview'

   => جرب java --enable-preview -jar SkyBlockCore.jar {ServerType}

الاعتمادات

شكرا ل:

• جميع الأشخاص الرائعين في Minestom Discord لحملهم بمفردهم كل معرفتي حول واجهة برمجة التطبيقات هذه.
• أنا وأي مساهمين آخرين، والتي يمكن مشاهدتها على صفحة Git هذه.