Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Setup

You are reading the documentation for Bridge SDK v2. If you need the obsolete v1 documentation, see Documentation (v1).

Installation

Install the Bridge package for your engine:

JS Core contains the shared SDK logic. Engine packages for Unity, Godot, Construct and other engines are wrappers around JS Core. Use JS Core directly in web engines such as PlayCanvas, Phaser, LayaAir and similar frameworks.

Integration

Add the script from CDN:

<html>
    <head>
        <script src="https://bridge.playgama.com/v2/stable/playgama-bridge.js"></script>
    </head>
    <body>...</body>
</html>

When the game launches on a supported platform, Bridge automatically loads the required platform scripts. In unsupported environments, Bridge uses a mock platform and returns safe defaults (false, reject, etc.) instead of throwing.

Initialization

Call the initialization method and wait for it to finish before using any bridge.* API.

bridge.initialize()
    .then(() => {
        // initialization was successful, SDK can be used
    })
    .catch(error => {
        // error, something went wrong
    })

Installation

  • Open Window → Package Management → Package Manager

  • Click the plus button and select Install package from git URL

  • Enter https://github.com/playgama/bridge-unity.git

  • Open Playgama → Bridge Setup and click Add in the Add Bridge WebGL Template section

Use the example project as a reference integration:

https://github.com/playgama/bridge-unity-examples

Initialization and Build

The Unity package initializes Bridge automatically while the game loads. No extra initialization call is required.

Select the Bridge WebGL Template before building.

Installation

Download the latest version of playgama_bridge.c3addon from the GitHub release page.

Go to Menu → View → Addon Manager and click Install new addon.... Select the downloaded file and click Install in the popup window.

Open your project, right-click on the Object types folder, and select Add new object type. Choose Playgama Bridge and click Insert.

Setup

Set Use Worker to No in the project settings (Menu → Project → Properties).

Installation

Release page

Download the required version of PlaygamaBridge.json from the GitHub release page.

Go to Project Manager → Create or search for new extensions → Import extension and select the downloaded file.

Initialization

Initialization starts automatically. Wait until it completes before running game logic that uses Bridge, such as reading player profile or storage data. Use the Is Initialized condition to gate that logic.

Integration

Download the latest playgama_bridge.zip archive, unzip it, and place the contents into res://addons:

Enable the plugin in the project settings:

Place Bridge first in the AutoLoad list.

Initialization

The Godot plugin initializes Bridge automatically while the game loads. No extra initialization call is required.

Build

Select the Bridge HTML template in export settings under Custom HTML Shell:

Installation

Download the latest .yymps from the GitHub release page and import it via Tools → Import Local Package menu.

Tools → Import Local Package

Initialization and Build

The GameMaker package initializes Bridge automatically while the game loads. No extra initialization call is required.

Select the Bridge index template before building.

Game Options → HTML5 → General

Installation

Copy the Source code.zip link from the GitHub release page and add it as a dependency in your project settings.

Then select Project → Fetch Libraries.

Initialization and Build

The Defold package initializes Bridge automatically while the game loads. No extra initialization call is required.

Select the Bridge index template before building.

Installation

Download the latest .zip archive from the GitHub release page and import it into your project. Import all files except the optional Examples folder. The extension installs web-mobile and preview templates automatically; you can also run manual installation from Extensions → Playgama Bridge → Install.

Build Template

Use the web-mobile build target. Bridge provides templates for web-mobile and preview builds.

Integration

Download PlaygamaBridge.js from the GitHub release page. In TurboWarp, click Add Extension, select Custom Extension, choose the downloaded file, and enable Run without sandbox.

When the game launches on a supported platform, Bridge automatically loads the required platform scripts. In unsupported environments, Bridge uses a mock platform and returns safe defaults (false, reject, etc.) instead of throwing.

Initialization

Call the initialization method and wait for it to finish before using Bridge blocks.

Required steps

Installation is only the first part of the integration. Every game must also implement the required steps. See the full list with exact methods in API → Required steps.

PreviousGetting startedNextConfig

Last updated