LoadBridge.py

"""
Phase 1 shim for LoadBridge.

In the real game, LoadBridge.Load(bridge_name) loads a bridge NIF model and
registers the resulting SetClass under the name "bridge" in g_kSetManager.
In Phase 1 headless mode we just create an empty SetClass so that
g_kSetManager.GetSet("bridge") returns a valid object rather than None.

We also record the most recent bridge_name argument so the host loop can
swap the renderer's bridge model to match the active mission. Stock BC
mission scripts call LoadBridge.Load("SovereignBridge") or
LoadBridge.Load("GalaxyBridge") during StartMission.
"""

# Default mirrors the host loop's eagerly-loaded DBridge.
LAST_REQUESTED: str = "GalaxyBridge"


def Load(bridge_name: str = ""):
    global LAST_REQUESTED
    if bridge_name:
        LAST_REQUESTED = bridge_name
    import App
    existing = App.g_kSetManager.GetSet("bridge")
    if existing:
        return existing
    pSet = App.SetClass_Create()
    App.g_kSetManager.AddSet(pSet, "bridge")
    # Add a placeholder bridge-model object so GetObject("bridge") returns
    # a real ObjectClass with GetAnimNode() rather than None.
    bridge_obj = App.ObjectClass()
    pSet.AddObjectToSet(bridge_obj, "bridge")
    # Match sdk/Build/scripts/LoadBridge.py:183 — every bridge variant
    # registers a baseline ambient so the bridge pass has something to
    # render against. Without this the renderer falls back to its
    # DEFAULT_AMBIENT (typically 0.1) and the interior looks ~black.
    pSet.CreateAmbientLight(1.0, 1.0, 1.0, 1.0, "ambientlight1")
    return pSet


def CreateCharacterMenus(*args, **kwargs):
    """Phase 1 stub — bridge UI menus are not needed for headless logic testing."""
    pass