Dynmap ile Minecraft Sunucusuna Canlı Harita Ekleme

Dynmap kurulumu arıyorsanız işe kötü bir haberle başlamak zorundayız: Dynmap, Minecraft 26.1 ve 26.2’yi desteklemiyor. Eklentinin en güncel sürümü 3.8 ve 14 Ocak 2026’da yayınlandı; desteklediği en yüksek Minecraft sürümü 1.21.11. 2026’nın yeni sürüm hattı için tek bir dosya bile yayınlanmadı. Yani güncel kararlı sürüm olan 26.2 “Chaos Cubed” üzerinde Dynmap’i çalıştıramazsınız.

Bu sayfa iki şeyi birden anlatıyor. Sunucunuz 26.x ise doğrudan alternatifler bölümüne geçin — BlueMap ve squaremap aynı işi yapıyor ve 26.2’yi resmen destekliyor. Sunucunuz 1.21.11 veya daha eski bir sürümdeyse Dynmap hâlâ mükemmel çalışıyor; kurulumu, 8123 portunu, render komutlarını ve disk yönetimini aşağıda adım adım bulacaksınız.

Canlı Harita Nedir, Sunucunuza Ne Katar?#

Canlı harita (live map / web map), Minecraft dünyanızı bir web sayfası üzerinden gösteren sistemdir. Tarayıcıdan adrese girdiğinizde dünyanızın kuşbakışı görüntüsünü, çevrimiçi oyuncuların konumlarını ve işaretlediğiniz noktaları görürsünüz. Oyuna girmeden kimin nerede olduğunu, hangi bölgelerin inşa edildiğini takip edebilirsiniz.

Bunun üç somut faydası var:

• Tanıtım: Haritayı sunucu web sitenize gömerseniz ziyaretçi topluluğun canlı olduğunu anında görür. Sunucunuz için web sitesi kurma sayfasında bunun nasıl yapılacağı anlatılıyor.
• Yönetim: Grief (yapı bozma) şüphesi olan bölgeyi haritadan görür, oraya ışınlanırsınız. Şüpheli yapılar haritada hemen göze çarpar.
• Yön bulma: Oyuncular birbirlerinin üslerini, ortak yolları ve kasabaları harita üzerinden bulur.

Dynmap’in Güncel Durumu: Rakamlarla#

“Belki yeni bir sürüm çıkmıştır” diye düşünmeyin; durum net biçimde ölçülebilir:

Dynmap’in Modrinth’teki resmî projesinde listelenen sürüm aralığı 1.10.2 – 1.21.11 arasında ve en yenisi 1.21.11. 26.x filtresiyle sorgulandığında sonuç boş dönüyor. En yeni dosyalar Dynmap-3.8-forge-1.21.11.jar ve Dynmap-3.8-fabric-1.21.11.jar. GitHub tarafındaki durum daha da geride: webbukkit/dynmap deposunun “latest release” etiketi hâlâ eski bir 3.2.x sürümünde duruyor.

26.2 Kullanıyorsanız: BlueMap ve squaremap#

Sunucunuz 26.1 veya 26.2 ise doğru hamle Dynmap’i beklemek değil, alternatife geçmektir.

BlueMap 5.23 — 3D harita#

BlueMap dünyanızı üç boyutlu olarak render eder; tarayıcıda haritayı döndürebilir, yakınlaşabilir, yapıları hacimli görebilirsiniz. 5.23 sürümü 6 Ağustos 2026’da yayınlandı ve desteklenen sürümler arasında 26.1, 26.1.1, 26.1.2 ve 26.2 var. Fabric, Folia, Forge, NeoForge, Paper, Purpur, Spigot ve Sponge için ayrı yapılar sunuluyor. 5.23’ün yeniliği, web sunucusunun harita karolarını, oyuncu konumlarını ve işaretçileri isteğe bağlı olarak sunucu-gönderimli olay akışıyla güncelleyebilmesi.

