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

Using the developer console

Using the address bar

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

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

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 (section 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() (section 1.19.2). It can be blue, green, or red:

Indicator	Text	Value
Blinking blue	SDK is not initialized. Wait for "unit" call.	The game is waiting for SDK initialization.
Blinking blue	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() (section 1.19.3). Press it to toggle between states:

White 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

The Choose Game Lang Parameter

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

How it works:

Click Choose Game Lang.
In the dropdown menu, select a language.
Reload the game. The selected language will be applied to environment.i18n.lang.

To revert to automatic language detection:

Select the parameter labeled with the language (for example, En ).
In the dropdown list, choose the first row Choose Game Lang.
Reload the game.

Link Icon: 🔗 Game links mock is disabled / 🔗 Game links mock is enabled.

This parameter is used to verify compliance with requirement 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:

Select 🔗 Game links mock is disabled or 🔗 Game links mock is enabled accordingly.
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 of yans):

Currency mock is disabled — the icon and name of the yans are standard.
Currency mock is enabled — the in-game currency should change its name and icon to mock. If:
- if the currency name and icon have changed to yen — the game is correctly using the SDK methods to denote the portal currency (in compliance with requirement section 3.8);
- if the currency name and icon have not changed to yen — the game is not using methods to denote the portal currency, violating requirement section 3.8. Such a game will be rejected by moderators. The currency name and icon must be designated in accordance with the developer documentation.

Was the article helpful?

Launch from local server

Testing FAQs