Minecraft Sunucusunda Yedekten Dünya Geri Yükleme

Minecraft sunucusunda yedekten dünya geri yükleme, doğru sırayla yapıldığında beş dakikalık bir iştir; yanlış sırayla yapıldığında elinizdeki tek sağlam kopyayı da kaybettiren bir işlemdir. Aradaki fark tek bir kuralda toplanıyor: sunucu duracak, sonra dosyalara dokunulacak. Destek taleplerinde en sık gördüğümüz senaryo, panelden yedeği geri yükleyip sunucuyu hiç durdurmayan yöneticinin ertesi gün iki farklı dünyanın karışımıyla uğraşması.

Bu sayfada geri yüklemenin tamamını anlatıyoruz: sunucuyu durdurma zorunluluğu, klasör adı eşleşmesi ve level-name ayarı, Minecraft 26.1 ile değişen world/dimensions yapısı, tüm dünya yerine yalnızca belirli bir bölgeyi (region dosyasını) geri alma yöntemi, oyuncu envanterlerinin neden ayrı tutulduğu ve geri yükleme sonrası kontrol listesi.

Geri Yüklemeden Önce: Sunucuyu Durdurmak Zorunludur#

Minecraft chunk verisini bellekte tutar ve otomatik kayıt aralıklarıyla diske yazar. Sunucu ayaktayken dünya klasöründeki dosyalar hem açık hem de yazılabilir durumdadır. O anda dosyaları yedekle değiştirirseniz sunucu, bellekte tuttuğu eski chunk’ları sizin yeni koyduğunuz dosyaların üzerine yazar. Sonuç, hiçbir zamana ait olmayan melez bir dünyadır.

# Konsolda sirayla:
save-all
save-off
stop

# Surecin gercekten kapandigini dogrulayin:
ps aux | grep "[j]ava"

# systemd servisi kullaniyorsaniz:
sudo systemctl stop minecraft
sudo systemctl status minecraft --no-pager

# Windows'ta sunucu penceresine "stop" yazip Enter'a basin.
# Kapandigini dogrulamak icin:
Get-Process java -ErrorAction SilentlyContinue

Süreci kill -9 ile ya da Görev Yöneticisi’nden sonlandırmayın. Bu, yarım kalmış chunk yazımı bırakır ve zaten sorun yaşadığınız dünyaya yeni bir bozulma ekler. Sunucuyu servis olarak çalıştırıyorsanız geri yükleme boyunca otomatik yeniden başlatmanın kapalı olduğundan emin olun; aksi hâlde siz dosya kopyalarken servis sunucuyu tekrar açar. Otomatik yeniden başlatma kurulumunuzu otomatik yeniden başlatma sayfasından gözden geçirebilirsiniz.

Adım Adım Geri Yükleme#

1. Sunucuyu durdurun ve durduğunu doğrulayın#

   Konsolda stop, ardından süreç kontrolü. Panelde “Stop” değil, gerektiğinde “Kill” de değil; düzgün kapanışı bekleyin.

2. Mevcut dünyayı kenara alın#

   Silmeyin, yeniden adlandırın. Bozuk dünyanın içinden kurtarılabilecek şeyler olabilir.

   mv world world-sorunlu-$(date +%F)

3. Yedeği ayrı bir klasöre açın#

   Doğrudan sunucu köküne açmayın; önce içeriğini görün. Yanlış yapıdaki bir arşiv sunucu klasörünüzü karıştırabilir.

   mkdir -p /tmp/geri-yukleme
   tar -xzf /yedek/mc-yedek-2026-08-20-0300.tar.gz -C /tmp/geri-yukleme
   ls /tmp/geri-yukleme

4. Dünya klasörünü yerine taşıyın#

   Klasör adının level-name ile eşleştiğini kontrol ederek.

   mv /tmp/geri-yukleme/world /opt/minecraft/server/world

5. Dosya sahipliğini düzeltin#

   Linux tarafında en sık atlanan adım. Sunucu farklı bir kullanıcıyla çalışıyorsa dosyaları okuyamaz ve dünya yüklenmez.

   chown -R minecraft:minecraft /opt/minecraft/server/world

6. Sunucuyu konsolu izleyerek başlatın#

   Arka plana atmayın. Yükleme hataları ilk saniyelerde basılır ve orada müdahale etmek çok daha kolaydır.

Klasör Eşleşmesi ve level-name Ayarı#

Geri yükleme sonrası “dünya boş geldi” şikayetlerinin neredeyse tamamının sebebi budur. Sunucu hangi dünyayı yükleyeceğini server.properties dosyasındaki level-name anahtarından öğrenir. O ada sahip bir klasör yoksa hata vermez; aynı adla yepyeni bir dünya üretir ve normal şekilde açılır. Siz de dünyanızın silindiğini sanırsınız, oysa yan klasörde durmaktadır.

# server.properties
level-name=world
level-seed=
level-type=minecraft\:normal

