Başar BallıözProduct Engineer
← Tüm yazılar

Kayıt dosyası sürümleme: v1'den v18'e her kaydı açmak

Güncellemeyi yükleyen bir oyuncu, kaydı geçen haftadan da olsa ilk sürümden de olsa, dostunu tam bıraktığı yerde bulmalı. Tibblo'nun kayıt biçimi on sekizinci sürümünde. Bunların herhangi birinden gelen bir kaydın nasıl hâlâ açıldığını anlatıyorum.

Yazan: Başar Ballıöz · · 3 dk okuma

Kayıtlar neden bu kadar özen istiyor?

Bir web uygulamasında doğruyu sunucu tutar; kötü bir yayın geri alınabilir. İnternetsiz bir oyunda doğru, oyuncunun telefonundaki bir dosyadır. Bir güncelleme onu okuyamazsa geri alınacak bir şey yoktur: bir çocuğun aylardır baktığı dost öylece kaybolur. Bu yüzden kayıt dosyası bir veritabanı şeması kadar özen görüyor.

Ayrı işler için ayrı dosyalar

Tibblo, her birinin kendi sahibi olan üç JSON dosyası yazıyor:

  • Dost kaydı: dostlar, ev, altınlar, eşyalar, ilerleme. Sürümler arasında değişen dosya bu.
  • Hesap dosyası: gerçek parayla yapılan satın almalar ve sahip olunan ürünler. Oyuna baştan başlamak ona hiç dokunmuyor; oyuncu parasını verdiği bir şeyi asla kaybetmiyor.
  • Ayarlar: ses, yazı boyutu, dil. Bunlar da ayrı; baştan başlamak onları sıfırlamıyor.

Her kayıt bir version numarası taşıyor. Aşağıdaki her şeyi mümkün kılan o tek alan.

Yazma: yarım kalmış dosya bırakma

Bir telefonun şarjı her an bitebilir ya da sistem uygulamayı kayıt yaparken bile kapatabilir. Yazmalar, her zaman en az bir eksiksiz ve geçerli dosya bulunmasını garanti eden tek bir fonksiyondan geçiyor:

  1. Yeni veriyi save.tmp'ye yaz, kapat, sonra geri oku ve ayrıştır. Başarısız olursa dur; eski kayıt olduğu gibi kalır.
  2. Döndür: mevcut kayıt save.bak olur, geçici dosya kayıt olur.
  3. Son yeniden adlandırma başarısız olursa yedeği geri koy.

Yükleme: kurtar ve kanıtı sakla

Yükleme önce ana dosyayı, sonra yedeği deniyor. Ana dosya var ama okunamıyorsa, hiçbir şey üzerine yazmadan önce save.corrupt-<zaman>.json olarak kopyalanıyor; böylece bozuk bir kayda sonradan bakılabiliyor.

Yükleyici dört sonuçtan birini bildiriyor: yeni oyun, normal yükleme, yedekten kurtarıldı ya da ikisi de okunamadığı için sıfırlandı. Son ikisinde oyuncu sessizce yanlış bir durumla karşılaşmak yerine kısa bir mesaj görüyor.

Dönüşümler: iki dönem

İlk on sekiz sürüm boyunca yükleyici eski kayıtları sürüm kapılarıyla okudu: if version >= 7 ise sağlık ve deneyimi oku, değilse makul varsayılanlar ver. Bu çalışıyor ama her yeni sürüm yükleyiciye bir dal daha ekliyor ve dallar birikiyor.

18. sürümden itibaren yeni sürümler bunun yerine adım fonksiyonlarından geçiyor. Bir tablo her sürümü, N sürümündeki bir kaydı N+1'e çeviren bir fonksiyona eşliyor:

  • Her adım bir derin kopya alıyor ve yeni biçimi döndürüyor. Orijinali asla değiştirmiyor ve asla başarısız olmuyor.
  • Eski bir kayıt, güncel sürüme ulaşana kadar adım adım yükseltiliyor, sonra normal yükleyiciyle okunuyor.
  • Bir adım eksikse kayıt yarım dönüştürülmüş hâlde açılmak yerine olduğu gibi geri dönüyor ve sürümü nedeniyle reddediliyor.

