Unreal Engine 5'te Steam Online Subsystem Neden Lobby'ye Katılamıyor?

Unreal Engine 5 projenizi paketliyor, iki farklı Steam hesabını çalıştırıyor, client'ı başlatıyor ve host ettiğiniz lobby'nin session arama sonuçlarında göründüğünü görüyorsunuz. "Join" butonuna basıyor, beş saniye bekliyorsunuz ve... hiçbir şey olmuyor. Ekran donuyor, console log jenerik bir socket uyarısı yazdırıyor ve ana menüye geri atılıyorsunuz.

Eğer Steam Online Subsystem lobby bağlantılarını gerçekleştiremiyorsa, Unreal Engine 5'teki en sinir bozucu network konfigürasyonu sorunlarından biriyle karşı karşıyasınız demektir. Bu, Steam matchmaking API'sinin lobby'nizi doğru şekilde kaydettiği, ancak motorun network driver'ının düşük seviyeli (low-level) connection handshake işlemini tamamlayamadığı sessiz bir hatadır. Bu rehberde, arka plandaki network driver mimarisini inceleyecek, yaygın DefaultEngine.ini uyumsuzluklarını tespit edecek, AppID 480 sandbox kısıtlamalarını çözecek ve Unreal Engine 5'te sorunsuz çalışan bir Steam bağlantı hattını (connection pipeline) nasıl yapılandıracağınızı göstereceğiz.

Epic Games ve Valve Netcode Mimarisini Anlamak

Katılma işleminin neden başarısız olduğunu anlamak için, Unreal Engine'in netcode katmanının bir Steam lobby arama sonucunu nasıl network bağlantısına dönüştürdüğünü anlamanız gerekir. Oyun kodunuzdan JoinSession fonksiyonunu çağırdığınızda, OnlineSubsystemSteam session arayüzü lobby'yi bir connection string'e dönüştürür. Steam için bu connection string, host'un benzersiz Steam ID'sini temsil edecek şekilde steam.STEAM_ID (örneğin steam.76561198000000000) olarak formatlanır.

Unreal Engine'in network driver factory'si (GameNetDriver), bu connection string'i alır ve şema ön ekini (steam.) parse eder. Ardından, Steam bağlantılarını işlemek için yapılandırılmış sınıfı bulmak amacıyla [/Script/Engine.GameEngine] altındaki DefaultEngine.ini konfigürasyonlarınızı kontrol eder. Eğer bu eşleştirme eksikse, uyumsuzsa veya doğru net connection sınıfı yüklenmemişse, motor IpNetDriver sınıfına geri döner (fallback).

IpNetDriver bir Steam ID'yi çözümleyemez. steam.76561198000000000 değerini standart bir DNS hostname'i veya IP adresi olarak ele almaya çalışır, çözümleyemez ve bir network timeout hatası tetikler. Eğer network driver'larınız yanlış yapılandırılmışsa veya connection handshake'leri başarısız oluyorsa, Unreal Engine network driver timeouts sorununu çözmeye çalışan geliştiricilerin karşılaştığı aynı network driver timeout hatalarıyla karşılaşırsınız. NetDriver tanımlarının bağlantı şemasıyla nasıl eşleştiğini anlamak, bu uyumsuzluğu gidermenin ilk adımıdır.

SteamSockets ve SteamNetDriver Çatışması

Unreal Engine 5'te bu hatanın en yaygın nedeni, eski SteamNetDriver ile modern SteamSockets eklentisi (plugin) arasındaki çatışmadır. Geçmişte Unreal Engine, eski SteamNetDriver'ı (Valve'ın eski P2P API'sini temel alan) kullanıyordu. Modern UE5 projeleri ise Valve'ın Steam Networking Sockets API'sini kullanan (DDoS koruması ve yönlendirme optimizasyonu için Steam Datagram Relay yani SDR'ı destekleyen) SteamSockets eklentisini kullanır.

Birçok geliştirici, C++ tarafında projelerinin dependency modüllerine "SteamSockets" modülünü ekler ancak konfigürasyon dosyalarındaki network driver sınıf tanımlarını güncellemeyi unutur. Veya tam tersine, motor Steam Sockets'ı initialize etmeye çalışırken eski driver sınıflarını belirtirler. Şimdi her iki yaklaşım için de doğru yapılandırmaya göz atalım.

Eski SteamNetDriver Yapılandırması

Eğer eski OnlineSubsystemSteam network driver'ını kullanıyorsanız, DefaultEngine.ini dosyanız GameNetDriver'ı eski sınıfa eşlemelidir:

[/Script/Engine.GameEngine]
!NetDriverDefinitions=ClearArray
+NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="OnlineSubsystemSteam.SteamNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")

