Skip to main content

Loading screen

Loading screen modes​

When a player enters your game, the Jest platform can display a branded loading overlay while your game initializes. There are three modes:

  • Auto (default) — The platform shows a brief loading animation and automatically dismisses it after a fixed duration. No SDK integration required.
  • Manual — The platform shows the loading overlay immediately, but your game controls the progress and dismissal via the SDK. This is useful for games with variable load times or asset-heavy initialization.
  • Off — No loading overlay is shown.

You can configure the loading screen mode from the Developer Console under your game's settings.

note

Loading screen settings do not apply to onboarding games. Onboarding games never display the platform loading overlay.

Manual mode​

In manual mode, the platform automatically displays the loading overlay when the game loads, with progress starting at 0%. Your game reports progress and dismisses it when ready.

JestSDK.Instance.SetLoadingProgress(progress)​

Reports loading progress to the overlay. The progress parameter is a number from 0 to 100. When progress reaches 100, the overlay is dismissed with a fade-out animation.

jest.SetLoadingProgress(float progress);

Values outside the 0–100 range are clamped automatically.

Example​

var jest = JestSDK.Instance;

// Report progress as assets load
jest.SetLoadingProgress(25);
// ... load more assets ...
jest.SetLoadingProgress(50);
// ... load more assets ...
jest.SetLoadingProgress(75);

// Dismiss the overlay when ready
jest.SetLoadingProgress(100);

Safety timeout​

If the platform does not receive a SetLoadingProgress() call for 15 seconds, it assumes there was an issue loading the game and automatically exits the player back to the home screen. Each progress update resets this timer, so long loads are fine as long as progress is reported regularly.