Artık bir sürüm eklemek üç adımlık bir rutin: sürüm numarasını artır, o tek adım fonksiyonunu yaz ve önceki sürümün gerçek bir kaydını test dosyası olarak dondur.

Her dönüşümün uyduğu kurallar

Birkaç kural ilk sürümden beri geçerli:

  • Eksik alanlar varsayılan alır ve hiçbir şey geri alınmaz. Yeni bir alan, eski bir kayıttan asla bir şey eksiltmez.
  • Yeni özellikler oyuncunun gerçek geçmişinden başlar. Türler geldiğinde her eski kayıt adı, ihtiyaçları ve altınları olduğu gibi sahiplenilmiş bir dost olarak açıldı; mevcut oyuncular sahiplenme ekranını hiç görmedi. Sağlık ve deneyim geldiğinde eski dostlar tam sağlık (o sırada hastaysalar daha az) ve zaten gösterdikleri bakıma göre deneyim aldı.
  • Tek dost birden fazla olduğunda eski tek dost ilk yuvaya yerleşti.
  • Yalnızca geçerli veri girer. Bilinmeyen eşya kimlikleri atılır; bir kıyafet ancak oyuncu ona sahipse giyilebilir.

Her sürüm için dondurulmuş bir kayıt

Kayıtlı verisi olan her projeye taşıyacağım kısım bu. On sekiz sürümün her biri için test klasöründe gerçek, dondurulmuş bir kayıt dosyası var. Bir test paketi hepsini açıyor ve üç şeyi kontrol ediyor:

  1. Açılıyor.
  2. O sürümün bildiklerini koruyor: o zaman var olan ad, altınlar, eşyalar ve ilerleme.
  3. Gidiş-dönüşten sağ çıkıyor: tekrar kaydet, tekrar aç, hiçbir şey değişmiyor.

Aynı paket, sürüm numarası test dosyası ya da dönüşüm adımı olmadan artarsa başarısız oluyor. Bir sürüm artışı tek başına yayına çıkamıyor.

Testler gerçek veriye de hiç dokunmuyor: her test çalıştırması kendi ayrı klasörüne yazıyor; paketi bir geliştirme telefonunda ya da bilgisayarda çalıştırmak gerçek ilerlemenin üzerine asla yazamıyor.

Oyun yapmaya başlayan herkese söyleyeceklerim

  1. Yazdığın ilk kayda bir sürüm numarası koy.
  2. Atomik yaz, bir yedek tut, bozuk dosyaları silmek yerine sakla.
  3. Satın almaları, bir sıfırlamanın dokunabileceği her şeyden uzakta, ayrı bir dosyada tut.
  4. Sürüm kontrolleriyle dolu bir yükleyici yerine küçük, adım adım dönüşümleri tercih et.
  5. Her sürüm için gerçek bir kaydı dondur ve her değişiklikte test et.

Bunların hiçbiri oyuncuya görünmüyor; olması gereken de bu. Oyunun nasıl yapıldığını merak ediyorsan: Web geliştiricisi için Godot 4.

Diğer yazılar

iOS'ta Godot: düzensiz 60 fps'ten Metal ile 120 Hz'eAna iş parçacığı karede yalnızca 4 ms çalışan bir Godot 4 oyunu iPhone 14 Pro'da 60 fps civarında takıldı. Telefonda bir ölçüm aracı ve Instruments sebebi nasıl buldu, iOS'u Metal'e geçirmek nasıl 119 fps verdi? Görev temposu: 150 seviyelik bir oyun nerede durgunlaşıyor?Tibblo'nun seviye 1'den 150'ye 763 günlük yolunda hikâye temposunu nasıl ölçtüm, 40. seviyeden sonra nerede durgunlaştığını nasıl buldum ve üç adımlı hikâyeler, günlük sınır ve 'Geçen sefer…' kartıyla nasıl düzelttim.