Web games distribution

How it works

You can launch and distribute web games via Xsolla Launcher. Games are opened in a separate window, and user data is passed by Xsolla Login in a JWT.

How to get it

1. Set up a launcher.
2. Set up the transfer of user data.
3. Set up selling in-game virtual items and virtual currency (optional).

Set up Launcher

Creation of a new launcher with a web game

1. Create a project in Publisher Account.
2. Create a launcher with the Web type.
3. In the Games section, click Set up to the right of your game.
4. Go to Builds > Game builds.
5. In the Adding web game build section:
   1. Specify the Game URL.
   2. Select whether the game should be launched in a maximized window.
   3. Specify the Default game window resolution.
6. Click Save changes.
7. Generate an installer for the launcher.
8. Test the launcher.
9. Publish the launcher.
10. Send the launcher’s installer to your users.

Adding a web game to a launcher

To add a web game to a launcher that has already been created, refer to these instructions.
To upload a web game build to the launcher:

1. Open your project in Publisher Account.
2. Click Launcher in the side menu.
3. Find the launcher on the dashboard and click Edit launcher.
4. In the Games section, click Set up to the right of your game.
5. Go to Builds > Game builds.
6. In the Adding web game build section:
   1. Specify the Game URL.
   2. Select whether the game should be launched in a maximized window.
   3. Specify the Default game window resolution.
7. Click Save changes.

Changing the type of the game from desktop to web

1. Open your project in Publisher Account.
2. Click Launcher in the side menu.
3. Find the launcher on the dashboard and click Edit launcher.
4. In the Games section, click Set up to the right of your game.
5. Go to Builds > Game builds.
6. Select the Web game type.
7. Click Yes, change to confirm.
8. In the Adding web game build section:
   1. Specify the Game URL.
   2. Select whether the game should be launched in a maximized window.
   3. Specify the Default game window resolution.
9. Click Save changes.

Set up transfer of user data

Use one of the following ways to set up user authorization in the game:

1. Set up JWT authentication on the game side. If you have questions, contact your Customer Success Manager or email to csm@xsolla.com.
2. Enable user authorization forwarding from Launcher to the game. The game is opened in the browser within Launcher. Launcher opens the game link win the following format: https://exmaple.com?token=<jwt-token>&locale=<locale>, where <jwt-token> is Xsolla Login user JWT, and <locale> is the interface language in the ISO 639-1 format.

Set up selling in-game virtual items and virtual currency

To set up selling game keys, in-game virtual items and virtual currency, refer to these instructions.Last updated: October 10, 2023