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 Account Manager.
  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.

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Rate this page
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!
Last updated: October 21, 2022

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!