UEFN Session Launch Timeout Kabusları mı? Unreal Engine Network Drivers Teşhisi

Her teknik oyun geliştiricisi, üç dakika boyunca bir yükleme ekranına bakıp ardından aniden bağlantının kesilmesinin verdiği o kan dondurucu hayal kırıklığını bilir. "Launch Session"a basarsınız, doğrulama ve yükleme aşamalarının bitmesini beklersiniz, assetler derlenirken creative hub'da oturursunuz ve ardından engine sizi acımasızca fatal bir log mesajıyla editöre geri atar.

Karmaşık multiplayer deneyimler inşa ediyorsanız, bir UEFN session launch timeout hatasıyla karşılaşmak neredeyse bir geçiş törenidir. Editör logu genellikle şuna benzer bir çıktı verir:

LogNet: Warning: UNetConnection::Tick: Connection TIMED OUT. Closing connection.. Elapsed: 30.00, Real: 30.00, Good: 30.00, DriverTime: 151.46, Threshold: 30.00, [UNetConnection] RemoteAddr: 18.156.253.228:15009, Name: IpConnection_0, Driver: Name:IpNetDriver_0 Def:BeaconNetDriver IpNetDriver_0, IsServer:

Bu sadece rastgele bir ağ hatası değildir. Unreal Engine'in katı networking eşikleri (thresholds) ile özel assetleri derlemek ve senkronize etmek için gereken ağır, engelleyici (blocking) işlemler arasındaki çok spesifik bir mimari çakışmadır.

Bu teknik incelemede, bu logun tam olarak ne anlama geldiğini, Unreal Engine networking stack'inin neden bu şekilde davrandığını ve ister UEFN kısıtlamaları dahilinde çalışın ister UE5'te özel dedicated servers inşa edin, bu timeoutları önlemek için projelerinizi nasıl mimarileştirebileceğinizi analiz edeceğiz.

UNetConnection Timeout Logunu Çözümlemek

Sorunu çözmek için öncelikle Unreal Engine'in size verdiği telemetriyi anlamanız gerekir. Bu LogNet uyarısındaki değişkenleri inceleyelim:

• Elapsed: 30.00: Bu kritik metriktir. İstemcinin sunucudan en son geçerli bir ağ paketi (veya heartbeat) almasından bu yana tam 30 saniye geçtiği anlamına gelir.
• Threshold: 30.00: Bu, engine'in network driver yapılandırmasındaki ConnectionTimeout değişkeni tarafından tanımlanan hardcoded sınırdır. Elapsed, Threshold değerine ulaştığında bağlantı acımasızca kesilir.
• DriverTime: 151.46: Network driver toplamda yaklaşık 2,5 dakikadır çalışıyor. Bu bize ilk bağlantının başarılı olduğunu ancak sonraki bir blocking işleminin 30 saniyelik sessizliğe neden olduğunu söyler.
• Def:BeaconNetDriver: Bu, "suçüstü" kanıtıdır. Unreal Engine, oynanış için ana IpNetDriver'a geçmeden önce, oyuncu slotu ayırma veya sürüm uyumluluğunu kontrol etme gibi hafif, bağlantı öncesi iletişimleri yönetmek için bir BeaconNetDriver kullanır.

Bir UEFN projesi özel assetleri live edit sunucusuna yüklediğinde, istemci beacon üzerinden bağlanır. Ancak, yerel makineniz veya uzak sunucu optimize edilmemiş shaderları derlemekle veya ağır Verse kodlarını doğrulamakla tamamen meşgul olursa, main thread bloke olur. Thread 30 saniyeden fazla bloke olursa, keep-alive paketleri gönderilmez. Beacon, istemcinin çöktüğünü varsayar ve bağlantıyı düşürür.

Live Edit Sorunu Neden Şiddetlendiriyor?

UEFN Live Edit mimarisi modern oyun motoru tasarımının bir harikasıdır, ancak muazzam kısıtlamalar altında çalışır. Bir oturum başlattığınızda, editör değiştirilen assetlerinizi paketlemeli, bunları Epic tarafından barındırılan bir örneğe (instance) yüklemeli ve ardından yerel Fortnite istemcisine bu örneğe bağlanmasını emretmelidir.

Büyük içe aktarılmış meshler, devasa texture arrayleri veya karmaşık ses dosyalarıyla çalışıyorsanız, "derlenmesi için creative hub'da bekleme" aşaması devasa bir bottleneck haline gelir. Sunucu, istemcinin hub'dan canlı oyun durumuna hızla geçmesini bekler. İstemci yerel olarak 4.000 shader derlemekle meşgul olduğunda, network tick'i beslenemez.