İki seçeneğiniz var: ya geri yüklediğiniz klasörün adını level-name değerine eşitleyin, ya da level-name değerini klasörün adına çevirin. İkincisi daha güvenlidir çünkü mevcut klasöre dokunmazsınız — ama sunucunuzda birden fazla dünya varsa isim karmaşasına dikkat edin. Diğer sunucu ayarlarının ne işe yaradığını server.properties tam liste sayfasında bulabilirsiniz.

26.1 Sonrası world/dimensions Yapısı#

Minecraft 26.1 “Tiny Takeover” ile dünya kayıt yapısı kökten değişti. İnternetteki geri yükleme tariflerinin çoğu hala eski yolları veriyor; yanlış klasöre dosya koyarsanız sunucu onu görmez.

world/
 |-- level.dat
 |-- level.dat_old         <-- level.dat bozulursa bu kullanilir
 |-- session.lock
 |-- playerdata/           <-- oyuncu envanterleri (uuid.dat)
 |-- stats/  advancements/
 |-- data/minecraft/
 |-- dimensions/
      |-- minecraft/
           |-- overworld/  -> region/ entities/ poi/ data/
           |-- the_nether/ -> region/ entities/ poi/
           |-- the_end/    -> region/ entities/ poi/

Bu değişikliğin yan etkisi eski yedekleme betiklerinde ortaya çıkıyor. world_nether ve world_the_end klasörlerini ayrı ayrı arşivleyen bir betiğiniz varsa 26.1 sonrasında o klasörler artık yok; betik hata bile vermeden boş geçiyor olabilir ve yedeğinizde Nether verisi hiç bulunmuyordur. Geri yüklemeye ihtiyaç duyduğunuz gün bunu öğrenmek istemezsiniz. Betiklerinizi bugün kontrol edin; yedekleme rehberi güncel klasör yapısına göre yazılmış örnekler içeriyor.

Sadece Belirli Bir Bölgeyi Geri Alma#

Sorun genelde tüm dünyada değildir. Bir grief olayı, bozuk bir chunk ya da yanlış kullanılmış bir WorldEdit komutu haritanın küçük bir bölümünü etkiler. Böyle durumlarda tüm dünyayı geri almak, o tarihten sonraki bütün oyuncu ilerlemesini de silmek demektir. Daha iyi bir yol var: yalnızca ilgili bölge dosyasını geri koymak.

Minecraft dünyayı .mca uzantılı bölge (region) dosyalarında saklar. Her dosya 32×32 chunk, yani 512×512 blok kapsar. Dosya adı r.X.Z.mca biçimindedir ve buradaki X ile Z, blok koordinatının 512’ye bölünüp aşağı yuvarlanmış hâlidir.

Oyun içinde koordinatları F3 ekranından okuyabilirsiniz; nasıl açıldığını koordinat görme sayfasında anlattık. Koordinatı öğrendikten sonra işlem şu kadar basit:

# 1) Sunucuyu durdurun (stop)

# 2) Yedegi gecici bir klasore acin
mkdir -p /tmp/geri-yukleme
tar -xzf /yedek/mc-yedek-2026-08-20-0300.tar.gz -C /tmp/geri-yukleme

# 3) Mevcut bolge dosyasini kenara alin
cd /opt/minecraft/server/world/dimensions/minecraft/overworld/region
mv r.2.-1.mca r.2.-1.mca.bozuk

# 4) Yedekteki ayni dosyayi kopyalayin
cp /tmp/geri-yukleme/world/dimensions/minecraft/overworld/region/r.2.-1.mca .

# 5) Sahipligi duzeltip sunucuyu baslatin
chown minecraft:minecraft r.2.-1.mca

Aynı yöntemi bir boyutun tamamı için de kullanabilirsiniz. Sadece Nether bozulduysa world/dimensions/minecraft/the_nether/ klasörünü geri alın; Overworld’deki herşey olduğu gibi kalır.

Oyuncu Verileri: playerdata Ayrı Tutulur#

Geri yüklemenin en sevilen özelliği burada. Oyuncuların envanteri, canı, deneyimi, konumu ve doğma noktası harita verisinin içinde değil, world/playerdata/ klasöründe her oyuncu için ayrı bir UUID dosyasında saklanır. Bu ayrım size esneklik verir: haritayı geri alıp envanterleri koruyabilir ya da tam tersini yapabilirsiniz.

# Mevcut envanterleri koruyarak eski haritaya donmek:

# 1) Sunucu kapali. Guncel oyuncu verisini kenara alin
cp -r world/playerdata /tmp/playerdata-guncel

# 2) Dunyayi yedekten geri yukleyin (yukaridaki adimlar)

# 3) Guncel oyuncu verisini geri yazin
cp -r /tmp/playerdata-guncel/. world/playerdata/

