دليل BlueMap: خريطة ويب ثلاثية الأبعاد لخادم Minecraft الخاص بك

ما هو BlueMap

يقرأ BlueMap ملفات عالمك ويحوّلها إلى مربعات خريطة ثلاثية الأبعاد ويقدّمها عبر خادم ويب صغير مدمج. عند التكبير ترى الكتل بأبعادها الثلاثة كاملة، وعند التصغير ترى نظرة عامة مسطحة. تُظهر العلامات الحيّة مواقع اللاعبين، وتتحدّث الخريطة مع تغيّر العالم.

يعرض عوالم Java Edition فقط. يأتي الإصدار الحالي، BlueMap 5.29، بنسخ لـ:

لإصدار أقدم من Minecraft، نزّل إصدارًا أقدم من BlueMap يذكره. كل إصدار على Modrinth وHangar يوضح الإصدارات التي يدعمها.

تثبيت BlueMap

1. نزّل الملف المناسب لخادمك من Modrinth أو Hangar أو إصدارات BlueMap على GitHub: ملف jar ‏-paper لـ Paper، و-fabric لـ Fabric، وهكذا.
2. ضعه في مجلد plugins ‏(Paper وSpigot) أو مجلد mods ‏(Fabric وForge وNeoForge) وأعد تشغيل الخادم. رفع الإضافات مشروح في كيفية تثبيت إضافات Minecraft.
3. ينشئ BlueMap إعداداته في plugins/BlueMap/، أو في config/bluemap/ على الخوادم المعدّلة، مع خريطة جاهزة لكل عالم من عوالمك.

في هذه المرحلة تخبرك وحدة التحكم أن BlueMap في وضع الانتظار. لن يعرض أي شيء حتى توافق على التنزيل، وهي الخطوة التالية.

الموافقة على التنزيل في core.conf

لرسم الكتل، يحتاج BlueMap إلى الخامات والنماذج من عميل Minecraft، ويقوم بتنزيلها من Mojang. افتح core.conf وغيّر:

accept-download: true

بتفعيل هذا الإعداد توافق على EULA الخاصة بـ Mojang وتؤكد أنك تملك Minecraft Java Edition. احفظ الملف ونفّذ /bluemap reload، أو أعد التشغيل. سيقوم BlueMap بتنزيل الموارد ويبدأ العرض.

خصّص منفذًا مستقلًا لخريطة الويب

يستمع خادم الويب في BlueMap افتراضيًا على المنفذ 8100. على جهازك الخاص، افتح هذا المنفذ وزر http://your-ip:8100. على الخوادم المستضافة لا يمكنك عادةً اختيار المنفذ بحرية، لذا تستخدم منفذًا مخصصًا لخادمك:

1. احصل على منفذ ثانٍ لخادمك. في HytHost، افتح تبويب Network في اللوحة وأضف تخصيصًا: تختار اللوحة منفذًا متاحًا وتفتحه لك.
2. افتح webserver.conf واضبط port على ذلك الرقم:

   port: 25570

3. نفّذ /bluemap reload وافتح http://your-server-ip:25570 في المتصفح.

لا تستخدم منفذ اللعبة، فهو خاص بـ Minecraft. لعرض الخريطة على نطاقك الخاص دون رقم منفذ، ضع أمامها وكيلًا عكسيًا مثل nginx؛ تحتوي وثائق BlueMap على أمثلة جاهزة.

أوامر BlueMap

لكل أمر صلاحية بالشكل bluemap.<command>، مثل bluemap.reload. في أغلب الأوقات لن تحتاج إلى أيٍّ منها: يلاحظ BlueMap التغييرات في العالم ويعرضها تلقائيًا.

أبقِ العرض خفيفًا

يعرض BlueMap في خيوط خلفية لا على الخيط الرئيسي للخادم، لكن العرض يستهلك CPU مع ذلك. العرض الأول لعالم كبير هو الجزء الثقيل؛ بعده تُعاد رسم الـ chunks المتغيرة فقط.

• خيوط العرض: اضبط render-thread-count في core.conf. تقترح وثائق BlueMap القيمة 1 على الأجهزة ذات أربع أنوية أو أقل.
• اعرض في أوقات الهدوء: نفّذ /bluemap stop في ساعات الذروة و/bluemap start ليلًا أثناء العرض الأول.
• أوقف مؤقتًا عند وجود لاعبين: الإعداد player-render-limit في plugin.conf يوقف العرض عندما يصل عدد اللاعبين المتصلين إلى ذلك الرقم.
• اضبط حدود العالم. فهي تمنع الخريطة، وعمل العرض معها، من النمو بلا نهاية مع استكشاف اللاعبين.
• جمّد الخرائط التي لا تحتاجها حيّة، مثل End بعد استكشافه.

التخزين: ملفات أم قاعدة بيانات

افتراضيًا يخزّن BlueMap الخريطة كملفات مضغوطة في bluemap/web/maps ضمن مساحة تخزين خادمك. تكبر الخريطة مع المساحة المستكشفة، لذا راقب مساحة القرص في العوالم الكبيرة.

يمكنك بدلًا من ذلك نقل الخريطة إلى قاعدة بيانات. في storages/sql.conf اضبط الاتصال بـ MySQL أو MariaDB أو PostgreSQL أو SQLite، ثم اضبط storage: "sql" في ملف إعدادات الخريطة وأعد التحميل:

connection-url: "jdbc:mysql://DB_HOST:3306/DB_NAME"
connection-properties: {
    user: "DB_USER",
    password: "DB_PASSWORD"
}

يأتي Paper مع مشغّل MySQL؛ أما Spigot وFabric وForge فتحتاج إلى إضافة مشغّل JDBC. تتضمن كل باقة Minecraft من HytHost قواعد بيانات MySQL، تنشئها من تبويب Databases في اللوحة.