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.

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.setLoadingProgress(progress)​

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

JestSDK.setLoadingProgress(progress: number): void;

Values outside the 0–100 range are clamped automatically. Non-integer values are rounded.

Example​

await JestSDK.init();

// Report progress as assets load
JestSDK.setLoadingProgress(25);
// ... load more assets ...
JestSDK.setLoadingProgress(50);
// ... load more assets ...
JestSDK.setLoadingProgress(75);

// Dismiss the overlay when ready
JestSDK.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.