[/Script/OnlineSubsystemSteam.SteamNetDriver]
NetConnectionClassName="OnlineSubsystemSteam.SteamNetConnection"

Ayrıca DefaultEngine.ini dosyanızdaki [OnlineSubsystemSteam] kategorisi altında bUseSteamNetworking=true olarak ayarlandığından emin olun.

Modern SteamSockets Yapılandırması

Eğer .uproject dosyanızda SteamSockets eklentisini etkinleştirdiyseniz, driver ve connection sınıf adlarını değiştirmelisiniz. Sınıf isimlerindeki ve bölüm başlıklarındaki değişikliğe dikkat edin:

[/Script/Engine.GameEngine]
!NetDriverDefinitions=ClearArray
+NetDriverDefinitions=(DefName="GameNetDriver",DriverClassName="SteamSockets.SteamSocketsNetDriver",DriverClassNameFallback="OnlineSubsystemUtils.IpNetDriver")

[/Script/SteamSockets.SteamSocketsNetDriver]
NetConnectionClassName="SteamSockets.SteamSocketsNetConnection"

Eğer Build.cs dosyanızı SteamSockets içerecek şekilde yapılandırır ancak INI dosyanızda eski OnlineSubsystemSteam.SteamNetDriver yapılandırmalarını kullanırsanız, motor yanlış net connection sınıfını initialize eder. Bu durum, client'ın network handshake işleminin host'un Steam ID'sini çözümlemesini engeller, katılım denemesinin askıda kalmasına (hang) ve time out'a uğramasına neden olur.

Build Dependency'lerini Doğrulama

Projenizin .Build.cs dosyasının seçtiğiniz kuruluma uygun olduğundan emin olun. Örneğin, modern Steam Sockets uygulamasını hedefliyorsanız, ana oyun modülünüzün Build.cs dosyası hem OnlineSubsystemSteam hem de SteamSockets modüllerini açıkça bildirmelidir:

using UnrealBuildTool;

public class MyTPSGame : ModuleRules
{
    public MyTPSGame(ReadOnlyTargetRules Target) : base(Target)
    {
        PCHUsage = PCHUsageMode.UseExplicitOrSharedPCHs;

        PublicDependencyModuleNames.AddRange(new string[] {
            "Core",
            "CoreUObject",
            "Engine",
            "InputCore",
            "EnhancedInput",
            "OnlineSubsystem",
            "OnlineSubsystemUtils",
            "OnlineSubsystemSteam",
            "SteamSockets",
            "UMG",
            "Slate",
            "SlateCore"
        });
    }
}

Steam AppID 480 Sandbox Tuzağı

Eğer yapılandırmalarınız doğruysa ancak hala katılamıyorsanız, muhtemelen Steam Dev AppID 480 sandbox sınırlarının kurbanı oluyorsunuz. Varsayılan olarak geliştiriciler, Valve ile ticari bir uygulama kaydetmeden Steam entegrasyonunu test etmek için AppID 480 (Spacewar) kullanırlar. Ancak AppID 480 dünya çapında binlerce geliştirici tarafından paylaşılmaktadır.

Bu durum iki belirgin soruna yol açar:

1. Lobby Kirliliği (Lobby Pollution): AppID 480 üzerindeki bir session araması, diğer geliştiricilerin oyunları tarafından host edilen lobby'leri de döndürecektir. Client'ınız rastgele bir lobby'ye katılmaya çalıştığında, eşleşmeyen oyun sürümleri veya build ID'leri nedeniyle başarısız olacaktır.
2. Bölgesel İzolasyon (Region Isolation): Steam lobby'leri, ping sürelerini düşük tutmak için varsayılan olarak bölgesel görünürlüğe sahiptir. Eğer farklı lokasyonlardaki bir ekip arkadaşınızla test yapıyorsanız (örneğin biri New York'ta, diğeri Londra'da), arama mesafesi filtrelerinizi (search distance filters) değiştirmediğiniz sürece standart session sorguları birbirini bulamayacak veya bağlanamayacaktır.

Bu kısıtlamaları aşmak için, C++ tarafındaki session arama ayarlarınızı dünya çapında bir mesafe filtresi (worldwide distance filter) ve özel sorgu parametreleri kullanacak şekilde açıkça yapılandırmalısınız.

İlgisiz AppID 480 trafiğini filtrelerken küresel Steam lobby'lerini hedeflemek için özel bir C++ session arama sorgusunun nasıl yazılacağı aşağıda gösterilmiştir:

#include "OnlineSubsystem.h"
#include "Interfaces/OnlineSessionInterface.h"
#include "OnlineSessionSettings.h"

void UMultiplayerSessionSubsystem::FindSteamLobbies(int32 MaxResults)
{
    IOnlineSubsystem* Subsystem = IOnlineSubsystem::Get();
    if (!Subsystem)
    {
        UE_LOG(LogTemp, Warning, TEXT("Failed to get OnlineSubsystem."));
        return;
    }

    IOnlineSessionPtr SessionInterface = Subsystem->GetSessionInterface();
    if (!SessionInterface.IsValid())
    {
        UE_LOG(LogTemp, Warning, TEXT("Session interface is invalid."));
        return;
    }

    // Allocate a new session search configuration
    SessionSearch = MakeShareable(new FOnlineSessionSearch());
    SessionSearch->MaxSearchResults = MaxResults;
    SessionSearch->bIsLanQuery = false;

    // Use presence to ensure we look for Steam lobbies rather than dedicated servers
    SessionSearch->QuerySettings.Set(SEARCH_PRESENCE, true, EOnlineComparisonOp::Equals);
    SessionSearch->QuerySettings.Set(SEARCH_LOBBIES, true, EOnlineComparisonOp::Equals);

    // CRITICAL: Set Steam Lobby Search Distance Filter
    // 0 = Close, 1 = Default, 2 = Far, 3 = Worldwide
    // Worldwide is necessary if testing across different regions on AppID 480
    SessionSearch->QuerySettings.Set(SEARCH_LOBBY_SEARCH_DISTANCE_FILTER, 3, EOnlineComparisonOp::Equals);

    // Apply a unique game identifier key to filter out other developers' Spacewar lobbies
    // Replace "MY_UNIQUE_GAME_ID_KEY" with a unique string specific to your prototype
    SessionSearch->QuerySettings.Set(TEXT("GAME_VERSION_KEY"), FString("MyTPSGame_v1.0.4"), EOnlineComparisonOp::Equals);

    // Bind callback to handle search completion
    OnFindSessionsCompleteDelegateHandle = SessionInterface->AddOnFindSessionsCompleteDelegate_Handle(
        OnFindSessionsCompleteDelegate,
        FOnFindSessionsCompleteDelegate::CreateUObject(this, &ThisClass::OnFindSessionsComplete)
    );

    ULocalPlayer* LocalPlayer = GetWorld()->GetFirstLocalPlayerFromController();
    if (LocalPlayer)
    {
        SessionInterface->FindSessions(*LocalPlayer->GetPreferredUniqueNetId(), SessionSearch.ToSharedRef());
    }
}

Hosting client üzerinde session oluştururken, FOnlineSessionSettings::Settings map'ine aynı özel anahtarı (GAME_VERSION_KEY ve değeri MyTPSGame_v1.0.4 olacak şekilde) eklediğinizden emin olun. Bu, arama sorgunuzun yalnızca oyununuzun lobby'lerini döndürmesini sağlayarak AppID 480 kirliliğini tamamen ortadan kaldırır. İlk lobby bağlantısını geçtikten sonra, RPC'lerinizin katılımın hemen ardından oynanış durumlarınızı (gameplay states) bozabilecek Unreal Engine RPC replication desyncs sorunlarına yol açmadan kararlı bir şekilde replike olmasını da sağlamalısınız.

Port Eşlemeleri (Port Bindings) ve Tek Makinede Test Çatışmaları

Eğer iki Steam hesabı kullanarak tek bir bilgisayarda yerel olarak multiplayer testi yapıyorsanız (örneğin Sandboxie kullanarak veya komut satırı parametresiyle başlatılan ikinci bir derlenmiş instance ile), muhtemelen port çakışması (port binding conflicts) yaşarsınız. Host ederken, Unreal Engine'in Steam Subsystem'i yerel bir game server kaydetmeye çalışır. DefaultEngine.ini içerisindeki bInitServerOnClient=true ayarı, client'a Steamworks'ün game server API'sini initialize etmesini söyler.

Aynı makinedeki iki instance da varsayılan Steam Query Port (27015) ve Game Port'una (7777) bağlanmaya (bind) çalışırsa, ikinci instance socket'lerini açamaz. Sonuç olarak, ikinci client lobby'yi arayıp bulacaktır ancak gelen bağlantı socket'ini (incoming connection socket) initialize edemeyecektir.

Bunu düzeltmek için:

1. İkinci Instance İçin Portu Değiştirin: Terminalden veya bir batch script'ten ikinci oyun instance'ını başlatırken, komut satırı parametrelerine -port=7778 ekleyerek onu farklı bir porta bağlanmaya zorlayın.
2. Sorgu Portu Offset'lerini Düzeltin: [OnlineSubsystemSteam] altında, query ve game port yapılandırmanızı doğrulayın:

   [OnlineSubsystemSteam]
   bEnabled=true
   SteamDevAppId=480
   bInitServerOnClient=true
   bUseSteamNetworking=true
   GameServerQueryPort=27015
   

   Eğer aynı yerel ağda test yapıyorsanız, yönlendiricinizin (router) güvenlik duvarının bu portlardaki UDP trafiğini engellemediğinden emin olun.

Modern Bir Game Backend ile Matchmaking Sıkıntılarını Ortadan Kaldırmak

Steam'in ini yapılandırmalarıyla, mesafe filtreleriyle (distance filters) ve AppID kısıtlamalarıyla manuel olarak boğuşmak indie ekipler için büyük bir zaman kaybıdır. Bölgesel geri dönüşler (regional fallbacks), matchmaking kuralları ve güvenilir network driver handshake'leri içeren canlıya hazır (production-ready) bir lobby sistemi kurmak, kolayca 4 ila 6 haftalık özel backend mühendisliği gerektirebilir.

İşte bu noktada özel bir game backend devreye giriyor. horizOn oyun geliştiricileri için özel olarak tasarlanmış bir Backend-as-a-Service (BaaS) çözümüdür. horizOn, sizi Steam'e özel socket kütüphanelerinde hata ayıklamaya veya karmaşık C++ wrapper modülleri yazmaya zorlamak yerine; lobby'leri, matchmaking işlemlerini ve oyuncu session'larını yönetmek için birleşik bir SDK sunar.

Matchmaking mantığınızı horizOn platformuna taşıyarak motor dosyalarınızdaki network driver eşlemeleri konusunda endişelenmenize gerek kalmaz. Oyuncu session'ları, dünya genelinde dağıtılmış sunucu altyapısı kullanılarak yönetilir; böylece kutudan çıktığı haliyle anında matchmaking ve DDoS korumalı relay'ler sunulur.

Unreal Engine Steam Multiplayer İçin En İyi Pratikler

Prototip testlerinin ötesine geçen güvenilir bir multiplayer pipeline inşa etmek için aşağıdaki en iyi pratikleri takip edin:

1. Steam Sockets'a Erken Geçiş Yapın: Eski P2P networking driver yapılandırmalarından kaçının. Steam Datagram Relay (SDR) yönlendirmesinden faydalanmak ve NAT punch-through hatalarını önlemek için modern SteamSockets net driver'ına bağlanın.
2. Özel Filtreleme Anahtarları (Custom Filtering Keys) Uygulayın: AppID 480 üzerinde test yaparken, session ayarlarınıza projeye özgü son derece spesifik bir tanımlayıcı (identifier) ekleyin. Bu, client'ınızın sandbox'ı paylaşan diğer oyunlara bağlanmaya çalışmasını önler.
3. NULL Subsystem Fallback'ini Düzgün Yönetin: Steam çalışmadığında netcode'unuzun NULL subsystem'e geri dönebildiğinden (fallback) emin olun. Bu, bağlantı mantığını (connection logic) bozmadan çevrimdışı LAN testleri yapılmasına olanak tanır.
4. Session Join Timeout Sürelerini Optimize Edin: [ActiveNetDriver] altındaki ConnectionTimeout değerini en az 15.0 saniye olarak ayarlayın. Steam'in P2P handshake işlemi, özellikle küresel SDR relay'leri üzerinden yönlendiriliyorsa tamamlanması birkaç saniye sürebilir.

Sonuç

Unreal Engine 5'teki Steam lobby bağlantı hatalarını düzeltmek, tamamen motor yapılandırmalarınızı birlikte build ettiğiniz network plugin'leri ile uyumlu hale getirmekle ilgilidir. NetDriverDefinitions alanlarınızı doğru şekilde eşleyerek ve Spacewar arama filtrelerini override ederek playtest'leriniz için kararlı bağlantılar kurabilirsiniz.

Eğer backend altyapısı sıkıntılarını atlayıp tamamen oynanışa odaklanmak istiyorsanız, projenizi özel bir backend ile entegre etmeyi düşünebilirsiniz. Multiplayer backend'inizi ölçeklendirmeye hazır mısınız? horizOn'u ücretsiz deneyin veya API dokümantasyonuna göz atın.

---

Kaynak: Steam Online Subsystem can't join lobby