Debug panel

The Debug panel is a tool that allows you to test the draft: track SDK calls, emulate a poor internet connection, remove the focus from the game, turn off the Yandex loading screen, etc.

Enable Debug Panel

  1. Open the Yandex Games console.
  2. Select the game you need.
  3. In the top left corner, click on Open with debug panel.
  1. Open the required game.

  2. Add &debug-mode=16 to the end of the browser's address bar.

    Example link: https://yandex.com/games/app/XXXX?debug-mode=16, where XXXX is the unique game ID.

The Debug Panel will appear in the bottom left corner of the game page.

Parts of the Debug Panel

Loader

The Loader can have values:

Indicator

Text

Value

W

Awaiting initialization.

IT

Is loader: true

SDK loader initialized correctly.

IF

Is loader: false

Using the old loader. Please load the SDK according to the documentation (item 1.19.1).

Game Ready Indicator

Hover over the indicator to check the SDK status in the game and the moment of calling the method LoadingAPI.ready() (item 1.19.2). It can be purple, green, or red:

Indicator

Text

Value

Blinking purple

SDK is not initialized. Wait for "unit" call.

The game is waiting for SDK initialization.

Blinking purple

The game has initialized the SDK. Waiting for call "ready".

The game has initialized the SDK and is now waiting for the LoadingAPI.ready() method call. The waiting time for Game Ready is 90 seconds.

Turned green

The game called ready after … ms.

The LoadingAPI.ready() method was called after the specified number of milliseconds.

Turned red

"ready" called on timeout.

Game Ready was not called within the 90 seconds of waiting time. In this case, it is considered that Game Ready is not used in the game.

Why do I see the SDK is not defined error, although the Game Ready indicator shows that the SDK is initialized?

It's crucial to initialize the SDK correctly: the /sdk.js script must be added before executing YaGames.init(). The Game Ready indicator only registers whether the SDK is installed in the game and whether the necessary script is connected.

Play Button ▶️

The play button is a game activity indicator. Through the game_api_pause/game_api_resume events, the platform notifies when the game needs to pause or resume the gaming experience.

Press the button to simulate the events' behavior:

  • ▶️ — the game is in focus, and the gameplay is ongoing.
  • ⏸️ — the game is not in focus, the purchase window is open, or an advertisement is being displayed.

Gamepad Button 🎮

The gamepad button 🎮 emulates the use of SDK methods GameplayAPI.start() and GameplayAPI.stop() (item 1.19.3). Press it to toggle between states:

  • Dark background (default) — gameplay is not used in the game.
  • Green background — gameplay is in progress.
  • Red background — gameplay is paused.

Clock Button ⏱️

Click on the clock ⏱️ to toggle the transparency of the Yandex loading screen:

  • Mute Game loader – the transparency will be disabled, and a loading screen with the game's icon at the center will appear at game start.
  • Show Game loader – the transparency will be enabled, making the game's loading icon transparent. You can see what is happening with the game during loading.

SDK mocks ⚒️ Tool Button

Language selection parameter

This feature allows you to change the language that is automatically set for the game.

In the dropdown list with the language designation (for example, En ), select the one you need. The game will open in this language in a new tab.

For more information, see the verification methodology for item 2.14.

This parameter is used to verify compliance with Game requirements item 8.4.1. It is considered fulfilled if a static page opens in verification mode instead of links to other games. For more details, see the verification methodology.

To enable or disable the verification mode:

  1. Select 🔗 Game links mock is disabled or 🔗 Game links mock is enabled accordingly.
  2. Wait for 5 seconds and reload the game.

Eye icon: 👁 Remove the focus from the game / 👀 Return the focus to the game

Press the button to unfocus from the game or return the focus back. This is useful for debugging and testing the game.

Rocket or turtle icon: 🚀 Network throttling is disabled / 🐢 Network throttling is enabled

The rocket and turtle toggle the server response timeout. Press this button to switch between modes:

  • In rocket mode, the server response timeout is standard. The game operates in normal mode.

  • In turtle mode, the client demands an immediate response from the server. If there is no response in a short time, the game assumes that the server did not respond. This mode is used for testing the game to emulate an error. For example, it's used to test the game under poor internet connection conditions, or to simulate a purchase error if the SDK server does not respond in time.

Currency Icon: 🪙 Currency mock is disabled / 🪙 Currency mock is enabled

This setting emulates the in-game currency (name and icon).

To verify that the currency designation in the game is taken from the SDK:

  1. Select Currency mock is enabled.

  2. Wait 5 seconds and reload the game.

  3. Check that the currency designation in the game has changed to the mock one. If the currency:

    • Has changed — the game correctly uses SDK methods for designating the portal currency (complies with item 3.8 of the Game requirements).
    • Has not changed — the game does not use methods for designating the portal currency, and violates item 3.8 of the Game requirements. Moderators will reject such a game. You need to designate the currency name and icon in accordance with the documentation.

To return to the standard currency designations, select Currency mock is disabled and refresh the game page.

Cloud button ☁️

The state of the cloud button ☁️ indicates how the game uses cloud saves through the Yandex Games SDK.

Background

Text

Meaning

Cloud data.

Default state.

Cloud data has been read.

Player data reading detected.

Cloud data has been saved.

Player data saving detected.

Cloud data is not used.

No events occurred within 90 seconds. Cloud saving is not being used.

When the button is clicked, the tab reloads, but the game's static files are taken from a different domain.

Mock currency is a conditional currency for testing that the server returns. Moderators use the text designation TST and the yen icon ¥ as the mock currency.