squaremap — hafif 2D harita#

squaremap, Dynmap’in ağırlığından rahatsız olanlar için tasarlanmış minimal bir alternatif. 2D kuşbakışı harita üretir, daha az kaynak tüketir ve yapılandırması sadedir. 29 Temmuz 2026 itibarıyla 26.2 desteklidir. “Sadece oyuncu konumlarını ve arazi görüntüsünü göreyim yeter” diyorsanız doğru seçim budur.

1.21.11 ve Öncesi Sunucuda Dynmap Kurulumu#

Sunucunuz eski sürüm hattındaysa kurulum kısa sürer. Eklenti kurmanın genel mantığını bilmiyorsanız önce plugin kurulumu sayfasına bakın.

1. Doğru jar’ı indirin#

   Sunucu yazılımınıza uyan dosyayı seçin: Paper ve Spigot için Bukkit yapısı, modlu sunucular için Dynmap-3.8-forge-1.21.11.jar ya da Dynmap-3.8-fabric-1.21.11.jar. Yanlış platform jar’ı hiç yüklenmez.

2. plugins klasörüne yükleyin#

   Dosyayı sunucunuzun plugins klasörüne atın. Web paneli kullanıyorsanız panel üzerinden plugin yükleme adımlarını izleyin.

3. Sunucuyu yeniden başlatın#

   Konsoldan stop yazıp sunucuyu düzgün kapatın, sonra tekrar başlatın. Dynmap kendi web sunucusunu açtığı için /reload ile yüklemeye çalışmayın.

4. Oluşan klasörü kontrol edin#

   İlk açılıştan sonra plugins/dynmap/ klasörü ve içinde configuration.txt dosyası oluşur. Bu dosyayı düzenleyeceksiniz.

plugins/
  Dynmap-3.8.jar
  dynmap/
    configuration.txt   <-- ana ayar dosyası (config.yml DEĞİL)
    worlds.txt          <-- dünya bazlı harita ayarları
    web/                <-- web arayüzü dosyaları
    tiles/              <-- üretilen harita karoları (disk buraya dolar)

configuration.txt: Port, Bağlama Adresi ve Oturum Sınırı#

Dynmap’in ana ayar dosyası plugins/dynmap/configuration.txt’tir. Adı .txt olsa da içerik YAML biçimindedir: girintiler boşlukla yapılır, sekme (Tab) karakteri dosyayı bozar.

# plugins/dynmap/configuration.txt
webserver-bindaddress: 0.0.0.0
webserver-port: 8123
max-sessions: 30
allow-symlinks: false
tiles-rendered-at-once: 2

webserver-port

Dahili web sunucusunun dinleyeceği port. Varsayılan 8123.

webserver-bindaddress

Hangi ağ arayüzüne bağlanacağı. Varsayılan 0.0.0.0, yani tüm arayüzler. Haritayı yalnızca ters proxy üzerinden yayınlayacaksanız 127.0.0.1 yapabilirsiniz.

max-sessions

Aynı anda izin verilen oturum sayısı. Varsayılan 30. Kalabalık bir sunucuda yükseltmeniz gerekebilir.

allow-symlinks

false olduğunda dahili web sunucusu sembolik bağlantıları izlemez. Belge bu ayarı önerir; güvenlik açısından kapalı bırakın.

tiles-rendered-at-once

Aynı anda üretilecek harita karosu sayısı. Düşük tutmak render sırasındaki CPU yükünü azaltır.

8123 Portunu Açma#

Ayar dosyasını düzenlemek yetmez; haritanın dışarıdan açılabilmesi için 8123 portunun sunucu güvenlik duvarında açık olması gerekir. İşletim sistemine göre komut değişir.

Linux tarafında UFW kullanıyorsanız:

sudo ufw allow 8123/tcp
sudo ufw status

Windows tarafında PowerShell ile gelen kural oluşturmak için:

New-NetFirewallRule -DisplayName "Dynmap 8123" -Direction Inbound -Protocol TCP -LocalPort 8123 -Action Allow

Ayrıntılı anlatım için UFW ile port açma ve Windows Güvenlik Duvarında port açma sayfalarına bakın. Evden sunucu çalıştırıyorsanız ayrıca modeminizde de aynı portu yönlendirmeniz gerekir.

Port açıldıktan sonra haritaya tarayıcıdan http://SUNUCU_IP:8123 adresiyle ulaşırsınız.

Render Komutları: fullrender, radiusrender, pause#

Dynmap kurulduğunda haritanız boştur; harita karolarının üretilmesi (render) gerekir. Bu iş oyun içinden ya da konsoldan komutlarla yönetilir.

/dynmap fullrender world
/dynmap radiusrender 500
/dynmap cancelrender world
/dynmap pause all

• /dynmap fullrender world — world adlı dünyanın tamamını render eder. Büyük dünyalarda saatler sürebilir.
• /dynmap radiusrender 500 — bulunduğunuz noktanın 500 blok yarıçapındaki alanı render eder. Disk ve süre açısından çok daha makul.
• /dynmap cancelrender world — devam eden renderı iptal eder.
• /dynmap pause all — tüm render işlerini duraklatır. Sunucu kalabalıklaştığında ilk basacağınız düğme budur.

Birden fazla dünyanız varsa her birini ayrı ayrı render etmeniz gerekir. Multiverse ile eklediğiniz dünyaların adlarını fullrender komutuna tek tek vermelisiniz.

Disk Kullanımı ve Depolama Arka Uçları#

Dynmap harita karolarını, işaretçileri ve diğer harita verilerini saklamak için ciddi miktarda depolama ister. Resmî belge somut bir GB rakamı vermiyor; pratikte harita alanı büyüdükçe kullanım onlarca GB’a çıkabilir. Bu yüzden tam render başlatmadan önce disk kotanızı kontrol edin.

Dynmap üç depolama arka ucu destekler:

Disk baskısını azaltmanın en pratik yolu render alanını sınırlamaktır. Dünyanız gereğinden büyümüşse önce dünya dosyasını küçültmeyi değerlendirin — kullanılmayan uzak chunk’ları temizlemek hem dünya dosyasını hem harita çıktısını küçültür. Tersine, oyuncuların gideceği alanı önceden hazırlamak istiyorsanız chunk ön üretimi yaparak sınırlı bir alan belirleyip yalnızca onu render edebilirsiniz.

Donanım: Canlı Harita Neyi Zorlar?#

Canlı harita eklentileri iki kaynağı zorlar: render sırasında CPU, sürekli çalışırken disk. Minecraft’ın ana tick döngüsü tek çekirdekte çalıştığı için burada belirleyici olan çekirdek sayısı değil saat hızıdır; render işi arka planda dönerken ana döngünün gecikmemesi yüksek frekanslı bir işlemciye bağlıdır.

Java heap değerlerini pakete göre eşit verin: 8 GB pakette -Xms6G -Xmx6G, 16 GB pakette -Xms14G -Xmx14G. Disk tarafında NVMe SSD şart; harita karoları binlerce küçük dosyadan oluşur ve bu tür bir yükte gecikme doğrudan hissedilir. Batihost’un Minecraft sunucu paketleri NVMe diskli ve yüksek frekanslı Ryzen tabanlı olduğu için render sırasında bile TPS kararlı kalır. Render sırasında belirgin bir düşüş yaşarsanız tiles-rendered-at-once değerini 1’e indirin ve renderı bakım saatlerine kaydırın.

Sık Karşılaşılan Dynmap Sorunları#

Tarayıcıda sayfa hiç açılmıyor#