Bu, daha geniş bir engine sorununun yerelleştirilmiş bir versiyonudur. Aslında, ağır bir yüklemeden sonra mekansal senkronizasyonla mücadele ediyorsanız, How To Fix Player Location Desync In Uefn And Unreal Engine Multiplayer hakkındaki kılavuzumuzu incelemek isteyebilirsiniz.

Standart Unreal Engine 5'te Timeout Sorununu Çözme

UEFN, düşük seviyeli engine yapılandırma dosyalarını düzenleme yeteneğinizi soyutlasa da, özel dedicated servers'a geçmeyi planlayan geliştiriciler için bunu standart Unreal Engine 5'te nasıl çözeceğinizi anlamak zorunludur.

Standart bir UE5 projesinde, çökmeye neden olan Threshold değerini doğrudan manipüle edebilirsiniz. Varsayılan olarak Unreal Engine, ölü bağlantıların sunucu belleğini tüketmesini önlemek için network timeoutlarını çok agresif bir şekilde ayarlar.

Bu eşiği artırmak için DefaultEngine.ini dosyanızı değiştirmeniz gerekir. Ağır asset derlemesi sırasında istemcinize daha fazla nefes alma alanı sağlamak için gereken tam yapılandırma şöyledir:

; DefaultEngine.ini

[/Script/OnlineSubsystemUtils.IpNetDriver]
; Standart bağlantı zaman aşımını 120 saniyeye çıkarın
ConnectionTimeout=120.0
; Ağır harita yüklemeleri için ilk bağlantı aşamasına daha fazla süre (150 saniye) tanıyın
InitialConnectTimeout=150.0

[/Script/Engine.NetDriver]
ConnectionTimeout=120.0
InitialConnectTimeout=150.0
KeepAliveTime=0.2
MaxClientRate=100000
MaxInternetClientRate=100000

Timeout süresini 30 saniyeden 120 saniyeye çıkararak, sunucunun bağlantıyı kesmesine izin vermeden istemcinin blocking işlemlerini (shader derleme veya seamless travel asset yükleme gibi) bitirmesine izin verirsiniz.

C++ Aracılığıyla Dinamik Timeout Ayarı

INI dosyanıza 120 saniyelik bir timeout'u hardcode etmek kaba bir araçtır. 2 dakikalık bir timeout, bir oyuncu gerçekten çökerse, sunucunuzun onun actor ve ağ kaynaklarını tam 120 saniye boyunca bellekte tutması, değerli CPU döngülerini ve RAM'i boşa harcaması anlamına gelir. Boşa harcanan sunucu kaynaklarının kâr marjınızı nasıl etkilediğine dair derinlemesine bir inceleme için Architecting Zero Waste Servers The Fortnite Server Optimization Hibernation Proposal Analyzed analizimize göz atın.

Özel UE5 oyunları için çok daha iyi bir yaklaşım, timeout eşiğini yalnızca ağır bir blocking işleminin gerçekleşeceğini bildiğinizde (devasa bir açık dünya haritasına yükleme yapmak gibi) dinamik olarak ayarlamaktır.

İşte UNetConnection'a nasıl erişileceğini ve bir yükleme aşamasında timeout'un geçici olarak nasıl uzatılacağını gösteren bir C++ uygulaması:

#include "Engine/NetConnection.h"
#include "GameFramework/PlayerController.h"

void AMyPlayerController::PrepareForHeavyMapLoad()
{
    // Bu oyuncu için aktif ağ bağlantısını al
    if (UNetConnection* NetConnection = GetNetConnection())
    {
        // Daha sonra geri yüklemek için orijinal zaman aşımı değerini sakla
        float OriginalTimeout = NetConnection->GetTimeoutValue();
        
        // Ağır asset derlemesinden sağ çıkmak için zaman aşımını geçici olarak 180 saniyeye çıkar
        NetConnection->SetTimeoutValue(180.f);
        
        UE_LOG(LogTemp, Warning, TEXT("Adjusted connection timeout from %f to 180s for loading phase."), OriginalTimeout);
        
        // TODO: OriginalTimeout'u geri yüklemek için harita yükleme tamamlanmasına bir delegate bağlayın
    }
    else
    {
        UE_LOG(LogTemp, Error, TEXT("Failed to retrieve UNetConnection. Player may already be disconnected."));
    }
}

