Minecraft eklentisi dynmap

🔌 Dynmap hakkında

Dynmap, Minecraft sunucuları için gerçek zamanlı ve web tabanlı haritalar sunan bir Minecraft eklenti ve mod ailesidir. Yüklü dünyaların harita döşemelerini render eder ve işaretçiler, alanlar, çizgiler, canlı oyuncu konumları ve sohbet balonları gösterebilen etkileşimli bir harita arayüzü sunar. Dynmap, kendi webserver’ını çalıştırmayı ya da harita verilerini harici barındırma için dışa aktarmayı destekler ve birden fazla storage backend sunar.

🎯 Amaç

Dynmap’in temel amacı, sunucu yöneticilerine ve oyunculara bir tarayıcı üzerinden sunucu arazisinin ve etkinliğinin canlı, gezilebilir bir görünümünü vermektir. Dünya düzenini görselleştirme, oyuncu konumlarını izleme, sunucu haritalarını kullanıcılara yayınlama ve işaretçiler ile bölgeler içeren açıklamalı haritalar oluşturma sorununu çözer.

⚙️ Özellikler

• Sunucu dünyalarının gerçek zamanlı döşeme render’ı (birden fazla harita görünümü ve render modu).
• Oyuncular veya ekip için haritaları açıklamak üzere yapılandırılabilir işaretçiler, alanlar ve çizgiler.
• Canlı oyuncu takibi ve isteğe bağlı sohbet balonları / web-to-game sohbet entegrasyonu.
• Birden fazla storage backend: flat files, MySQL/SQLite/PostgreSQL/MariaDB ve harita/web depolama için AWS S3 desteği.
• Harita arayüzünü sunmak için yerleşik webserver; statik site içeriğini harici depolamaya yayınlamak/yüklemek için uyarlanabilir.
• Çapraz platform derlemeler: Spigot/Paper, Forge ve Fabric için özel çıktılar bulunur.

🧩 Kimin İçin

• Dünyalarının gezilebilir bir haritasını isteyen sunucu sahipleri ve yöneticiler.
• Haritaları oyunculara yayınlayan genel SMP ve survival sunucuları.
• Açıklamalı haritalar, spawn işaretçileri veya bölge kaplamaları gerektiren minigame ya da roleplay sunucuları.
• Büyük haritalar için esnek storage/backing seçeneklerine (SQL veya S3) ihtiyaç duyan hostlar.

🏗️ Örnek Kullanım Alanları

• Oyuncuların çevrimiçi görüntüleyebilmesi için canlı bir Overworld haritası render edip yayınlamak.
• Kasabaları, dükkânları ve dikkat çekici yerleri özel işaretçiler ve alan sınırlarıyla işaretlemek.
• Yeni keşfedilen chunk’lar için zamanlanmış ya da isteğe bağlı render işlemleri çalıştırmak (yarıçap render’ı veya tüm dünya render’ı).

⌨️ Komutlar

(Not: Dynmap, resmi belgelerinde daha geniş bir harita ve yapılandırma komutları kümesi sunar.)

🔐 İzinler

⚙️ Kurulum

📥 Kurulum

• Sunucu platformunuz için resmi Dynmap JAR dosyasını indirin ve sunucunun plugins/ (Forge/Fabric için mods/) dizinine yerleştirin.
• Sunucuyu yeniden başlatın ve Dynmap’in yüklendiğini, yapılandırma ve harita klasörlerini oluşturduğunu konsoldan doğrulayın.
• İlk çalıştırmada oluşturulan Dynmap yapılandırma dosyalarında haritaları, işaretçileri, storage backend’i ve webserver seçeneklerini ayarlayın.

📦 Bağımlılıklar

• Dynmap derlemeleri, birçok Spigot/Paper dağıtımında JDBC sürücü desteği içerir; diğer platformlar SQL backend’leri için ek sürücü veya uyumluluk modları gerektirebilir.
• Entegrasyon eklentileri (ör. WorldGuard, Towny, Citizens) ayrı Dynmap entegrasyonları üzerinden sağlanır; bunlar zorunlu çalışma zamanı bağımlılıkları değildir.

🧾 Yapılandırma

• Dynmap, ilk başlangıçta oluşturulan YAML yapılandırma dosyalarını kullanır. Yapılandırma; haritaları, render ayarlarını, işaretçi kümelerini, storage backend’i ve webserver davranışını kontrol eder.
• Desteklenen storage backend’ler arasında flat files, MySQL, SQLite, PostgreSQL, MariaDB ve harita verilerini barındırmak için isteğe bağlı AWS S3 depolama yer alır.

🧠 Teknik Notlar

• Resmi proje kaynakları, Spigot/Paper, Forge ve Fabric için platforma özel derlemeler sağlar.
• Dynmap’in kod tabanı Apache-2.0 lisansı altında yayımlanır.
• Proje, çalışma zamanında Java 8 üzerinde çalışmayı destekler; derleme gereksinimleri hedefe göre değişir ve modern derlemeler için daha yeni JDK sürümleri gerekebilir.
• Dynmap, entegrasyon eklentileri tarafından kullanılan yayınlanmış API’ler (DynmapCoreAPI ve dynmap-api) sunar; bunlar üçüncü taraf eklentiler için kararlı arayüzlerdir.

🤝 Bu Eklenti Ne Zaman Faydalıdır

Minecraft sunucunuz için kalıcı, gezilebilir bir harita istiyorsanız (navigasyon, oyuncu takibi veya topluluk haritaları için), Dynmap birden fazla storage backend ve zengin render ile işaretçi özellikleri sunan, yapılandırılabilir ve çapraz platform bir çözüm sağlar.