Önce eklentinin gerçekten yüklendiğini doğrulayın: konsolda plugins yazın ve Dynmap’in yeşil görünüp görünmediğine bakın. Yüklüyse sorun ağ tarafındadır — 8123 portu güvenlik duvarında kapalıdır ya da webserver-bindaddress değeri 127.0.0.1’e çekilmiştir. İkincisi haritayı yalnızca sunucunun kendi içinden erişilebilir yapar.

Harita açılıyor ama tamamen boş / gri#

Bu bir hata değil, beklenen durum. Dynmap kurulur kurulmaz harita üretmez; render komutunu siz vermelisiniz. /dynmap radiusrender 500 ile başlayın ve konsolda ilerleme satırlarının aktığını görün. Render bittiğinde tarayıcı sayfasını yenileyin; tarayıcı önbelleği eski boş karoları tutuyor olabilir.

Oyuncular haritada görünmüyor#

Görünmez modda (vanish) olan ya da spectator modundaki oyuncular haritada gösterilmez. Ayrıca worlds.txt içinde ilgili dünya için oyuncu gösterimi kapatılmış olabilir. Bir de sunucu saatinizi kontrol edin: web arayüzü oyuncu konumlarını periyodik olarak çeker, bağlantı kesintisinde liste donuk kalır.

Render başlıyor ama yarıda duruyor#

Neredeyse her zaman disk doludur. Harita karoları binlerce küçük dosya olarak plugins/dynmap/tiles/ altına yazılır ve kota dolduğunda yazma başarısız olur. Diskte ne kadar yer kaldığını kontrol edin, gerekirse render alanını daraltın veya eski karoları temizleyin.

Konsol “configuration.txt” hatası veriyor#

Dosyaya sekme (Tab) karakteri girmiştir ya da bir satırın girintisi bozulmuştur. Dosya adı .txt olsa da içerik YAML’dır ve biçime duyarlıdır. Değişikliği geri alın, yalnızca iki nokta üst üsteden sonraki değeri düzenleyin. Emin değilseniz dosyayı silin — sunucu yeniden başladığında Dynmap varsayılan dosyayı yeniden oluşturur.

Haritayı Kendi Alan Adınızda Yayınlama#

http://SUNUCU_IP:8123 adresi çalışır ama akılda kalmaz. Haritayı harita.sunucunuz.com gibi bir adreste yayınlamak isterseniz iki şey yapmanız gerekir: alan adınızda bir A kaydı oluşturmak ve önüne bir ters proxy koyup 8123 portunu 80/443 üzerinden sunmak.

A kaydı oluşturma adımları DNS kayıtları rehberinde anlatılıyor. Minecraft sunucusunun kendisine alan adı bağlamak istiyorsanız o iş ayrıdır ve SRV kaydı gerektirir; sunucuya domain bağlama sayfasında bulabilirsiniz. Haritayı HTTPS üzerinden yayınlamak için ayrıca bir SSL sertifikası kurmanız gerekir — tarayıcılar sertifikasız HTTP sayfalarını “güvenli değil” olarak işaretler.

Özetle#

Dynmap kurulumu 2026’da iki ayrı yola çıkıyor. Sunucunuz 1.21.11 veya öncesindeyse Dynmap 3.8 hâlâ sağlam çalışıyor: jar’ı plugins klasörüne atın, plugins/dynmap/configuration.txt dosyasından portu ve oturum sınırını ayarlayın, 8123’ü güvenlik duvarında açın ve /dynmap radiusrender 500 ile küçük bir alandan başlayın.

Sunucunuz 26.1 veya 26.2 ise Dynmap bir seçenek değil. Bunu bir eksiklik olarak görmeyin — BlueMap 5.23 daha modern bir 3D harita sunuyor, squaremap ise daha hafif. İkisi de aktif geliştiriliyor ve 26.2’yi resmen destekliyor. 26.2’ye geçiş sürecinde eklenti yığınınızın tamamını gözden geçirmek için 26.2 sunucu kurulumu ve güncelleme sayfasındaki kontrol listesini kullanın; takıldığınız yerde destek talebi açabilirsiniz.