Start here

↑ ↓ to move, Enter to openKeyword search
Multiplayer

Server list and hosting

Question
how do players find games and host them, and can a game run on a dedicated server that players connect to?

Rendered from the repository, where it is written as the work happens: it keeps its history, and a status line above says when it describes a design rather than something shipped.

Question: how do players find games and host them, and can a game run on a dedicated server that players connect to?

Short answer:

  • Every game is hosted by a player: the host's game is a listen server, and PlayFab Party carries the traffic.
  • Public games are built: a host switches its lobby to PUBLIC GAME, the game is listed on the hub, and FIND GAMES joins it through the game's own invite flow (below).
  • A true dedicated server is not possible: there is no server binary, and no way to run the Blam sim outside the game client. A headless host (the real game, windowless) works on a GPU machine, but the idea was dropped on 2026-10-02. The findings are kept below.

Status as of 2026-10-02 (CU4); updated 2026-10-21.

What exists

PieceWhereStatus
Lobby API: register, heartbeat, remove, list, joinhub/src/lib/api/lobby.ts, migration 0012_maps_and_lobbies.sqlLive in prod
Games page on the websitehub/src/app/games/page.tsxLive
lobbies:write on launcher device keyshub/src/lib/api/device.ts DEVICE_SCOPESLive; keys paired before it lack the scope (403 insufficient_scope)
The lobby's connection stringnative/lobby mjolnir_lobby_connectionVerified: cv2:..., 106 characters, membership unlocked, max 16
Join by connection stringnative/lobby mjolnir_join (OnlineTick hook)Verified on one PC: the game left its lobby and called PFMultiplayerJoinLobby with our string, then showed its own FAILED TO JOIN for a fake one
Hub calls from the gamenative/lobby mjolnir_hub_call (WinHTTP)Verified: GET /lobbies 200
PRIVATE / PUBLIC GAME, FIND GAMESmods/MJOLNIRLobby/Scripts/games.lua, main.lua, WBP_MJOLNIRFindGamesBuilt; verified on two PCs 2026-10-09 (FIND GAMES download and join, e98d2152; steps in two_pc_test.md, Phase 5)

The listing hides the connection string. A client gets it from /join, which requires sign-in. See the header comment in lobby.ts.

How a game is hosted today

  • The host's game creates a PlayFab lobby (membership) and a PlayFab Party network (traffic), then opens a PlayFabNetDriver when the first remote player arrives (fireteam_join_and_cap.md).
  • Party traffic goes through Microsoft's relays, so hosts need no port forwarding. The game opens only UDP 57716+.
    • The exe carries DirectPeerConnectivity strings. The game's setting for it is unread.
  • The lobby is Private, with no owner migration. When the host leaves, the game ends. That is the main argument for always-on hosts.
  • Joining needs only the lobby's connection string, which reaches PFMultiplayerJoinLobby through JoinSession or the Steam invite-accepted path. The exe imports PFLobbyGetConnectionString.

Public games

Hosting. A host's lobby opens as PUBLIC GAME: MULTIPLAYER lists the game unless the host already picked PUBLIC or PRIVATE this launch (Games.defaultPublic), so a private choice holds through matches and back to the lobby. The button switches between PUBLIC GAME and PRIVATE GAME (host only). FORGE starts private without counting as the host's choice, and the mod check can keep the game private. While public, games.lua:

  • reads the PlayFab lobby's connection string from the native half;
  • POST /lobbies with the map, game type, players, the host's MAX PLAYERS (max_players), its game settings line (settings, host_game_settings.md) and the string;
  • heartbeats every 30 s, and at once after a map, game type or start changes, with players, MAX PLAYERS, game settings, state (open, in_game, full) and the current string (the game makes a new lobby after leaving one);
  • DELETEs the listing when the host goes private or joins another game. A game that quits drops out when its heartbeat goes stale (90 s).

The lobby's footer says why a game isn't listed (no launcher sign-in, an old key, the hub unreachable, no online lobby).

Public or private mid-match (MJOLNIRLobby 0.24.0). The HOST MENU has MAKE PUBLIC / MAKE PRIVATE, and chat has /public and /private (multiplayer_hud.md); FORGE matches stay private. Each change and the listing's outcome reach the host's chat as a system line (MJOLNIRLobby\chat_notice.txt, read by MJOLNIRHud). The native half (post_join_state) posts the lobby's joining state at once rather than at the game's next update:

  • Public: membership unlocked and _flags given the join bits (what a game started public keeps). The PreLogin pass and the joiner injection follow the flag live.
  • Private, in a match: the lock and _flags the game itself last asked for (locked, 1344 after a start), so nobody new can join. Going private in the menu posts nothing: the game posts no update on the way back from a match, so its last ask there is the match's lock, which would keep invited friends out.