# 4) Tek bir oyuncunun dosyasini bulmak icin:
ls -lt world/playerdata/*.dat | head -5

Bir uyarı daha: online-mode ayarı UUID üretimini belirler. Yedeği online-mode=true iken alıp online-mode=false olan bir sunucuya geri yüklerseniz oyuncuların UUID’leri değişir ve playerdata dosyaları hiçbir hesapla eşleşmez. Bu ayarın ne anlama geldiğini online-mode sayfasında ayrıntılı ele aldık.

Eklenti ve Veritabanı Tarafını Unutmayın#

Dünya klasörü tek başına sunucunuzun tamamı değildir. Ekonomi bakiyeleri, yetki grupları, arazi koruma bölgeleri, ev noktaları ve ceza kayıtları plugins/ klasöründeki dosyalarda veya MySQL veritabanında durur. Sadece haritayı geri alırsanız ortaya tutarsız bir durum çıkar: oyuncunun evi vardı, ev noktası hâlâ kayıtlı, ama ev artık haritada yok.

Yetki ve rütbeler

LuckPerms verisi yerel dosyada ya da MySQL’dedir. Dünya ile birlikte geri almayı düşünün.

Ekonomi bakiyeleri

Haritayı geriye alıp bakiyeyi güncel bırakmak ekonomiyi bozabilir; kararı bilerek verin.

Bölge korumaları

WorldGuard bölgeleri koordinat tabanlıdır; harita geri gittiğinde bölgeler yerinde kalır.

Blok kayıtları

CoreProtect veritabanı geri alınmazsa geçmişte yapılan işlemler kayıtlı görünmeye devam eder.

MySQL veritabanı

Ayrı bir dump ile yedeklenir; MySQL bağlama sayfasında yöntem anlatılıyor.

Grief geri alma söz konusuysa çoğu zaman dünyayı geri yüklemeye hiç gerek kalmaz. CoreProtect ile yapılan değişiklikleri oyuncu ve zaman aralığına göre geri sarabilirsiniz; kurulumu ve rollback kullanımını CoreProtect sayfasında bulabilirsiniz. Yedekten dönmek son çaredir, ilk hamle değil.

Geri Yükleme Sonrası Kontrol Listesi#

Sunucu açıldı diye iş bitmiş sayılmaz. Oyunculara kapıyı açmadan önce şunları sırayla kontrol edin:

1. Açılış logunda hata var mı?#

   WARN ve ERROR satırlarını süzün. Bölge dosyası uyarıları burada çıkar.

   grep -E "/(WARN|ERROR|FATAL)\]" logs/latest.log | head -40

2. Doğru dünya mı yüklendi?#

   Kendi hesabınızla girip tanıdık bir yapıya bakın. Spawn’ın etrafı boşsa yanlış klasör yüklenmiş olabilir.

3. Üç boyut da açılıyor mu?#

   Overworld, Nether ve End’e teker teker gidin. Kısmi geri yüklemelerde çoğu zaman yalnızca biri eksik kalır.

4. Sorunlu bölge düzeldi mi?#

   Geri aldığınız koordinata ışınlanıp gözle doğrulayın. Chunk yüklenmiyorsa yanlış region dosyasını kopyalamış olabilirsiniz.

5. Oyuncu verileri yerinde mi?#

   Birkaç oyuncunun envanterini ve konumunu sorun. Boş envanterle giren oyuncu playerdata sorununun ilk işaretidir.

6. Eklentiler ve TPS normal mi?#

   Konsolda plugins komutuyla hepsinin etkin olduğunu görün, birkaç oyuncuyla 15 dakika TPS izleyin.

Özetle#

Yedekten dünya geri yükleme, sırasına uyulduğunda güvenli bir işlemdir. Aklınızda kalması gereken beş şey var: sunucuyu stop ile durdurmadan hiçbir dosyaya dokunmayın; mevcut dünyayı silmeyin, adını değiştirip saklayın; klasör adının server.properties içindeki level-name ile eşleştiğini doğrulayın; Linux tarafında dosya sahipliğini düzeltmeyi unutmayın; ve geri yükleme bitince yeni bir yedek alın.

Çoğu vakada tüm dünyayı geri almanız gerekmediğini de aklınızda tutun. Tek bir r.X.Z.mca dosyasını değiştirmek haritanın geri kalanını ve o tarihten sonraki bütün oyuncu ilerlemesini korur. Oyuncu envanterleri de playerdata klasöründe ayrı durduğu için haritayı geriye alıp envanterleri güncel bırakmak mümkün; bu esneklik doğru kullanıldığında oyuncu kaybını sıfıra indirir.

26.1 ile gelen world/dimensions yapısını atlamayın: eski tarifler yanlış klasör gösteriyor ve yanlış yere konan bir region dosyası hiçbir işe yaramıyor. Dünyanız gerçekten bozulduysa bozuk dünya kurtarma rehberi, yeni bir sezona geçmeye karar verdiyseniz dünya sıfırlama sayfası devreye girer. Yedeğiniz yoksa ya da geri yükleme sırasında takılırsanız destek talebi açıp konsol çıktısını iletin; Batihost Minecraft sunucu paketlerinde otomatik yedekleme zaten hazır gelir.