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
| Piece | Where | Status |
|---|---|---|
| Lobby API: register, heartbeat, remove, list, join | hub/src/lib/api/lobby.ts, migration 0012_maps_and_lobbies.sql | Live in prod |
| Games page on the website | hub/src/app/games/page.tsx | Live |
lobbies:write on launcher device keys | hub/src/lib/api/device.ts DEVICE_SCOPES | Live; keys paired before it lack the scope (403 insufficient_scope) |
| The lobby's connection string | native/lobby mjolnir_lobby_connection | Verified: cv2:..., 106 characters, membership unlocked, max 16 |
| Join by connection string | native/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 game | native/lobby mjolnir_hub_call (WinHTTP) | Verified: GET /lobbies 200 |
| PRIVATE / PUBLIC GAME, FIND GAMES | mods/MJOLNIRLobby/Scripts/games.lua, main.lua, WBP_MJOLNIRFindGames | Built; 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
PlayFabNetDriverwhen 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
DirectPeerConnectivitystrings. The game's setting for it is unread.
- The exe carries
- 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
PFMultiplayerJoinLobbythroughJoinSessionor the Steam invite-accepted path. The exe importsPFLobbyGetConnectionString.
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 /lobbieswith 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
_flagsgiven 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
_flagsthe 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/lobbiesreply) 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 asCONNECTIONSTRING; - the game leaves its fireteam and joins the host's.
How the native half finds it, by pattern rather than address:
OnlineTickby its body bytes; exe RVA0x6a7b580on CU4, the only pointer to it is vtable slot 6 at0xbc86b00;- the handler by scanning the task manager for the
CCallbackwhosem_iCallbackis 337 and whosem_pObjis the manager (+0x380 on CU4,m_Func0x6a7b5d0).
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.
IsRunningDedicatedServeris 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 flags | Signs in | Starts a map |
|---|---|---|
-nullrhi -nosound -unattended | Yes. No GPU driver loads; reaches the frontend in about 2 min | No. StartCountdown never returned. The game thread hung (190 s and counting), with about 9 cores busy. |
-RenderOffScreen -nosound -unattended | Yes | Yes. 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.
-nullrhican'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 localUpdate 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;CreatePlayer, not a network join.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
-nullrhihangs at map start.