BlueMap — إضافة لإنشاء خريطة عالم ثلاثية الأبعاد تفاعلية في المتصفح لـ Minecraft
دليل كامل لإضافة BlueMap لـ Minecraft، والتي تنشئ خريطة عالم تفاعلية ثلاثية الأبعاد في المتصفح. الميزات، والأوامر، والتهيئة.
دليل كامل لإضافة BlueMap لـ Minecraft، والتي تنشئ خريطة عالم تفاعلية ثلاثية الأبعاد في المتصفح. الميزات، والأوامر، والتهيئة.
BlueMap — إضافة لإنشاء خريطة عالم ثلاثية الأبعاد تفاعلية في المتصفح لـ Minecraft
BlueMap هي إضافة لـ Minecraft تقرأ ملفات العالم وتبني منها نموذجًا سطحيًا ثلاثي الأبعاد متاحًا في المتصفح عبر خادم ويب مدمج. يعرض العميل القياسي العالم فقط حول اللاعب ولا يوفر رؤية من الأعلى أو من الخارج. تُنشئ الإضافة خريطة كاملة مع إمكانية تدوير الكاميرا، والتبديل إلى الوضع المنظوري أو المتساوي القياس (المسطح) ورؤية الهياكل بمجرد الانتقال إلى رابط. إنها تحل مشكلة واحدة: العرض الخارجي لعالم الخادم دون الحاجة إلى تسجيل الدخول إلى اللعبة.
كيف يعمل العرض (Rendering)
تقوم الإضافة بتقسيم الأجزاء (chunks) إلى مربعات (tiles) وتنشئ طبقتين من التفاصيل: نماذج عالية الدقة (hires) بهندسة الكتل الكاملة وخريطة منخفضة الدقة (lowres) للرؤية عن بُعد. تُنشط الطبقة عالية الدقة عند التكبير عن قرب — حينها تظهر كتل وتراكيب وارتفاعات محددة. في حالة التصغير، يتم تحميل طبقة مبسطة تحتوي على بقع ملونة من المناطق الأحيائية (biomes) والمناظر الطبيعية.

عملية العرض في واجهة الويب: يتم تحميل المربعات تدريجيًا عند التكبير.
يتم العرض بشكل غير متزامن في مجموعة خيوط منفصلة. لا يتم حظر خيط خادم Minecraft — طالما أن المعالج (CPU) يحتوي على نوى فارغة، فلن يشعر اللاعبون بأي تباطؤ ناتج عن بناء الخريطة. تتتبع الإضافة نفسها التغييرات في العالم: تتحقق BlueMap بشكل دوري من ملفات mca، وتلاحظ الأجزاء المتغيرة وتقوم بإعادة عرضها فقط. الأوامر اليدوية مثل /bluemap update نادرًا ما تكون ضرورية — وتستخدم بشكل رئيسي للتشخيص.

العرض في واجهة الويب من منظور الشخص الأول
الأوامر
تسجل الإضافة أمرًا أساسيًا واحدًا هو /bluemap مع أوامر فرعية. لا تتطلب معظم الحالات أي أمر على الإطلاق — فالعرض يعمل تلقائيًا.
الأمر | ماذا يفعل | |
| يعرض حالة العرض وقائمة الانتظار | |
| يُعيد تحميل التكوينات؛ يتخطى | |
| يُوقف ويستأنف جميع العروض (يُحفظ بعد إعادة التشغيل) | |
| يجمد خريطة معينة (بدون تحديثات) | |
| يحذف بيانات الخريطة تمامًا؛ سيتم إعادة عرضها | |
| يفرض تحديث الأجزاء المتغيرة ضمن نصف القطر | |
| يعيد عرض كل شيء، حتى لو لم تكن هناك تغييرات | |
| يبحث عن مشكلات الخريطة النمطية في النقطة المحددة |

تنفيذ الأمر /bluemap
التهيئة
يحتوي مجلد الإضافة على أربعة ملفات تهيئة: core.conf، plugin.conf، webapp.conf، webserver.conf. بالإضافة إلى ثلاثة مجلدات فرعية: maps/ (ملف .conf لكل عالم)، packs/ (حزم الموارد للعرض) و storages/ (file.conf لنظام الملفات، sql.conf لقاعدة بيانات SQL).
core.conf
الملف الرئيسي. المُعلمة الأساسية هي accept-download، والتي يجب تعيينها على true عند التشغيل الأول. تُحدد المُعلمة render-thread-count (الافتراضي 1) عدد خيوط العرض — تعني القيمة السالبة «عدد نوى المعالج ناقص القيمة المطلقة للرقم». تتحكم metrics (true) في إرسال الإحصائيات المجهولة.
plugin.conf
مُعلمات رؤية اللاعبين على الخريطة وسلوك العرض:
المُعلمة | ماذا تفعل |
| ترسل مواقع اللاعبين المتصلين إلى تطبيق الويب |
| الأوضاع التي لا يكون اللاعب مرئيًا فيها. القيم: |
| إخفاء اللاعبين المخفيين بواسطة إضافة إخفاء (vanish) |
| إخفاء اللاعبين الذين لديهم تأثير جرعة الاختفاء |
| إخفاء اللاعبين المتسللين |
| عتبة ضوء الشمس؛ |
| عتبة ضوء الكتلة |
| إزالة اللاعبين الموجودين في عالم آخر من القائمة |
| الثواني بين حفظ العلامات في التخزين؛ |
| الثواني بين حفظ مواقع اللاعبين |
| تحميل الأشكال من Mojang عند دخول اللاعب |
| عدد اللاعبين المتصلين الذي يتوقف عنده العرض؛ |
| الدقائق بين عمليات الفحص الكاملة للتغييرات الفائتة |
webapp.conf
إعدادات تطبيق الويب. تحدد default-to-flat-view (false) العرض الأولي — منظوري أو متساوي القياس. تحدد المتزلجون hires-slider-default (100) و lowres-slider-default (2000) مسافة العرض المفصل والمبسط بالكتل. تقبل resolution-default (1) القيم 0.5 أو 1 أو 2. تربط المصفوفات scripts و styles ملفات JS و CSS مخصصة.
webserver.conf
خادم الويب المدمج. enabled (true) — تفعيل أو تعطيل. port (8100) — المنفذ. webroot ("bluemap/web") — دليل ملفات تطبيق الويب (يجب أن يتطابق مع webroot في webapp.conf). يقوم قسم log بتهيئة تسجيل نشاط HTTP في ملف.
الخاتمة
تتيح BlueMap العرض الخارجي للعالم في شكل نموذج ثلاثي الأبعاد كامل مع دوران الكاميرا والطيران الحر. تعتبر الإضافة مناسبة لخوادم البقاء على قيد الحياة و RPG، حيث يكون من المهم للاعبين مشاركة الإحداثيات وفحص المباني؛ أما بالنسبة لخوادم الألعاب المصغرة التي لا تحتوي على عالم دائم، فهي غير ضرورية.
التثبيت
التثبيت النموذجي يستغرق حوالي 5 دقائق. الخطوات نفسها؛ يختلف فقط المُحمّل والبناء المطابق.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.











