# Changelog

### [v1.30.0](https://github.com/Playgama/bridge/releases/tag/v1.30.0)

<mark style="color:blue;">Apr 10, 2026</mark>

#### Advertisement Module

* Added advanced banners. Supported on Playgama, CrazyGames, MSN
* Added initial interstitial delay
* Improved adblock detection

#### Platform Module

* Added `sendCustomMessage()`

#### Youtube

* Updated integration
* Added support for `advertisement.showRewarded`

#### Other Improvements

* Improved Xiaomi integration
* Improved QA Tool integration
* Minor code style fixes

### [v1.29.0](https://github.com/Playgama/bridge/releases/tag/v1.29.0)

<mark style="color:blue;">Mar 17, 2026</mark>

#### Playgama

* Added support for `payments.consume` and `payments.getPurchases`

#### Microsoft Store (beta)

* Added player authorization and player info support
* Improved purchase and authorization verification

#### TikTok (beta)

* Added platform support

#### GameSnacks (beta)

* Added platform support

#### Dlightek (beta)

* Added platform support

#### Yandex

* Added support for pause and resume events

#### Unity

* Added PlayerPrefs Editor

#### JS Core

* Added build mode for single-platform bundles

#### Social Module

* Added `isAddToHomeScreenRewardSupported` and `getAddToHomeScreenReward`
* Added `isAddToFavoritesRewardSupported` and `getAddToFavoritesReward`

#### Platform Module

* Added new events to `sendMessage` with optional `world` and `level` parameters:
  * `level_started`
  * `level_completed`
  * `level_failed`
  * `level_paused`
  * `level_resumed`

#### Other Improvements

* Improved Facebook integration
* Improved MSN integration
* Improved QA Tool integration
* Improved built-in No Ads popup

### [v1.28.0](https://github.com/Playgama/bridge/releases/tag/v1.28.0)

<mark style="color:blue;">Feb 6, 2026</mark>

#### Unity Plugin & Optimization Tool

* Added preload for critical Unity resources
* Added automatic viewport meta handling for mobile devices
* Added DNS prefetch and preconnect for CDN resources
* Provides detailed analysis of Unity builds
* Displays all used assets (images, audio, 3D models, fonts, shaders, etc.)
* Helps optimize assets used in the build
* Automatically applies optimal compression settings for the build and code

#### Microsoft Store (beta)

* Added platform integration
* Added ads(Playgama Ads) support
* Added in-app purchases support
* Added ratings and reviews support

#### Analytics

* Various internal improvements

#### SaaS

* Added cloud leaderboards support (beta)

#### QA Tool

* Added engine and version to initialization payload
* Added CLEAN\_CACHE action and cleanCache method
* Added audio state and pause handling
* Added internal storage policy management
* Added bridge configuration to initialization message

#### Xiaomi

* Added guest user support
* Platform internal storage is now available only for authorized players

#### CrazyGames

* Fixed getPurchases and getCatalog methods
* Fixed mobile Xsolla window handling (reject flow)
* Fixed consume method

#### Claude Code

* Updated Claude Code plugins

### [v1.27.0](https://github.com/playgama/bridge/releases/tag/v1.26.0)

<mark style="color:blue;">Dec 4, 2025</mark>

**Xiaomi**    <mark style="color:purple;background-color:$info;">platform</mark>      <mark style="color:orange;background-color:yellow;">beta</mark> &#x20;

* New platform integration
* Supports banner, interstitial, and rewarded ads (Google AdSense)

**MSN**    <mark style="color:purple;background-color:$info;">platform</mark> &#x20;

* Added cloud saves support
* Fixed `payments.purchase` flow
* SDK updated from `rc.20` to `rc.21`

**Discord**    <mark style="color:purple;background-color:$info;">platform</mark> &#x20;

* Updated authentication
* Fixed `isInviteFriendsSupported` and `isShareSupported`&#x20;

**YouTube, Yandex, Facebook**    <mark style="color:purple;background-color:$info;">platform</mark> &#x20;

* Small fixes

**QA Tool**    <mark style="color:purple;background-color:$info;">platform</mark> &#x20;

* Added authorization state management in the player state section
* Internal storage is now available only to authorized players
* Added a guest state for unauthorized players
* Fixed `platform.language`
* Added the ability to launch the QA tool via URL, including launching from localhost
* Added the ability to manage the state of advertisements

**Playgama**    <mark style="color:purple;background-color:$info;">platform</mark> &#x20;

* Fixed `tryParseJson` logic for the `storage.get` method
* Added support for `game_ready` message

**JS Core**    <mark style="color:green;background-color:$info;">engine</mark> &#x20;

* Added built-in overlay `Device Orientation Popup` displayed on mobile and tablet devices when screen orientation doesn't match the supported orientations
  * Configurable via `options.device.useBuiltInOrientationPopup` & `options.device.supportedOrientations`
  * Uses `Screen Orientation API` with `matchMedia` and `dimension comparison` fallbacks
