Bozuk (Corrupted) Minecraft Dünyası Kurtarma

Bozuk Minecraft dünyası kurtarma işi, panikle atılan ilk adımda kazanılır veya kaybedilir. Sunucu açılmıyorsa, konsol bölge dosyası uyarısı basıyorsa ya da oyuncular belli bir koordinata gelince atılıyorsa yapılacak ilk şey dünyayı “onarmaya çalışmak” değildir: sunucuyu düzgün durdurup dünya klasörünün tam kopyasını almaktır. Kurtarma denemelerinin tamamı o kopya üzerinde yürütülür.

İyi haber şu: Minecraft dünyaları bir bütün olarak bozulmaz. Dünya, 32×32 chunk’lık .mca bölge dosyalarına bölünmüştür ve bozulma neredeyse her zaman bunlardan bir veya birkaçında olur. Yani kaybınız genellikle haritanın küçük bir parçasıyla sınırlıdır. Bu sayfada bozulmayı teşhis etmeyi, bozuk bölgeyi bulmayı, MCA Selector ile temizlemeyi, level.dat ve oyuncu verisi sorunlarını çözmeyi ve bir daha yaşamamak için sunucuyu nasıl yapılandıracağınızı adım adım anlatıyorum.

Bozulma Belirtileri ve İlk Müdahale#

Dünya bozulması birkaç farklı yüzle karşınıza çıkar. Hangi belirtiyle karşılaştığınız, hangi dosyanın sorunlu olduğunu doğrudan söyler:

Sunucuyu durdurup yedek almanın doğru sırası şudur. Konsola save-all yazmayın; bozuk dünyada kaydetmeye zorlamak hasarı yayabilir.

1. Sunucuyu düzgün durdurun#

   Konsoldan stop komutunu verin. Süreci öldürmeyin; kill -9 veya Görev Yöneticisi’nden “Görevi sonlandır” bozulmanın en sık sebebidir.

2. Dünya klasörünün tam kopyasını alın#

   Sunucu tamamen kapandıktan sonra arşivleyin. Bu arşive dokunmayın; ileride başvuracağınız tek sağlam nokta budur.

   tar -czf dunya-bozuk-$(date +%F-%H%M).tar.gz world

   Compress-Archive -Path .\world -DestinationPath .\dunya-bozuk-$(Get-Date -Format yyyy-MM-dd-HHmm).zip

3. Log dosyasında ilk hatayı bulun#

   Hangi bölge dosyasının adı geçiyor, onu tespit edin. Ayrıntılı okuma için latest.log okuma rehberine bakabilirsiniz.

   grep -nE "Region file|ChunkHolder|Failed to (load|save) chunk" logs/latest.log | head -30

Konsolda Gördüğünüz Birebir Hata Metinleri#

Paper’ın güncel 26.x kaynak kodundaki bölge dosyası uyarısı şu biçimdedir. Loglarda süslü parantezlerin yerine gerçek dosya adı ve sektör numaraları basılır:

Region file {} has invalid sector at index: {}; sector {} overlaps with header

İnternetteki rehberlerin çoğu hâlâ 1.16 dönemine ait eski metni verir. Eski bir sunucudan gelen logu okuyorsanız şu satırla karşılaşırsınız:

Region file ./world/region/r.-1.0.mca has an invalid sector at index: 428; size has to be > 0

İstemci tarafında, yani tek kişilik dünyayı açmaya çalışan oyuncunun gördüğü metinler ise Minecraft 26.2 dil dosyasında şöyle geçer:

Failed to access world
Unable to load worlds
Unable to read or access folder where game worlds are saved!
Locked by another running instance of Minecraft.

Son satır özellikle önemlidir: “Locked by another running instance” bozulma değil kilit sorunudur. Dünya klasöründeki session.lock dosyasını hâlâ açık tutan bir süreç vardır. Sunucuyu ve oyunu tamamen kapatmak yeterlidir.

26.1 ile Değişen Dünya Klasör Yapısı#

Bu, eski kurtarma tariflerini tek kalemde geçersiz kılan değişikliktir. Minecraft 26.1 ile birlikte boyutlar (dimension) tek bir dünya klasörünün altında ayrı alt klasörlere taşındı:

world/
 |-- level.dat
 |-- level.dat_old
 |-- session.lock
 |-- playerdata/
 |-- data/minecraft/
 |-- dimensions/
 |    |-- minecraft/
 |         |-- overworld/
 |         |    |-- region/      <-- ana dunyanin .mca dosyalari
 |         |    |-- entities/
 |         |    |-- poi/
 |         |    |-- data/
 |         |    |-- paper-world.yml
 |         |-- the_nether/
 |         |    |-- region/
 |         |-- the_end/
 |              |-- region/

Bozuk Bölge Dosyasını Bulma#

Bölge dosyaları r.X.Z.mca biçiminde adlandırılır ve her biri 32×32 = 1024 chunk taşır. Dosya adındaki sayılar chunk koordinatı değil bölge koordinatıdır. Bir oyuncu belirli bir yerde çöküyorsa, oyuncunun F3 ekranından okuduğu blok koordinatını şöyle çevirirsiniz:

chunk_x = blok_x / 16   (asagi yuvarla)
chunk_z = blok_z / 16   (asagi yuvarla)
region_x = chunk_x / 32 (asagi yuvarla)
region_z = chunk_z / 32 (asagi yuvarla)

Ornek: blok (-1200, 640)
  chunk (-75, 40)  ->  region (-3, 1)  ->  dosya adi: r.-3.1.mca

Şüpheli dosyayı boyutuna bakarak da yakalayabilirsiniz. Sağlam bölge dosyaları en az 8 KB’dır; 0 baytlık veya olağandışı küçük dosyalar neredeyse kesin bozuktur:

cd world/dimensions/minecraft/overworld/region
ls -lS | tail -20
find . -name "*.mca" -size -8k

Get-ChildItem .\world\dimensions\minecraft\overworld\region\*.mca |
  Where-Object { $_.Length -lt 8192 } |
  Sort-Object Length

MCA Selector 2.8 ile Bozuk Chunk Temizleme#

MCA Selector, dünya kaydından chunk ve bölge silmeye veya dışa aktarmaya yarayan harici bir masaüstü aracıdır. Güncel sürümü 2.8’dir (15 Haziran 2026) ve sürüm notunda Minecraft 26.2 mapping desteği açıkça belirtilir. Windows kurulumu Java çalışma zamanını kendi içinde getirir, ayrıca Java kurmanız gerekmez.

1. Sunucuyu durdurun ve dünyayı indirin#

   MCA Selector dünya klasörü üzerinde çalışır; sunucu açıkken kullanmayın. Uzak sunucudan dünya klasörünü SFTP ile bilgisayarınıza indirin ya da aracı doğrudan sunucuda çalıştırın.

2. Aracı başlatın#

   Windows’ta kurulum dosyasını çalıştırmanız yeterli. Diğer sistemlerde jar sürümünü kullanın:

   java -jar mcaselector-2.8.jar

3. Dünyayı açın#

   File → Open world yolunu izleyin. 26.1 ve sonrasında boyut klasörünü seçin: ana dünya için world/dimensions/minecraft/overworld, Nether için the_nether, End için the_end.

4. Sorunlu chunk’ı seçin#

   Haritada koordinatlara gidip fareyle chunk’ı işaretleyin. Hangi chunk’ın sorunlu olduğunu bilmiyorsanız Tools → Filter chunks ile filtre kurup toplu seçim yapabilirsiniz.

5. Silin ve kaydedin#

   Selection → Delete selected chunks ile silin. İşlem bittiğinde dünya klasörünü sunucuya geri yükleyin ve sunucuyu başlatın; silinen alan bir sonraki yüklemede yeniden üretilir.

Komut satırında çalışmayı tercih edenler için Minecraft Region Fixer adlı Python aracı da vardır, ancak son etiketli sürümü 2022 tarihlidir ve 26.x bölge formatı desteği doğrulanmamıştır. Denemek isterseniz yalnızca dünya kopyası üzerinde kullanın; birincil tercihiniz MCA Selector olsun.

level.dat Bozulması ve level.dat_old ile Kurtarma#

