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:
- 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. - Döndür: mevcut kayıt
save.bakolur, geçici dosya kayıt olur. - 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:
- Açılıyor.
- O sürümün bildiklerini koruyor: o zaman var olan ad, altınlar, eşyalar ve ilerleme.
- 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
- Yazdığın ilk kayda bir sürüm numarası koy.
- Atomik yaz, bir yedek tut, bozuk dosyaları silmek yerine sakla.
- Satın almaları, bir sıfırlamanın dokunabileceği her şeyden uzakta, ayrı bir dosyada tut.
- Sürüm kontrolleriyle dolu bir yükleyici yerine küçük, adım adım dönüşümleri tercih et.
- 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.