A host stays online alone (MJOLNIRLobby 0.24.0). As shipped, a match started with one session member leaves the session to play offline (UBlamOnlineSessionSubsystem::SetSessionRunning, exe 0x7abb940), so a game started private and alone lost its lobby. It couldn't be listed later, and RETURN TO LOBBY (a servertravel) never got one back. Only SAVE AND EXIT or a restart did (2026-11-07). Each start from our lobby now writes native\host_online.txt, and the branch patch public games used applies to any host, public or private. FORGE keeps the shipped branch.

Where a host still ends up with no lobby (FORGE, or a game update that moves the patched branch), RETURN TO LOBBY with nobody else in the match calls BlamCampaignFlowGameSubsystem:EndCampaign, SAVE AND EXIT's own exit. About 3 s after the menu loads, the game asks for a new session itself (traced 2026-11-08 through the hooked public CreateSession: exe 0x7ac2790 to 0x7abee20). That function returns early on state bits a solo start leaves set, and only that exit clears them: a servertravel back, or EndCampaign from the menu, makes no lobby. In the menu with no lobby, the footer says how to get one back.

FIND GAMES (WBP_MJOLNIRFindGames, chunk 984) is a server table of up to 40 public games:

  • Columns: server (name, then host account and country), map ("NOT INSTALLED" when missing), game type (teams or free for all), players (and open slots), ping (signal bars and the estimate), status (LOBBY, IN MATCH, FULL, and a different MJOLNIR Lobby version). Columns are fixed-width boxes in both the header and the rows, so they line up whatever the text.
  • Sorting: a column heading sorts by it; again reverses it. Ping, lowest first, by default. Ties go to fuller games, then nearer ones.
  • Filters: GAME TYPE and MAP cycle through the values listed; HIDE FULL, HIDE IN MATCH and MAPS I HAVE are toggles. The count above the table says how many games the filters hide.
  • Details: hovering a row previews it; clicking chooses it. The panel shows the host, map, game type, a pip per player slot, ping, region (country and Cloudflare colo) and version, with warnings for a missing map or another version.
  • JOIN follows the game the details show, and says why it can't join (GAME FULL, MAP NOT INSTALLED). QUICK JOIN joins the best game the filters allow: map installed, a free slot, then the same version, better signal, more players.
  • The list refreshes every 30 s while the screen is up. The sort, game type filter and toggles are kept in MJOLNIRLobby\find_games.txt.
  • native\lobbies_sample.json (a /lobbies reply) stands in for the hub when present, to try the screen with many games.

An older runtime pack's FIND GAMES (one label per row) still works with this Lobby, unsorted and unfiltered; this runtime pack's widget keeps the names an older Lobby fills.

Joining. JOIN gets the string from /lobbies/{id}/join and writes it to native\join_request.txt. mjolnir_join queues it, and the next FOnlineAsyncTaskManagerSteam::OnlineTick (online thread) calls the task manager's own GameRichPresenceJoinRequested_t handler with it. That handler is what a Steam "Join Game" runs:

  • it builds FOnlineAsyncEventSteamInviteAccepted;
  • a connect string without SteamConnectIP= is stored whole as CONNECTIONSTRING;
  • the game leaves its fireteam and joins the host's.

How the native half finds it, by pattern rather than address:

  • OnlineTick by its body bytes; exe RVA 0x6a7b580 on CU4, the only pointer to it is vtable slot 6 at 0xbc86b00;
  • the handler by scanning the task manager for the CCallback whose m_iCallback is 337 and whose m_pObj is the manager (+0x380 on CU4, m_Func 0x6a7b5d0).

The handler converts the connect string as a C string, so Steam's 256-byte limit doesn't apply. Today's strings are 106 characters anyway.

