HyTari Studios · Resmî rehber

Server Inventory Sync

Runtime index'lerine bağlı olmadan sunucular arasında envanter senkronize edin.

Bu temel rehber zaten belgelenmiş davranışı açıklar: paylaşılan envanter, oyuncu profili, anti-dupe locking ve farklı registry'ler arasında semantik ItemQuality koruması.

REHBERİ BAŞLAT MOD SAYFASI

BAŞLAMADAN ÖNCE

Başlangıç

ADIM 01

Katılan sunuculara kurun

Profili paylaşacak node'larda aynı sürümü kullanın.

ADIM 02

Paylaşılan depolamayı bağlayın

Katılan sunucular release'in beklediği aynı data backend'i kullanmalıdır.

ADIM 03

Tam transferi test edin

Ağı açmadan önce envanter, ekipman ve kalite değerlerini doğrulayın.

Bu temel rehber bilerek yapılandırma alan adı uydurmaz: mevcut mod repository'si boştur; tam JSON ayrıntıları source/release-build doğrulandıktan sonra eklenecektir.

BÖLÜM 01 · 1 ÖRNEKLER

Neler senkronize edilir

Envanter, armor, backpack, ek slotlar ve uyumlu profil verileri.

01AKIŞ

Sunucular arasında paylaşılan profil

Mod desteklenen profil öğelerini aynı sisteme katılan sunucular arasında senkron tutar.

AKIŞ
Sunucu A
  ↓ profili kaydet
Paylaşılan veritabanı
  ↓ profili yükle
Sunucu B

Mod davranışı

NE YAPAR

Mod desteklenen profil öğelerini aynı sisteme katılan sunucular arasında senkron tutar.

ÖNEMLİ DAVRANIŞ

  • Amaç hub, survival, dungeon, arena ve diğer sunucular arasında envanter sürekliliğidir.
  • Envanter, armor, backpacks ve desteklenen ek slotlar dahildir.
  • Uyumlu modların profil verileri entegrasyon destekliyorsa senkronize edilebilir.

BÖLÜM 02 · 1 ÖRNEKLER

Senkronizasyon akışı

Yükleme, kaydetme ve transferler korumalı bir döngü izler.

01SIRALAMA

Korumalı yükleme ve kaydetme

Profil eşzamanlı üzerine yazmaları önlemek için oyuncu yaşam döngüsünün kontrollü noktalarında yüklenir ve kaydedilir.

SIRALAMA
JOIN / TRANSFER
→ lock al
→ profili yükle
→ oyun
→ autosave / son kayıt
→ lock bırak

Runtime davranışı

NE YAPAR

Profil eşzamanlı üzerine yazmaları önlemek için oyuncu yaşam döngüsünün kontrollü noktalarında yüklenir ve kaydedilir.

ÖNEMLİ DAVRANIŞ

  • Sistem normal dahili world geçişlerini kesmeyecek şekilde tasarlanmıştır.
  • Autosave olası veri kaybı penceresini azaltır.
  • Loading/lock mesajları profil henüz hazır değilken oyuncuyu bilgilendirebilir.

BÖLÜM 03 · 1 ÖRNEKLER

Locks ve anti-dupe

Profil kritik aşamalarda eşzamanlı erişime karşı korunur.

01KURAL

Eşzamanlı erişim kilidi

Bir profil aynı anda iki sunucu tarafından değiştirilmemelidir.

KURAL
1 oyuncu UUID
→ 1 aktif profil
→ 1 geçerli lock
→ eşzamanlı erişim yok

Dahili güvenlik

NE YAPAR

Bir profil aynı anda iki sunucu tarafından değiştirilmemelidir.

ÖNEMLİ DAVRANIŞ

  • Locking sunucular arası dupe ve race condition'lara karşı korur.
  • Transfer mantığı başka sunucu profili kullanmadan önce save ve handoff'u tamamlamalıdır.
  • Süresi dolmuş locks veya hatalar güvenlik durumu sayılır; iki kopya yükleme gerekçesi değildir.

BÖLÜM 04 · 1 ÖRNEKLER

Güvenli ItemQuality

Kaliteler yalnızca runtime index'leriyle değil semantik olarak tanımlanır.

01ÖRNEK

Semantik ItemQuality koruması

Aynı kalite farklı mod veya registry kullanan sunucularda farklı runtime index'lerine sahip olabilir.

ÖRNEK
Sunucu A: CustomEpic = runtime index 12
Sunucu B: CustomEpic = runtime index 27

Sync yalnızca 12/27 değil kalite kimliğini kullanır.

ItemQuality mapping

NE YAPAR

Aynı kalite farklı mod veya registry kullanan sunucularda farklı runtime index'lerine sahip olabilir.

ÖNEMLİ DAVRANIŞ

  • Hedef orijinal kaliteyi biliyorsa doğru yeniden oluşturulur.
  • Çözülemiyorsa güvenli Common fallback kullanılır ve mümkün olduğunda orijinal kimlik korunur.
  • Kalite tekrar kullanılabilir olduğunda geri yüklenebilir.

BÖLÜM 05 · 1 ÖRNEKLER

Tanılama

İki sunucu aynı kaliteyi farklı çözerse ItemQuality mapping loglanabilir.

01KULLANIM

Mapping tanılaması

Farklı registry'lerde mapping logları ItemQuality adları ve index'lerini karşılaştırmaya yardımcı olur.

KULLANIM
ItemQuality mapping tanılaması
→ yalnızca araştırma için etkinleştir
→ sunucu A / sunucu B karşılaştır
→ test sonrası kapat

İsteğe bağlı tanılama

NE YAPAR

Farklı registry'lerde mapping logları ItemQuality adları ve index'lerini karşılaştırmaya yardımcı olur.

ÖNEMLİ DAVRANIŞ

  • Tanılama registry farklarını anlamaya yarar; normal kullanım için gerekli değildir.
  • Ayrıntılı logging'i gereksiz yere açık bırakmayın.
  • Mod repository'si hizalandığında sayfaya tam yapılandırma alanları eklenecek.

Bir örneği kullanmadan önce

Ana hedef slot kopyalamak değil profil güvenliğidir.

ItemQuality koruması özellikle farklı registry'lere sahip ağlar için tasarlanmıştır.

Mod repository'si hizalandığında açıklayıcı şemalar gerçek yapılandırmayla değiştirilebilir.

YUKARI DÖN