✅ Verified in-game — deeper pass: re-confirmed all thin MrxGuiManager forwards + the Events section (plain load-callback wiring, no Event.*); surfaced the MrxGuiPauseLayout asset name; flagged a real bug — DeleteAllHuds calls MrxGuiManager.DeleteAddGuis() which does not exist (the real function is DeleteAllGuis); oPauseModule global-leak still noted; pruned vacuous notes

MrxGuiBootstrap

Module: mrxguibootstrap.lua

Overview

The MrxGuiBootstrap module is responsible for initializing and managing the Scaleform GUI/HUD system in the game. It handles loading GUI files, creating and deleting player HUDs, toggling the visibility of the HUD, and setting up callbacks for GUI events.

Inheritance

Inherits from: none — base/utility module
Imports: MrxGuiBase, MrxGui, MrxGuiManager, MrxUtil, MrxGuiShellBootstrap, MrxGuiInterface

Instance pattern

This is a stateless manager/utility module. It does not track any per-instance state.

Functions

`Init()`

Called during the initialization phase of the game. Loads the pause screen GUI file and sets up a callback for when the pause screen is loaded. Also, sets an exit multiplayer callback function.

`Deinit()`

Not implemented or used in this module.

`_PauseScreenLoaded(PauseScreenModule)`

A private function called when the pause screen GUI file is successfully loaded. It closes the pause screen and stores the pause screen module for later use. Note: it assigns oPauseModule = PauseScreenModule without a local, so this leaks into the global namespace rather than a module-local field — likely intentional (module-level “constant” idiom used elsewhere in this codebase) but worth flagging since it’s easy to shadow accidentally.

`ToggleHud(uGuid, bVisible, sContext)`

Toggles the visibility of the HUD for a given player GUID (uGuid). The bVisible parameter determines whether to show or hide the HUD, and sContext provides additional context for the operation.

`CreatePlayerHud(uPlayerGuid)`

Creates a new GUI for the specified player GUID (uPlayerGuid) using the MrxGuiManager.

`DeleteHud(uPlayerGuid)`

Deletes the GUI associated with the specified player GUID (uPlayerGuid) using the MrxGuiManager.

`DeleteAllHuds()`

Intended to delete all created GUIs via MrxGuiManager.

Real bug: the body calls MrxGuiManager.DeleteAddGuis(), but no such function exists — mrxguimanager.lua defines DeleteAllGuis (all-G-u-i-s), not DeleteAddGuis. Calling DeleteAllHuds() will therefore error with attempt to call field 'DeleteAddGuis' (a nil value). If you need to tear down every player HUD, call MrxGuiManager.DeleteAllGuis() directly instead.

`GetNumberOfPlayersFromShellSelection()`

Returns the number of players selected in the shell (likely referring to the multiplayer selection screen).

`SetSatelliteOverlay(uPlayer, bOn, sFaction)`

Toggles the satellite overlay for a given player (uPlayer). The bOn parameter determines whether to enable or disable the overlay, and sFaction specifies the faction associated with the overlay.

`SetOnGuiLoadedFunc(fFunc, tArgs)`

Sets a callback function (fFunc) that will be called when the GUI is fully loaded. The tArgs table contains any arguments that need to be passed to the callback function.

Events

This file contains no Event.Create calls and no Event.* constants at all — everything here is plain function-callback wiring, not the engine event system:

Init() passes _PauseScreenLoaded as a load-completion callback to MrxGuiBase.LoadGUIFile(...) — invoked directly by that function when the GUI file finishes loading, not through Event.Create.
Init() also passes ExitMultiplayer (defined in mrxguishellbootstrap.lua, not in this file) to MrxGuiShellBootstrap.SetExitMultiplayerCallback(ExitMultiplayer, {}) — again a stored callback reference invoked directly by that module, confirmed via mrxguishellbootstrap.lua’s own ExitMultiplayer/SetExitMultiplayerCallback functions.

Notes for modders

This module is a thin forwarding facade over MrxGuiManager. Every function here (ToggleHud, CreatePlayerHud, DeleteHud, SetSatelliteOverlay, SetOnGuiLoadedFunc) just calls the matching MrxGuiManager function — the real HUD lifecycle logic lives there, so read that page for behavior.
Only concrete asset loaded here: "MrxGuiPauseLayout" (the pause screen), loaded in Init() via MrxGuiBase.LoadGUIFile. Its _PauseScreenLoaded callback immediately closes the pause screen (via MrxGuiPauseScreen.ClosePauseScreen) and stashes the module in the global oPauseModule.
SetOnGuiLoadedFunc(fFunc, tArgs) → MrxGuiManager.SetLoadingCompleteCallback is the hook to run your own code once the player HUD finishes loading — fired immediately if a GUI already exists, else deferred.
Avoid DeleteAllHuds() — it’s broken (see the warning above); call MrxGuiManager.DeleteAllGuis() instead.