On the Xbox app there is no Steam subsystem. mjolnir_join hands the string to the GDK session's own invite handler, from the GDK subsystem's tick, the way an Xbox join arrives (mods-v0.23.0 and v0.23.1, PR #179 and #181; game_pass.md). join_request.txt may carry the host's SteamID64 or XUID after the string.

A website's mjolnir://join/<lobby> link reaches the launcher, which leaves the lobby id in native\pending_join.txt; once signed in on the menu, FIND GAMES opens and joins that game as JOIN would (mods-v0.21.0 and launcher-v0.13.0, PR #166).

Auth. Listing needs lobbies:write; /join needs any signed-in key. The native half reads the launcher's key from %APPDATA%\com.devnull9090.mjolnir-launcher\hub_auth.json and sends it to the hub only. Players without the launcher can still host for, and be invited by, friends. An account banned from matchmaking can neither list nor join (403), and a banned host's game drops out of the list (PR #172; player_identity.md).

A game on a map you lack: JOIN reads DOWNLOAD AND JOIN. The map installs in the running game first, then the join runs as usual (live_map_install.md).

Not built: JOIN PRIVATE by short code (an unlisted registration the hub maps to the lobby).

Dedicated servers

A. An Unreal dedicated server: not possible

  • The shipping exe is a game target, not a server target. IsRunningDedicatedServer is not in it.
  • PlayFab's own server product (JoinLobbyAsServer, RequestMultiplayerServer) needs the title's server credentials. Those belong to the publisher.

B. The Blam sim on its own: not practical

HaloSimulation_tag_release.dll could in principle be loaded by our own process. But clients are Unreal clients:

  • they expect an Unreal server speaking UE replication (GameState, PlayerState, the BlamExperience readiness flags, pawns), with the Blam network endpoints carried inside it;
  • all of it runs over PlayFab Party, under a PlayFab identity of the title.

That means reimplementing an Unreal server around the sim. Not worth it.

C. A headless host: works with a GPU (dropped 2026-10-02)

The real game with no window, hosting through the normal menu path, driven by script. Tested 2026-10-02 on PC 1, as a second process launched directly (SteamAppId=2806050):

Launch flagsSigns inStarts a map
-nullrhi -nosound -unattendedYes. No GPU driver loads; reaches the frontend in about 2 minNo. StartCountdown never returned. The game thread hung (190 s and counting), with about 9 cores busy.
-RenderOffScreen -nosound -unattendedYesYes. BGL, Slayer under Megalo, HUD hooks armed, one Spartan spawned

Sign-in without input: call the title screen's own click event, WBP_TitleMenu_C:BndEvt__WBP_TitleMenu_WBP_MeteoriteStandaloneButtonDefault_K2Node_ComponentBoundEvent_1_CommonButtonBaseClicked__DelegateSignature(nil). Then wait for MULTIPLAYER is on the main menu. The account is whatever Steam is signed in as.

Cost at BGL with no players: about 6–7 CPU cores, 55–60% of the GPU's 3D engine, and 8 GB of working set. t.MaxFPS 30 and the low sg.* settings barely changed it. Whether those console variables applied was not checked. -ResX/-ResY may be ignored offscreen.

What a headless host still needs:

  • One Steam account and one game licence per server. PlayFab membership is per account (two instances on one account rejoin as the same member).
  • A Windows machine with a GPU. -nullrhi can't start a map. WARP (software D3D12) is untested.
  • Its own player out of the game. The host is a real player and takes one of the 16 slots. Options: a Megalo variant that parks it (invisible, invulnerable, off the map), plus filtering it out of the scoreboard and kill feed. The sim may also allow it never to spawn. Untested.
  • A host loop. Host on start, register with the hub, rotate maps (the post-game vote already exists), watchdog and restart on a hang, and re-host after a game update.
  • Two hosts can share one PC if each has its own account.

Open questions

  • Can a player join a match in progress? The host's lobby membership is unlocked at the menu; whether the game locks it in a match, and whether a late client gets a seat in the sim, is untested. The local-guest research found the sim roster fixed at launch, but that was a local CreatePlayer, not a network join. Update 2026-10-21: answered 2026-10-03. The match's game mode refuses a login mid-match ("Cannot join - game is already in progress"). For a public game MJOLNIRLobby's native half skips that refusal and the host puts the joiner's players in its running Blam game (mods-v0.12.0, PR #130; native\join_in_progress.txt = 0 turns it off). A private game still refuses. Two-PC test: tools/remote/jip-test.mjs.
  • Does a Private lobby accept a join by connection string from a stranger? Expected yes, per PlayFab's model; not tested with a real host.
  • Headless host (dropped): keeping its player from spawning; WARP for a GPU-less machine; why -nullrhi hangs at map start.