Dynmap هي عائلة من إضافات Minecraft وتعديلات الـmod توفّر خرائط ويب مباشرة لخوادم Minecraft. تقوم بعرض بلاطات الخريطة للعوالم المحمّلة وتوفّر واجهة خريطة تفاعلية يمكنها عرض العلامات والمناطق والخطوط ومواقع اللاعبين المباشرة وفقاعات الدردشة. يدعم Dynmap تشغيل خادمه الداخلي للويب أو تصدير بيانات الخريطة للاستضافة الخارجية، كما يوفّر عدة خلفيات للتخزين.

🎯 الهدف

الهدف الأساسي لـ Dynmap هو منح مسؤولي الخادم واللاعبين عرضًا مباشرًا وقابلًا للتنقّل في المتصفح لتضاريس الخادم ونشاطه. وهو يحل مشكلة تصور تخطيطات العالم، وتتبع مواقع اللاعبين، ونشر خرائط الخادم للمستخدمين، وإنشاء خرائط مشروحة بعلامات ومناطق.

⚙️ الميزات

عرض بلاطات عوالم الخادم في الوقت الفعلي (عدة طرق عرض للخرائط وأوضاع للرندر).
علامات ومناطق وخطوط قابلة للتخصيص لإضافة توضيحات على الخرائط للاعبين أو الطاقم.
تتبع مباشر للاعبين مع فقاعات دردشة اختيارية / تكامل دردشة من الويب إلى اللعبة.
عدة خلفيات للتخزين: ملفات مسطحة، وMySQL/SQLite/PostgreSQL/MariaDB، ودعم AWS S3 لتخزين الخريطة/الويب.
خادم ويب مدمج لعرض واجهة الخريطة؛ ويمكن تكييفه لنشر/رفع محتوى موقع ثابت إلى تخزين خارجي.
بنى متعددة المنصات: تتوفر حزم مخصصة لـ Spigot/Paper وForge وFabric.

🧩 لمن هذا مناسب

مالكي الخوادم والمسؤولين الذين يريدون خريطة قابلة للتصفح لعوالمهم.
خوادم SMP وsurvival العامة التي تنشر الخرائط للاعبين.
خوادم minigame أو roleplay التي تحتاج إلى خرائط مشروحة أو علامات spawn أو طبقات فوقية للمناطق.
المستضيفون الذين يحتاجون إلى خيارات مرنة للتخزين/النسخ الخلفي (SQL أو S3) للخرائط الكبيرة.

🏗️ أمثلة استخدام

عرض ونشر خريطة overworld مباشرة ليتمكن اللاعبون من رؤيتها عبر الإنترنت.
وضع علامات على المدن والمتاجر والمعالم البارزة بعلامات مخصصة وحدود للمناطق.
تشغيل عروض render مجدولة أو عند الطلب للقطع التي تم استكشافها حديثًا (render بنصف قطر أو للعالم بالكامل).

⌨️ الأوامر

Command	Description	Permission	Access
`/dynmap render`	طلب render/تحديث يدوي لبلاطات الخريطة أو الخرائط.	`dynmap.render`	Admin
`/dynmap radiusrender <radius> [mapname]`	عرض بلاطات الخريطة ضمن نصف قطر حول اللاعب للخريطة المحددة.	`dynmap.render`	Admin

(ملاحظة: يوفّر Dynmap مجموعة أكبر من أوامر الخرائط والإعدادات في التوثيق الرسمي.)

🔐 الأذونات

Permission	Description	Default
`dynmap.render`	يسمح باستخدام الأوامر المتعلقة بالـrender مثل `/dynmap render`.	غير محدد

⚙️ التثبيت

📥 الإعداد

حمّل ملف JAR الرسمي لـ Dynmap الخاص بمنصة خادمك وضعه في مجلد plugins/ (أو mods/ لـ Forge/Fabric) على الخادم.
أعد تشغيل الخادم وتحقق من وحدة تحكم الخادم للتأكد من أن Dynmap تم تحميله وأنه أنشأ مجلدات الإعدادات والخرائط.
اضبط الخرائط والعلامات وخلفية التخزين وخيارات خادم الويب في ملفات إعدادات Dynmap التي يتم إنشاؤها عند التشغيل الأول.

📦 التبعيات

تتضمن إصدارات Dynmap دعمًا لمشغلات JDBC في العديد من توزيعات Spigot/Paper؛ وقد تتطلب المنصات الأخرى مشغلات إضافية أو تعديلات توافق لخلفيات SQL.
يتم توفير إضافات التكامل (مثل WorldGuard وTowny وCitizens) عبر تكاملات Dynmap منفصلة؛ وهي ليست تبعيات تشغيل إلزامية.

🧾 الإعدادات

يستخدم Dynmap ملفات إعداد YAML يتم إنشاؤها عند أول تشغيل. تتحكم الإعدادات في الخرائط، وإعدادات render، ومجموعات العلامات، وخلفية التخزين، وسلوك خادم الويب.
تشمل خلفيات التخزين المدعومة الملفات المسطحة وMySQL وSQLite وPostgreSQL وMariaDB، بالإضافة إلى تخزين AWS S3 الاختياري لاستضافة بيانات الخرائط.

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

توفّر مصادر المشروع الرسمية إصدارات خاصة بكل منصة لـ Spigot/Paper وForge وFabric.
قاعدة كود Dynmap منشورة تحت رخصة Apache-2.0.
يدعم المشروع العمل على Java 8 أثناء التشغيل، بينما تختلف متطلبات البناء حسب الهدف وقد تتطلب إصدارات JDK أحدث للبِنى الحديثة.
يوفّر Dynmap واجهات برمجة تطبيقات منشورة (DynmapCoreAPI وdynmap-api) تستخدمها إضافات التكامل؛ وهي الواجهات المستقرة للامتدادات الخارجية.

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

إذا كنت تريد خريطة دائمة وقابلة للتصفح لخادم Minecraft الخاص بك (للتنقل أو تتبع اللاعبين أو خرائط المجتمع)، فإن Dynmap يوفّر حلاً قابلًا للإعداد ومتعدد المنصات مع عدة خلفيات للتخزين ومجموعة غنية من ميزات العرض والعلامات.

خوادم تستخدم dynmap