Başlangıç

Güncelleme

Ayarlarını ya da verilerini kaybetmeden daha yeni bir FX Phone sürümüne nasıl geçersin.

#Adımlar

  1. Değişiklik günlüğünü başlangıçtaki sürüm denetleyicisi çıktısında ya da CHANGELOG.md içinde oku.
  2. Veritabanını ve config.lua dosyanı, configs/ klasörünü, config_server.lua dosyasını ve düzenlediğin dil dosyalarını yedekle.
  3. fx-phone klasörünü değiştir. İçeriklerini istiyorsan logs/ ve backups/ klasörlerini, /phonecam ile lens ayarı kaydettiysen camera_lens.json dosyasını sakla.
  4. Değerlerini yeni config dosyalarına geri kopyala. Yeni anahtarların yeni dosyalarda varsayılan değerleri vardır.
  5. Bir dil dosyasını düzenlediysen paketle gelen dosyadaki yeni anahtarları kendi dosyana ekle. Eksik anahtarlar İngilizceye düşer.
  6. Kendi .ogg seslerini ve html/assets/sounds/overrides.json dosyasını sakla.
  7. Sunucuyu başlat.

#Veritabanı değişiklikleri

Config.AutoSchema = true olduğunda yeni tablolar ve sütun değişiklikleri başlangıçta uygulanır ve fx_phone_meta içine kaydedilir; böylece her biri bir kez çalışır. database ready: ... konsol satırı kaç tanesinin çalıştığını söyler.

Config.AutoSchema = false olduğunda sunucuyu başlatmadan önce yeni setup/install.sql dosyasını içe aktar. Bu dosya yeni tabloları oluşturur. Mevcut tablolardaki sütun değişiklikleri yalnızca başlangıçta çalışır; bu yüzden bir güncellemeden sonra bir başlangıç için Config.AutoSchema = true ayarla.

#Tek bir config.lua'dan geliyorsan

Önceki sürümler her ayarı tek bir config.lua içinde tutuyordu. Ayarlar artık configs/ içinde, anahtarın adını taşıyan dosyada duruyor: Config.Wisp, configs/config_wisp.lua içinde; Config.Health, configs/config_health.lua içinde ve böyle devam eder. Değerler değişmedi. Eski dosyandaki her bloğu eşleşen yeni dosyaya kopyala. Hangi dosyanın hangi anahtarı tuttuğu config.lua sayfasındaki tabloda listeleniyor.

#lb-phone katmanı

lb-phone uyumluluk katmanını çalıştırıyorsan her güncellemeden sonra yeni fx-phone/html/compat/lb-components.js dosyasını lb-phone/ui/components.js üzerine kopyala. Bkz. lb-phone uyumluluğu.

#Paketle gelen uygulamalar ve asset'ler

[fx-apps] içindeki uygulama resource'larını ve fx-phone-assets'i telefonla birlikte güncelle. fx-phone-assets içinde script yoktur; değiştirildiği sırada çevrimiçi olan oyuncular yeni modelleri görmek için yeniden bağlanır.

#Sürüm denetimi

Config.VersionCheck = true olduğunda sunucu başlangıçta sürümünün güncel olup olmadığını yazdırır. Denetim GitHub'a ulaşamazsa Version check failed: GitHub could not be reached yazdırır; bu zararsızdır. Susturmak için Config.VersionCheck = false ayarla.

#Import map'i düzenleme

html/index.html içindeki satır içi <script type="importmap"> bloğunu düzenlersen sayfanın Content-Security-Policy'sindeki hash'in yeni metne uyacak şekilde güncellenmesi gerekir, yoksa telefon boş kalır. Hash, etiketlerin arasındaki metnin birebir SHA-256'sının base64 ile kodlanmış hâlidir ve script-src içine 'sha256-<result>' olarak yazılır.

html/index.html?dev=1 sürümün parçası olmayan bir geliştirme aracıdır. Değişiklikleri oyun içinde test et.