level.dat dünyanın kimlik kartıdır: seed, spawn noktası, oyun modu, saat, hava ve gamerule değerleri buradadır. Bozulduğunda sunucu dünyayı hiç yükleyemez. Neyse ki Minecraft aynı klasörde bir önceki kaydı level.dat_old adıyla saklar.

# Sunucu KAPALIYKEN
cd world
mv level.dat level.dat.bozuk
cp level.dat_old level.dat

# Sunucu KAPALIYKEN
Rename-Item .\world\level.dat level.dat.bozuk
Copy-Item .\world\level.dat_old .\world\level.dat

Bu işlemden sonra kaybettikleriniz yalnızca son kayıttan bu yana değişen dünya ayarlarıdır: oyun içi saat, hava durumu ve varsa yeni gamerule değişiklikleri. Arazi, yapılar ve oyuncu envanterleri etkilenmez. Sunucu açıldığında gamerule ayarlarınızı ve server.properties değerlerinizi bir kez kontrol edin.

Oyuncu Verisi Bozulması#

Sunucu genel olarak sorunsuz çalışıyor ama belirli bir oyuncu girer girmez atılıyor veya sunucuyu çökertiyorsa suçlu dünya değil, o oyuncunun kayıt dosyasıdır. Dosya şurada durur:

world/playerdata/<uuid>.dat
world/playerdata/<uuid>.dat_old

Önce .dat_old dosyasını deneyin; işe yaramazsa .dat dosyasını silin. Oyuncu envanterini, konumunu ve ilerleme durumunu kaybeder ama sunucuya tekrar girebilir. UUID’yi bilmiyorsanız dosya tarihlerine bakarak en son değişeni bulabilirsiniz:

ls -lt world/playerdata/*.dat | head -5

Yedekten Kısmi Geri Dönme#

Elinizde çalışan bir yedek varsa en iyi yaklaşım tüm dünyayı geri yüklemek değil, yalnızca bozuk parçayı geri koymaktır. Böylece son yedekten bu yana yapılan bütün inşaatları korursunuz.

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

   Canlı dünyanın üzerine açmayın. Örneğin /tmp/yedek gibi geçici bir dizine çıkarın.

   mkdir -p /tmp/yedek && tar -xzf yedek-2026-08-17.tar.gz -C /tmp/yedek

2. Yalnızca bozuk .mca dosyasını kopyalayın#

   Sunucu kapalıyken, aynı adlı dosyayı yedekten alıp canlı dünyaya taşıyın.

   cp /tmp/yedek/world/dimensions/minecraft/overworld/region/r.-3.1.mca \
      world/dimensions/minecraft/overworld/region/r.-3.1.mca

3. entities ve poi klasörlerini de eşleyin#

   Aynı bölgeye ait entities/r.-3.1.mca ve poi/r.-3.1.mca dosyalarını da geri koyun. Yoksa o bölgedeki varlıklar ve köylü iş blokları tutarsız kalır.

4. Sunucuyu başlatın ve logu izleyin#

   Açılışta aynı uyarı tekrarlanmıyorsa sorun çözülmüştür. Kısmi geri dönüşün maliyeti sadece o bölgedeki son değişikliklerdir.

Yedeğiniz yoksa bu sayfa size bir şey daha söylemiş olsun: otomatik yedekleme kurmak yarım saatlik iştir ve bu tür bir olayı sıradan bir bakım işine çevirir. Kurumsal tarafta izlenen yaklaşımı 3-2-1 yedekleme kuralı sayfasında bulabilirsiniz.

Bozulmayı Önleyen Sunucu Ayarları#

Kurtarma her zaman kayıpla biter; asıl kazanç bozulmayı hiç yaşamamaktır. Paper tabanlı sunucularda iki somut ayar riski ciddi biçimde düşürür.

Birincisi sync-chunk-writes. Açık olduğunda chunk yazımları diske güvenilir biçimde flush edilir; küçük bir performans maliyeti karşılığında yarım yazılmış bölge dosyası riskini büyük ölçüde ortadan kaldırır:

# config/paper-global.yml
chunk-system:
  gen-parallelism: default
sync-chunk-writes: true

İkincisi bölge dosyası sıkıştırma biçimi. Minecraft 26.1 ile Paper’ın eski unsupported-settings.compression-format ayarı kaldırıldı ve vanilla tarafındaki region-file-compression içine birleştirildi. Ayar artık gzip değerini de kabul eder:

# server.properties (26.1 ve sonrası)
region-file-compression=deflate
# gecerli degerler: deflate | lz4 | none | gzip

Bunların yanında üç davranış kuralı var. Sunucuyu asla süreç öldürerek kapatmayın; her zaman stop komutunu kullanın. Dünya klasörünü sunucu çalışırken kopyalamayın; yedekleme betiği önce save-off ve save-all çalıştırmalı, kopyadan sonra save-on demelidir. Aynı dünya klasörünü iki sunucu süreciyle birlikte açmayın.

# ASLA:
kill -9 <pid>

# DOGRUSU (screen oturumundaki sunucuya stop gonderme):
screen -S mc -X stuff "stop$(printf '\r')"

Donanımın Bozulmadaki Payı#

Bölge dosyası bozulmalarının sessiz sebebi çoğu zaman disktir. Chunk yazımı küçük ve çok sayıda I/O işlemi üretir; gecikmeli bir diskte sunucu kapanırken kuyruğun boşalması tamamlanmadan süreç sonlanır ve yarım dosya kalır. Bu yüzden Minecraft sunucusu her zaman NVMe SSD üzerinde çalışmalıdır.

Java heap ayarını da diskle birlikte düşünün: 16 GB’lık bir pakette -Xms14G -Xmx14G verip işletim sistemine 2 GB bırakmak, bellek baskısı yüzünden oluşan kayıt gecikmelerini engeller. Bellek yetmediğinde ortaya çıkan OutOfMemoryError kaynaklı ani kapanmalar da bozulmanın bilinen sebeplerindendir. Batihost’un Minecraft sunucu paketleri NVMe SSD ve yüksek frekanslı Ryzen işlemcilerle çalışır; büyük haritalı projeler için yüksek frekanslı VDS tarafına bakabilirsiniz.

Dünya Kurtarılamıyorsa#

Bazen bilanço ağır olur: bölge dosyalarının büyük kısmı okunamıyorsa, yedek yoksa ve level.dat_old da bozuksa kurtarma zorlanır. Bu noktada iki seçenek kalır.

Birincisi kısmi kurtarma: sağlam kalan bölgeleri MCA Selector ile yeni bir dünyaya aktarmak. Aracın Selection → Export selected chunks özelliği tam olarak bunun içindir; ana üssünüzün bulunduğu bölgeyi seçip temiz bir dünyaya taşıyabilirsiniz. Koordinatlar korunur.

İkincisi temiz başlangıç. Haritayı sıfırlarken oyuncu verilerini, yetkileri ve ekonomiyi taşımak isterseniz dünya sıfırlama rehberindeki yordamı izleyin. Yeni dünyada baştan chunk ön üretimi yapmak hem keşif lag’ini bitirir hem de diske yazmayı tek bir kontrollü işleme toplar. Harita çok büyüdüyse dünya küçültme (trim) yöntemleri de işinize yarar.

Özetle#

Bozuk Minecraft dünyası kurtarmanın özü şudur: önce durdur, sonra kopyala, sonra teşhis et. Bozulma neredeyse her zaman birkaç .mca dosyasıyla sınırlıdır; doğru dosyayı bulup yedekten geri koymak veya MCA Selector 2.8 ile silmek çoğu vakayı çözer. level.dat sorunlarında level.dat_old, tek oyuncuyu etkileyen çökmelerde playerdata dosyası devreye girer.

26.1 ve sonrası için tek bir şeyi aklınızda tutun: bölge dosyaları artık world/dimensions/minecraft/overworld/region/ altındadır ve 26.1’e yükselttiğiniz dünya eski sürüme dönmez. Bunun karşılığı düzenli yedek, açık sync-chunk-writes, her zaman /stop ile kapanış ve NVMe SSD üzerinde çalışan bir sunucudur. Takıldığınız bir noktada Minecraft sunucu hataları rehberine göz atabilir, çözülmeyen durumlarda destek talebi açabilirsiniz.