HyTari Studios · Resmî yapılandırma rehberi

Server Diagnostics

Hedefli düzeltmeler her zaman açık, ağır tanılama yalnızca gerektiğinde.

Server Diagnostics belirli ve doğrulanmış durumları düzeltir, genel bir cleanup sistemi olmaya çalışmaz. Önerilen profil çalışan ve sessizdir: otomatik düzeltmeler ON, derin tanılama OFF.

REHBERİ BAŞLAT MOD SAYFASI

BAŞLAMADAN ÖNCE

Başlangıç

ADIM 01

Kurun ve başlatın

Oluşturulan yapılandırma zaten önerilen profildir.

ADIM 02

Düzeltmeleri açık bırakın

Rotation Fix ve Tracker Cleanup doğrulanmış otomatik modüllerdir.

ADIM 03

Debug'ı yalnızca gerektiğinde açın

EntityTracker Diagnostics bir araştırma aracıdır, gereksinim değildir.

Server Diagnostics dar düzeltmelerle fail-open yaklaşımını izler: belirsiz durumlar genel cleanup yerine Hytale'a bırakılır.

BÖLÜM 01 · 1 ÖRNEKLER

Production profili

Temiz yapılandırma normal kullanım için hazırdır.

01PROPERTIES

Önerilen production profili

Temiz kurulumda doğrulanmış düzeltmeler aktif, ağır araçlar kapalıdır.

PROPERTIES
enabled=true

module.flyingNpcRotationFix.enabled=true
module.flyingNpcRotationFix.debug=false

module.droppedItemTrackerCleanup.enabled=true
module.droppedItemTrackerCleanup.dryRun=false

module.entityTrackerDiagnostics.enabled=false
module.entityTrackerDiagnostics.debug=false

mods/ServerDiagnostics/config.properties

NE YAPAR

Temiz kurulumda doğrulanmış düzeltmeler aktif, ağır araçlar kapalıdır.

ÖNEMLİ DAVRANIŞ

  • dryRun=false doğrulanmış cleanup'ın gerçekten aktif olduğu anlamına gelir.
  • Derin tanılama cleanup için gerekli değildir.
  • Normal profil düşük yük ve az çıktı için tasarlanmıştır.

BÖLÜM 02 · 1 ÖRNEKLER

Flying NPC Rotation Fix

Yapılandırılmış uçan modellerde yalnızca sonlu olmayan NaN/Infinity roll değerlerini düzeltir.

01PROPERTIES

Uçan NPC rotasyon düzeltmesi

Modeller ECS'ye girerken kontrol eder ve yalnızca sonlu olmayan rotasyon değerlerini düzeltir.

PROPERTIES
module.flyingNpcRotationFix.enabled=true
module.flyingNpcRotationFix.debug=false

config.properties

NE YAPAR

Modeller ECS'ye girerken kontrol eder ve yalnızca sonlu olmayan rotasyon değerlerini düzeltir.

ÖNEMLİ DAVRANIŞ

  • AI, pathfinding, hız, spawn kuralları veya geçerli rotasyonları değiştirmez.
  • Varsayılan uygun model öneki NPC/Flying_ olarak kalır.
  • Belirli bir durumu araştırmıyorsanız debug kapalı kalsın.

BÖLÜM 03 · 1 ÖRNEKLER

Dropped Item Tracker Cleanup

Yalnızca kaldırılmış dropped item'larla güvenli şekilde ilişkilendirilebilen zaten geçersiz update'leri kaldırır.

01PROPERTIES

Dropped item için EntityTracker cleanup

Update kuyruğu ile paket gönderimi arasında çalışır; yalnızca geçersiz referans zaten kaldırılmış dropped item ile güvenli ilişkilendirilebildiğinde.

PROPERTIES
module.droppedItemTrackerCleanup.enabled=true
module.droppedItemTrackerCleanup.dryRun=false
module.droppedItemTrackerCleanup.logToFile=true
module.droppedItemTrackerCleanup.summaryIntervalSeconds=300

config.properties

NE YAPAR

Update kuyruğu ile paket gönderimi arasında çalışır; yalnızca geçersiz referans zaten kaldırılmış dropped item ile güvenli ilişkilendirilebildiğinde.

ÖNEMLİ DAVRANIŞ

  • Canlı dropped item'ları, ItemStack'leri, miktarları, pickup/despawn timer'larını veya geçerli update'leri değiştirmez.
  • Beklenmeyen koşullar fail-open'dır; Hytale durumu normal işler.
  • 300 saniyelik özet production spam'ini önler.

BÖLÜM 04 · 1 ÖRNEKLER

Derin tanılama

EntityTracker/ECS araştırmaları için yalnızca gözlem araçları.

01PROPERTIES

Derin tanılamayı geçici açın

EntityTracker/ECS uyarıları araştırılırken gözlem modülü etkinleştirilebilir.

PROPERTIES
module.entityTrackerDiagnostics.enabled=true
module.entityTrackerDiagnostics.debug=true

config.properties

NE YAPAR

EntityTracker/ECS uyarıları araştırılırken gözlem modülü etkinleştirilebilir.

ÖNEMLİ DAVRANIŞ

  • Çok daha fazla yerel telemetri ve daha büyük dosyalar oluşturabilir.
  • ECS arketipleri, bileşenler, lifecycle, viewers ve korelasyonlar hakkında bağlam kaydeder.
  • Araştırma sonrası minimal profile dönün.

BÖLÜM 05 · 1 ÖRNEKLER

Loglar ve saklama

Kategori başına bir kalıcı dosya; başlangıçta ve shutdown'da sıkıştırılır.

01PROPERTIES

Kategori başına saklama

Mod kategori başına bir dosya tutar ve eski kayıtları aynı dosyadan siler.

PROPERTIES
logs.retention.enabled=true
logs.retention.entityTrackerDays=3
logs.retention.entityArchetypesDays=5
logs.retention.dropTrackerCleanupDays=3
logs.retention.flyingNpcRotationDays=5

config.properties

NE YAPAR

Mod kategori başına bir dosya tutar ve eski kayıtları aynı dosyadan siler.

ÖNEMLİ DAVRANIŞ

  • Sıkıştırma başlangıçta ve temiz shutdown'da çalışır.
  • Sadece retention için sonsuz günlük dosyalar oluşturulmaz.
  • Loglar sunucuda yerel kalır ve mod tarafından yüklenmez.

Bir örneği kullanmadan önce

Oyuncu komutu veya izni gerekmez.

Loglar yararlı debug bağlamı içerebilir; paylaşmadan önce inceleyin.

Cleanup sayaçlarının sıfır olması modun çalışmadığı anlamına gelmez; hedef durum gerçekleşmemiş olabilir.

YUKARI DÖN