Bu kod, sunucunun gerçekten düşmüş bağlantıları hızlı bir şekilde ayıklama yeteneğinden kalıcı olarak ödün vermeden oyuncularınızın yükleme ekranından sağ çıkmasını sağlar.

Oturum Zaman Aşımlarını Önlemek İçin En İyi Uygulamalar

UEFN'e kilitlendiyseniz ve DefaultEngine.ini dosyasını düzenleyemiyorsanız, sorunu timeout süresini uzatarak değil, payload'u optimize ederek çözmelisiniz. İşte UEFN session launch timeout hatasını önlemek için uygulanabilir beş en iyi uygulama:

1. Başlatmadan Önce Kullanılmayan Assetleri Ayıklayın: UEFN, seviyeye aktif olarak yerleştirilmemiş olsalar bile proje dizininde bulunan assetleri doğrulamaya ve yüklemeye çalışacaktır. Launch Session'a basmadan önce kullanılmayan high-poly meshleri ve 4K textureları proje klasörünün dışına taşıyın.
2. Shaderları Önceden Derlemeye Zorlayın: Özel materyaller kullanıyorsanız, oturumu başlatmadan önce bunların yerel olarak tamamen derlendiğinden emin olun. 30 saniyelik timeout'un yaygın bir nedeni, sunucunun bir ağ heartbeat'i beklediği anda yerel istemcinin shaderları derlemek için donmasıdır.
3. Verse Kodu Yürütme Limitlerini Optimize Edin: Verse'deki ağır OnBeginPlay döngüleri sunucu tarafındaki başlatmayı durdurabilir. Devasa başlatma döngülerini Sleep(0.0) kullanarak bölün, böylece yürütmeyi main thread'e geri vererek ağ ticklerinin işlenmesine olanak tanıyın.
4. Collision Karmaşıklığını Azaltın: Karmaşık özel collision meshlerinin backend'de doğrulanması önemli ölçüde daha uzun sürer. Mümkün olan her yerde çarpışma için basit box veya capsule primitivleri kullanın.
5. Yükleme Bant Genişliğinizi İzleyin: İstemciniz değişiklikleri yüklerken DriverTime metriği işlemeye devam eder. Düşük yükleme bant genişliğine sahip (20Mbps altı) bir bağlantıdaysanız, 500MB'lık bir proje güncellemesi göndermek neredeyse kesinlikle bir timeout tetikleyecektir.

Backend Altyapı Faktörü

UEFN'den Unreal Engine'de kendi bağımsız multiplayer oyunlarınızı oluşturmaya geçtiğinizde, bu ağ kurallarını belirleyen backend altyapısını yönetme sorumluluğunu üstlenirsiniz.

Oturum zaman aşımlarını yönetmek, dedicated servers yük dengelemesi (load balancing) ve oyuncu eşleştirmesini (matchmaking) yönetmek, Agones gibi filo yöneticilerini konuşlandırmayı veya Kubernetes'te özel orkestrasyon katmanları yazmayı gerektirir. Bunu kendiniz inşa etmek; database sharding, SSL sertifika yönetimi ve bölgeler arası yönlendirme kurulumu gerektirir; bu da oyun mantığını yazmaya başlamadan önce en az 4 ila 6 haftalık yorucu bir DevOps çalışması demektir.

İşte tam bu noktada horizOn denklemi değiştiriyor. horizOn ile bu karmaşık backend hizmetleri oyun geliştiricileri için özel olarak önceden yapılandırılmış olarak gelir. AWS'de sunucu orkestrasyonu ve bağlantı zaman aşımlarıyla boğuşmak yerine, dedicated servers ölçeklendirmesini otomatik olarak yöneten tam yönetimli bir Backend-as-a-Service elde edersiniz.

Sonuç

Bir UEFN session launch timeout hatasıyla karşılaşmak sinir bozucu bir engeldir, ancak aynı zamanda modern oyun motorlarının ağ durumunu nasıl yönettiğine dair değerli bir derstir. Engine sadece işini yapıyor: sunucu kararlılığını korumak için ölü görünen bağlantıları agresif bir şekilde ayıklıyor.

Sunucu altyapısı hakkında endişelenmeyi bırakıp multiplayer backend'inizi ölçeklendirmeye başlamaya hazır mısınız? horizOn'u ücretsiz deneyin veya bugün üretime hazır oyun sunucularını ne kadar kolay konuşlandırabileceğinizi görmek için API dokümanlarına göz atın.