Setup
Integration steps
Use this order for a new integration:
Install the Bridge package for your engine.
Create or update
playgama-bridge-config.jsonin the config editor.Wait for Bridge initialization before calling SDK APIs.
Read
platform.languageand apply localization.Load saved progress with
storage.get(...).Send
platform.sendMessage('game_ready')when the first playable frame is ready.Add interstitial ads at natural pauses, such as level transitions or game over.
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/v1/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.
Config
Use the config editor to create or update playgama-bridge-config.json. This file stores SDK settings: platform identifiers, in-game purchases, ad placements, and more.
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 ManagerClick the
plusbutton and selectInstall package from git URLEnter
https://github.com/playgama/bridge-unity.gitOpen
Playgama→Bridge Setupand clickAddin theAdd Bridge WebGL Templatesection
Use the example project as a reference integration:
Config
WebGLTemplates/Bridge/playgama-bridge-config.json stores SDK settings: platform identifiers, in-game purchases, ad placements, and more. Use the config editor to create or update it.
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:
Config
Use the config editor to create or update playgama-bridge-config.json, then import it into the Files folder. This file stores SDK settings: platform identifiers, in-game purchases, ad placements, and more.
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.
Config
Open the Playgama Bridge extension in the editor.
Select the onFirstSceneLoaded function. Configure SDK settings there: platform identifiers, in-game purchases, ad placements, and more. Use the config editor to create or update the configuration.
Initialization
Initialization starts automatically. Wait until it completes before running game logic that uses Bridge, such as reading player profile or storage data.
Integration
Download the latest playgama_bridge.zip archive, unzip it, and place the contents into res://addons:
GitHub releases page for Godot 3
GitHub releases page for Godot 4
Enable the plugin in the project settings:
Place Bridge first in the AutoLoad list.
Config
addons/playgama_bridge/template/playgama-bridge-config.json stores SDK settings: platform identifiers, in-game purchases, ad placements, and more. Use the config editor to create or update it.
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.
Config
datafiles/playgama-bridge-config.json stores SDK settings: platform identifiers, in-game purchases, ad placements, and more. Use the config editor to create or update it.
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.
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.
Config
Use the config editor to create or update playgama-bridge-config.json. Import it into res/web and add the /res folder to Bundle Resources. This file stores SDK settings: platform identifiers, in-game purchases, ad placements, and more.
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.
Config
extensions/playgama-bridge/playgama-bridge-config.json stores SDK settings: platform identifiers, in-game purchases, ad placements, and more. Use the config editor to create or update it.
playgama-bridge-config.json is copied automatically from the extension folder to the web-mobile build folder after each build.
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.
Config
Use the config editor to create or update playgama-bridge-config.json, then add it to your project. This file stores SDK settings: platform identifiers, in-game purchases, ad placements, and more.
Initialization
Call the initialization method and wait for it to finish before using Bridge blocks.
Last updated