إضافة Minecraft BlueMap

🔌 حول BlueMap

BlueMap هو أداة خرائط لـ Minecraft تقرأ ملفات عالم الخادم وتُنشئ نماذج ثلاثية الأبعاد وعارض ويب تفاعلي. يمكن تشغيله كإضافة خادم أو مود (إضافة Spigot/Paper أو Sponge، أو مود Fabric/Forge) أو كأداة رندر مستقلة عبر سطر الأوامر. عند تثبيته على خادم يعمل بالفعل، يقوم BlueMap بالعرض بشكل غير متزامن، لذلك لا يحجب خيط الخادم الرئيسي.

🎯 الغرض

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

⚙️ الميزات

• يُنشئ نماذج ثلاثية الأبعاد لسطح العالم ويعرضها في عارض ويب يعمل داخل المتصفح.
• يعمل كإضافة/مود (Spigot/Paper، Sponge، Fabric، Forge) أو كأداة CLI مستقلة.
• عرض غير متزامن لتجنب حجب خيط Minecraft server الرئيسي.
• يدعم حزم الموارد وحزم البيانات لتخصيص الخامات ونماذج البلوكات وألوان المناطق الحيوية المستخدمة في العرض.
• يدعم عدة أنظمة تخزين وإدارة الخرائط عبر الأوامر (load، unload، list، delete، إلخ).
• دعم للعلامات وواجهة API كي تتمكن الإضافات الخارجية من إضافة العلامات أو إدارتها على الخرائط.
• أوامر لإعادة التحميل والتحكم في العرض أثناء التشغيل (reload، بدء/إيقاف العرض، تحديث/تنظيف الخرائط، تجميد/إلغاء تجميد الخرائط).

🧩 لمن هو مخصص

• خوادم Survival وSMP التي تريد خريطة ثلاثية الأبعاد عامة أو مخصصة للمسؤولين.
• خوادم Creative أو العرض التي تحتاج إلى معاينات للبناء يمكن الوصول إليها عبر المتصفح.
• مسؤولو الخوادم الذين يحتاجون إلى فحص عن بُعد وأدوات تنقل قائمة على الخريطة.

🏗️ حالات استخدام مثال

• توفير خريطة ثلاثية الأبعاد للعالم مستضافة علنًا لمساعدة اللاعبين على التنقل وعرض المباني.
• يتمكن المسؤول من تحديد قواعد اللاعبين أو مطالباتهم ومراجعتها من عارض الويب قبل زيارتها داخل اللعبة.
• تستخدم إضافة واجهة BlueMap API لعرض علامات ديناميكية للأحداث أو المتاجر أو مواقع النقل.

⌨️ الأوامر

(جميع الأوامر أعلاه موثقة من قبل المشروع؛ وتوجد عقد الأذونات الدقيقة في وثائق المشروع ولم يتم تكرارها هنا.)

⚙️ التثبيت

📥 الإعداد

• نزّل ملف BlueMap JAR المناسب لمنصتك (ملف JAR للإضافة لـ Spigot/Paper/Sponge، أو ملف JAR للمود لـ Fabric/Forge، أو توزيع CLI مستقل).
• ضع ملف JAR في مجلد plugins/ الخاص بالخادم (لـ Spigot/Paper/Sponge) أو في مجلد mods/ (لـ Fabric/Forge)، أو استخدم ملفات توزيع CLI للرندر المستقل.
• ابدأ الخادم أو أعد تشغيله. راقب سجل الخادم للتأكد من أن BlueMap وخادم الويب المدمج قد بدأا بنجاح.

📦 المتطلبات

• لا توجد متطلبات إضافية إلزامية من إضافات خارجية لرسم الخرائط الأساسي. تتوفر عمليات تكامل وإضافات اختيارية؛ راجع وثائق المشروع للحصول على معلومات الإضافات الخارجية.

🧠 ملاحظات تقنية

• يتم توزيع BlueMap كإضافات خادم ومودات وأداة CLI؛ اختر الملف المناسب لإعدادك.
• يتم تنفيذ العرض بشكل غير متزامن لتجنب حجب خيط الخادم الرئيسي.
• يمكن وضع حزم الموارد وحزم البيانات في دليل الحزم المُكوَّن لتغيير مظهر الخريطة.
• يحتفظ المشروع بمستودع مصدر عام وإصدارات جاهزة؛ الإعدادات قائمة على الملفات ويمكن إعادة تحميلها أثناء التشغيل.

🤝 متى تكون هذه الإضافة مفيدة

إذا كنت تحتاج إلى عرض ثلاثي الأبعاد لعالم Minecraft يمكن الوصول إليه من المتصفح للتنقل أو مراجعة البناء أو العرض المجتمعي، فإن BlueMap يوفر عرضًا آليًا وتحكمًا أثناء التشغيل وواجهة API للعلامات والتكاملات دون الحاجة إلى انضمام اللاعبين إلى الخادم.