Skip to content
This documentation describes SGC Loading Screen 2.5.0, which is coming to FAB soon. The version on FAB now is 1.0.0.

Troubleshooting

This page maps a symptom to a check and an action. You need a development build for the console and the overlay.

  • Console: SGC.LoadingScreen.Why prints the state of the screen and every hold.
  • The metrics overlay has a Holds: line with the tag, owner and age of every hold.
  • Log category LogSGCLoadingScreen. Set it to Verbose for details.
  • -NoLoadingScreen (non-shipping) turns the screen off. Use it to tell whether the screen causes a problem.

The metrics overlay with the Holds line

Symptom Check Action
The screen does not close Run SGC.LoadingScreen.Why. Look for a hold in the list. Release the hold with Release Loading Screen Hold from the object that set it. A hold older than 30 s also warns in the log.
The screen does not close in a manual mode A development build logs a reminder that the mode waits for Dismiss Loading Screen. Call Dismiss Loading Screen, or set Max Visible Secs.
The screen does not close after 100 % Check Continue On Input. Press a key, click or touch. Or turn the option off.
A hold is not released The log warns about a rejected call and names both objects. Release it from the object that set it. One tag has one owner.
The screen does not show Check Loading Screen Mode and whether the launch has -NoLoadingScreen. In Manual modes it shows only after Push Loading Screen. Pick a fitting mode or call Push Loading Screen.
The screen is not animated in the editor PIE does not draw through MoviePlayer. Check in Standalone, in -game or in a packaged build. See Limitations.
My widget is still during a map load The widget uses a binding, Blueprint OnPaint, a list view or a Retainer Box. Remove them. A compile warning names the cause.
The screen stays long on the first run PSO precompile runs. Set Load Status Max PSO Wait Secs. See Progress and PSO.
Rich Text shows raw tags Use Rich Text is off or the style is unknown. Turn on Use Rich Text and add the style to Rich Text Styles.
Game Feature content does not show The Game Feature was activated after travel. Activate it before travel. Check Enable Game Feature Actions.