* Centralized array validation for `storage.get`, `set`, and `delete` methods
* Added `postToParent()` and `postToSystem()` utility functions
* Unified platform-specific error constants into a single `ERROR.GAME_PARAMS_NOT_FOUND` constant
* Improved loading from CDN

**Construct, Godot 3 & 4, Defold, Cocos Creator, GDevelop, Game Maker, Scratch**    <mark style="color:green;background-color:$info;">engine</mark> &#x20;

* Added `options` to `payments.purchase` method
* Improved loading from CDN

**Unity**    <mark style="color:green;background-color:$info;">engine</mark> &#x20;

* Restructured project as Unity Package Manager compatible package
* Added `Playgama/Bridge Setup` menu for Editor Setup Window
* Added Editor Debug Window – interactive UI for testing advertisement, payments, player authorization in editor without building
* Early Callbacks Fix – messages are now queued until Unity instance is ready, preventing lost events
* Extracted inline JavaScript from `index.html` to separate `playgama-bridge-unity.js` file
* Removed obsolete example files and unused assets
* Improved loading from CDN

### [v1.26.0](https://github.com/playgama/bridge/releases/tag/v1.26.0)

<mark style="color:blue;">Oct 14, 2025</mark>

* [x] Added **Reddit** platform    <mark style="color:orange;background-color:yellow;">beta</mark> &#x20;
* [x] Added **YouTube** platform    <mark style="color:orange;background-color:yellow;">beta</mark> &#x20;
* [x] Added **Portal** platform    <mark style="color:orange;background-color:yellow;">beta</mark> &#x20;
* [x] Added guest accounts
* [x] Added CDN
* [x] Added schema for `playgama-bridge-config.json`
* [x] Added [Config Editor](https://playgama.github.io/bridge-config-editor/)
* [x] Updated **Discord** integration
* [x] Updated **QA Tool** integration
* [x] Updated **JioGames** integration
* [x] Updated **MSN** integration
* [x] Updated **Playgama** integration
* [x] Updated `playgama-bridge-config.json`
* [x] Updated platform pause and audio events

### [v1.25.0](https://github.com/playgama/bridge/releases/tag/v1.25.0)

<mark style="color:blue;">Sep 4, 2025</mark>

* [x] Added **Huawei** platform    <mark style="color:orange;background-color:yellow;">beta</mark> &#x20;
* [x] Added **JioGames** platform    <mark style="color:orange;background-color:yellow;">beta</mark> &#x20;
* [x] Added payments for **CrazyGames**
* [x] Added `player.extra` with additional information provided by platforms

> For example: `player.extra.jwt` on **Playgama**, `player.extra.payingStatus` and `player.extra.signature` on **Yandex**

* [x] Added additional information for purchases provided by platforms

> For example `purchase.jwt` on **Playgama**

* [x] Added new leaderboards type `native_popup`
* [x] Added leaderboards for **Facebook**
* [x] Added join community (group and page) for **Facebook**
* [x] Added `game_ready` analytics event
* [x] Updated server for receiving server time to **Playgama**
* [x] Fixed payments for **Discord**, **BitQuest**, **Facebook**
* [x] Fixed platform module for **Unity**
* [x] Fixed storage for **BitQuest**

### [v1.24.0](https://github.com/playgama/bridge/releases/tag/v1.24.0)

<mark style="color:blue;">Jul 31, 2025</mark>

* [x] &#x20;Added **BitQuest** platform    <mark style="color:orange;background-color:yellow;">beta</mark> &#x20;
* [x] &#x20;Advertisement
  * Added `advertisement.isInterstitialSupported`
  * Added `advertisement.isRewardedSupported`
* [x] &#x20;Platform
  * Added `platform.isAudioEnabled`
  * Added `platform.on('audio_state_changed')`
  * Added `platform.on('pause_state_changed')`
* [x] &#x20;Leaderboards
  * Added `isMain` property to the `playgama-bridge-config.json`
* [x] &#x20;Storage
  * Changed `storage.defaultType` from `local_storage` to `platform_internal` for **CrazyGames**

    > ⚠️ If you're updating your game on CrazyGames, don’t forget to [migrate your stored data](https://docs.crazygames.com/sdk/data/#integrating-data-module-into-already-published-games)
* [x] &#x20;Playgama QA Tool
  * Added support for the `platform.language`
  * Added support for the `leaderboards`
* [x] &#x20;Bug Fixes
  * Fixed payments for **MSN**
  * Fixed payments for **Facebook**

### [v1.23.0](https://github.com/playgama/bridge/releases/tag/v1.23.0)

<mark style="color:blue;">Jun 27, 2025</mark>

* [x] Added **Discord** platform    <mark style="color:orange;background-color:yellow;">beta</mark> &#x20;
* [x] Added new loading screen
* [x] Added backfill advertisements for **MSN**
* [x] Added built-in advertisement popups for **MSN** and **Facebook**
* [x] Improved `leaderboards` module
* [x] Improved **Facebook** integration
* [x] Updated currency code for [Playgama.com](https://playgama.com)
* [x] Fixed `social.share` for **Playdeck**
* [x] Removed **GameMaker** obsolete callbacks
* [x] Removed **Yandex** deprecated methods

### [v1.22.0](https://github.com/playgama/bridge/releases/tag/v1.22.0)

<mark style="color:blue;">May 28, 2025</mark>

* [x] Added [playgama-bridge-config](https://wiki.playgama.com/playgama/sdk/playgama-bridge-config "mention") page
* [x] Improved advertisement module:
  * Improved the `showBanner` method
  * Added banner placeholders in **QA Tool**
  * Added placement support to `showBanner`, `showInterstitial` and `showRewarded` methods
  * Added `advertisement.rewardedPlacement`
  * Added auto preloading for interstitial and rewarded ads
  * Added fallback logic for placements
  * Improved the minimum delay between interstitials timer logic
  * Disabled the minimum delay between interstitials for **GameDistribution**
* [x] Improved payments module
* [x] Improved `playgama-bridge-config.json`
* [x] Added `platform.language` support for [Playgama.com](https://playgama.com/)
* [x] Improved **Yandex** integration
* [x] Improved **MSN** integration
* [x] Removed support for the **Wortal** platform

### [v1.21.0](https://github.com/playgama/bridge/releases/tag/v1.21.0)

<mark style="color:blue;">Apr 17, 2025</mark>

* [x] Updated payments module
* [x] Added support for payments and cloud saves on **Playgama**
* [x] Added support for **MSN** platform
* [x] Added `platform.getAllGames` & `platform.getGameById` methods
* [x] Moved SDK settings from plugins to JSON file
* [x] Improved `storage.get` and `storage.set` methods
* [x] Updated **Facebook** SDK to 8.0
* [x] Added **Facebook** ad preloading
* [x] Updated `invite` and `share` methods for **Facebook**
* [x] Fixed issue with game visibility state changes on iOS
* [x] Fixed banner container for GameDistribution and **CrazyGames**
* [x] \[Unity] Wrapped examples with #define
* [x] \[Unity] Removed Newtonsoft JSON dependency, reducing build size by approximately 2MB
* [x] \[Unity] Fixed issues when using Enter Play Mode Settings without Reload Domain
* [x] \[GDevelop] Fixed error on empty leaderboard
* [x] \[GDevelop] Fixed multiple state change callbacks issue
* [x] \[Godot] Fixed extra tags in index.html

### [v1.20.0](https://github.com/Playgama/bridge/releases/tag/v1.20.0)

<mark style="color:blue;">Feb 11, 2025</mark>

* [x] Added support for the **Poki** platform
* [x] Updated logic for show interstitial on start on **Game Distribution**
* [x] Updated logic for show banner on **Crazy Games** and **Game Distribution**
* [x] Updated **QA Tool** platform
* [x] Updated **Playgama** platform

### [v1.19.0](https://github.com/Playgama/bridge/releases/tag/v1.19.0)

<mark style="color:blue;">Dec 4, 2024</mark>

* [x] &#x20;Achievements module (**Y8**, **Lagged**)
* [x] &#x20;Leaderboards for **Y8**
* [x] &#x20;**Y8** ads fixes
* [x] **Facebook** fixes
* [x] &#x20;**QA Tool** fixes

### [v1.18.0](https://github.com/Playgama/bridge/releases/tag/v1.18.0)

<mark style="color:blue;">Nov 15, 2024</mark>

* [x] &#x20;Added **Facebook** platform
* [x] &#x20;Added **QA Tool**
* [x] &#x20;Added `isGetCatalogSupported`, `isGetPurchasesSupported` and `isConsumePurchaseSupported` flags

### [v1.17.0](https://github.com/Playgama/bridge/releases/tag/v1.17.0)

<mark style="color:blue;">Oct 30, 2024</mark>

* [x] &#x20;Added **Lagged** platform

### [v1.16.0](https://github.com/Playgama/bridge/releases/tag/v1.16.0)

<mark style="color:blue;">Oct 17, 2024</mark>

* [x] Added **Y8** platform
* [x] &#x20;Fixed **VK** detection
* [x] &#x20;Added `platform.sendMessage('game_ready')` re-call block
* [x] &#x20;Added `game_id` parameter

### [v1.15.0](https://github.com/Playgama/bridge/releases/tag/v1.15.0)

<mark style="color:blue;">Oct 2, 2024</mark>

* [x] &#x20;Added **Telegram** Mini Apps platform
* [x] &#x20;Removed interstitial at startup on **Yandex**
* [x] &#x20;Reworked `leaderboard.getEntries`
* [x] &#x20;Reworked `payments.getCatalog`
* [x] &#x20;Reworked `payments.getPurchases`
* [x] &#x20;Fixed `social.isExternalLinksAllowed`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.playgama.com/playgama/sdk/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
