Description

Extension for integrating games with GamePush: one build for 20+ web platforms (Yandex Games, VK Play, Telegram, CrazyGames, etc.).

Documentation: docs.gamepush.com

Plugin Capabilities

Initialization and platform checks (type, tag, language, device, orientation). Analytics (page hit, goal). Achievements, rewards, triggers, and reward schedulers. Segments and events. Leaderboards (global and scoped). Game collections, feedback, confirm overlay. Ads (preloader, sticky, fullscreen, rewarded). Player: sync, profile, login/logout, Player.Set/Get/Add variables. Pause, sound (mute music/SFX). Social: share, post, invite, join community. Payments: purchases and consume. Game and platform variables (fetch, value by key).

How to use the extension

Installation

1. Download GamePush.json from the repository.
2. In GDevelop: Project Manager - Extensions - Import extension - select GamePush.json.
3. Actions and conditions will appear under Extensions - GamePush.

Setup and Usage

1. Register your game in the GamePush panel.
2. In the "Public zone" section, copy Project ID and Public Token.
3. On first scene load, call Initialize GamePush (Project ID, Public Token).
4. Before other GamePush calls, wait for GamePush is ready (e.g. loop: not ready - wait 0.1 s - repeat).
5. Optionally show preloader/sticky banner and continue the scene.
6. To learn how the SDK works, you can download the demo project.

Step-by-step Guide

1. SDK Initialization

Initialize once on first scene load (usually the starting scene):

1. Call Initialize GamePush and provide Project ID and Public Token from the GamePush panel.
2. Wait for GamePush is ready before any other calls.
3. Once ready, you can use the rest of the plugin's actions and conditions.

2. Showing Ads

Recommended flow:

1. Ensure GamePush is ready.

2. Call the desired ad type:

   • Preloader -- before the game loads.
   • Sticky banner -- persistent banner (show/hide as needed).
   • Fullscreen -- fullscreen ad.
   • Rewarded -- rewarded ad (typically on player request for a reward).

3. For rewarded: wait for the result and grant the reward.

3. Adding a Purchase (Payments)

1. Create products in the GamePush panel.
2. Ensure GamePush is ready.
3. Call Purchase with the item ID (or Tag).
4. Handle the purchase result (success/error).
5. Call Consume for consumable items if needed.

4. GamePush Player (Cloud Save)

Player data and variables are available after the SDK and player are initialized. You can read and write them at any time. Getting or setting values does not send requests to the server -- the player has a local copy on the device. To upload all variable changes to the server (one or many), call Sync.

5. Sound Module

The sound module syncs music and SFX mute state with the platform (Yandex Games, VK Play, etc.), so your game respects the player's sound preferences.

1. Call Register game for sound sync once at scene start (together with playing music).
2. Use Music is muted / SFX is muted to check the current state and update your UI (e.g. button labels "Music ON" / "Music OFF").
3. Call Toggle music (or Toggle SFX) when the player clicks the sound button.
4. The last mute states for music and SFX are saved automatically.
5. The SDK automatically monitors ad display and mutes sound using these methods to comply with platform requirements.

Checklist

• I've followed all of the best practices.
• I confirm that this extension can be integrated to this GitHub repository, distributed and MIT licensed.
• I am aware that the extension may be updated by anyone, and do not need my explicit consent to do so.

Example file

GamePushDemo.zip

Extension file

GamePush.json.zip

Extension by @Sceef

You can update the extension on this "Pull Request" by commenting the update command: in the comment field, type !update, then drag and drop a zip file with your extension file in the commenting field, like how you initially submitted the extension. It should look like this:

It can take a few seconds for the file to fully upload and show as the above. Once it is like shown above, click "Comment" and let the bot do the rest!