BlueMap Rehberi: Minecraft Sunucunuz için 3D Web Haritası

BlueMap nedir

BlueMap dünya dosyalarınızı okur, bunları 3D harita karolarına render eder ve küçük yerleşik bir web sunucusu üzerinden sunar. Yakınlaştırdığınızda blokları tam 3D görürsünüz; uzaklaştırdığınızda düz bir genel görünüm. Canlı işaretçiler oyuncuların nerede olduğunu gösterir ve harita dünya değiştikçe güncellenir.

Yalnızca Java Edition dünyalarını render eder. Güncel sürüm BlueMap 5.29 şu platformlar için sunulur:

Daha eski bir Minecraft sürümü için o sürümü listeleyen daha eski bir BlueMap sürümünü indirin. Modrinth ve Hangar'daki her sürüm, desteklediği Minecraft sürümlerini gösterir.

BlueMap'i kurun

1. Sunucunuza uygun dosyayı Modrinth, Hangar veya BlueMap GitHub sürümlerinden indirin: Paper için -paper jar'ı, Fabric için -fabric ve benzeri.
2. Dosyayı plugins klasörüne (Paper, Spigot) veya mods klasörüne (Fabric, Forge, NeoForge) koyun ve sunucuyu yeniden başlatın. Plugin yükleme, Minecraft pluginleri nasıl kurulur rehberinde anlatılıyor.
3. BlueMap yapılandırmasını plugins/BlueMap/ içinde, modlu sunucularda ise config/bluemap/ içinde oluşturur; her dünyanız için bir harita hazır gelir.

Bu noktada konsol, BlueMap'in beklediğini söyler. İndirmeyi onaylayana kadar hiçbir şey render etmez; bir sonraki adım budur.

core.conf içinde indirmeyi onaylayın

BlueMap blokları çizmek için Minecraft istemcisindeki doku ve modellere ihtiyaç duyar ve bunları Mojang'dan indirir. core.conf dosyasını açın ve şunu değiştirin:

accept-download: true

Bunu ayarlayarak Mojang'ın EULA'sını kabul etmiş ve Minecraft Java Edition'a sahip olduğunuzu onaylamış olursunuz. Dosyayı kaydedin ve /bluemap reload çalıştırın ya da sunucuyu yeniden başlatın. BlueMap kaynakları indirir ve render etmeye başlar.

Web haritasına kendi portunu verin

BlueMap'in web sunucusu varsayılan olarak 8100 portunu dinler. Kendi makinenizde bu portu açın ve http://your-ip:8100 adresini ziyaret edin. Barındırılan sunucularda genellikle portu serbestçe seçemezsiniz, bu yüzden sunucunuza atanmış bir portu kullanırsınız:

1. Sunucunuz için ikinci bir port edinin. HytHost'ta paneldeki Network sekmesini açın ve bir allocation ekleyin: panel boş bir port seçer ve sizin için açar.
2. webserver.conf dosyasını açın ve port değerini bu numaraya ayarlayın:

   port: 25570

3. /bluemap reload çalıştırın ve tarayıcıda http://your-server-ip:25570 adresini açın.

Oyun portunu kullanmayın; o Minecraft'a aittir. Haritayı port numarası olmadan kendi alan adınızda göstermek için önüne nginx gibi bir reverse proxy koyun; BlueMap belgelerinde hazır örnekler var.

BlueMap komutları

Her komutun bluemap.<command> biçiminde bir izni vardır, örneğin bluemap.reload. Çoğu zaman hiçbirine ihtiyacınız olmaz: BlueMap dünyadaki değişiklikleri kendisi fark eder ve render eder.

Render işlemini hafif tutun

BlueMap, sunucunun ana iş parçacığında değil arka plan iş parçacıklarında render eder, ancak render yine de CPU kullanır. Büyük bir dünyanın ilk render işlemi ağır kısımdır; sonrasında yalnızca değişen chunk'lar yeniden çizilir.

• Render iş parçacıkları: core.conf içinde render-thread-count değerini ayarlayın. BlueMap belgeleri dört veya daha az çekirdekli makinelerde 1 önerir.
• Sakin saatlerde render edin: ilk render sürerken yoğun saatlerde /bluemap stop, gece ise /bluemap start çalıştırın.
• Oyuncular çevrimiçiyken duraklatın: plugin.conf içindeki player-render-limit, o sayıda oyuncu çevrimiçi olduğunda render işlemini durdurur.
• Bir dünya sınırı belirleyin. Böylece oyuncular keşfettikçe harita ve render yükü sonsuza kadar büyümez.
• Canlı olması gerekmeyen haritaları dondurun, örneğin keşfedildikten sonra End'i.

Depolama: dosyalar veya veritabanı

BlueMap varsayılan olarak haritayı sunucunuzun depolama alanında, bluemap/web/maps içinde sıkıştırılmış dosyalar olarak saklar. Harita keşfedilen alanla birlikte büyür, bu yüzden büyük bir dünyada disk alanına dikkat edin.

Bunun yerine bir haritayı veritabanına taşıyabilirsiniz. storages/sql.conf içinde MySQL, MariaDB, PostgreSQL veya SQLite bağlantısını ayarlayın, ardından haritanın yapılandırma dosyasında storage: "sql" ayarlayın ve yeniden yükleyin:

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

Paper bir MySQL sürücüsüyle gelir; Spigot, Fabric ve Forge için bir JDBC sürücüsü eklemek gerekir. Her HytHost Minecraft paketi, paneldeki Databases sekmesinden oluşturduğunuz MySQL veritabanlarını içerir.