Runtime stall can produce repeated on-screen errors

[mayor-modder]

Problem

During first-person use, the game can occasionally stall and then show many repeated errors on screen after exiting the camera mode.

Current evidence

Recent standard logs did not show a clear FirstPersonCamera stack trace for this symptom. The repeated on-screen errors may come from a per-frame update exception, but the source is not yet confirmed.

Initial investigation targets

Potential high-risk areas in this mod include:

• Per-frame camera update and Harmony patches.
• PiP tunnel detection indexing ConnectedEdge[0] after checking buffer existence but not buffer length.
• Follow target resolution returning default position/rotation data even when no valid transform was found.
• UI update paths that run while first-person mode is active.

Likely files:

• Patches/CameraUpdateSystemPatch.cs
• Systems/FirstPersonCameraPIPSystem.cs
• EntityFollower.cs
• Systems/FirstPersonCameraActivatedUISystem.cs

Acceptance criteria

• Add focused, throttled diagnostics around first-person enter/exit, follow target changes, and per-frame follow failures.
• Avoid flooding logs during repeated failures.
• Capture enough context to identify the failing system, followed entity, resolved camera entity, mode, scope, and vehicle type.
• Once root cause is confirmed, split the fix into a separate targeted issue or PR.