# Setup

### <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2F9BooaofCI33U9Np5oeif%2FFrame%203%20(1).png?alt=media&#x26;token=0750b56a-a069-4759-bda9-29951f06cd30" alt="" data-size="line"> Installation

#### GDevelop IDE

Go to `Project Manager`  <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FEu4k66xHk2USeNqEhSkj%2FScreenshot%202025-01-20%20at%2010.51.19.png?alt=media&#x26;token=dcd2f7f9-5598-4060-9f06-a162f42d612a" alt="" data-size="line"> → `Create or search for new extensions` <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FEj221DFgEaAWLE9q3jwG%2FScreenshot%202025-01-20%20at%2010.57.40.png?alt=media&#x26;token=ef276c0b-c8fd-4aeb-85c8-6267ff77e5a4" alt="" data-size="line"> → Type `Playgama Bridge` in `Search extensions` field and install the extension.&#x20;

<figure><img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FcvgFa4tFaR2n2zDCDP1y%2FScreenshot%202025-01-27%20at%2017.18.18.png?alt=media&#x26;token=3522b670-e215-4944-ad8c-cbb998747007" alt=""><figcaption></figcaption></figure>

#### Release page

Download the specific version of `PlaygamaBridge.json` from the [GitHub release page](https://github.com/playgama/bridge-gdevelop/releases).

Go to `Project Manager`  <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FEu4k66xHk2USeNqEhSkj%2FScreenshot%202025-01-20%20at%2010.51.19.png?alt=media&#x26;token=dcd2f7f9-5598-4060-9f06-a162f42d612a" alt="" data-size="line"> → `Create or search for new extensions` <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FEj221DFgEaAWLE9q3jwG%2FScreenshot%202025-01-20%20at%2010.57.40.png?alt=media&#x26;token=ef276c0b-c8fd-4aeb-85c8-6267ff77e5a4" alt="" data-size="line"> → `Import extension` <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FQygx6o59JU8mVpco0rkO%2FScreenshot%202025-01-20%20at%2011.00.03.png?alt=media&#x26;token=7e995720-bda2-4634-92c0-e636f3949853" alt="" data-size="line">  and select the downloaded file.&#x20;

### <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2F9BooaofCI33U9Np5oeif%2FFrame%203%20(1).png?alt=media&#x26;token=0750b56a-a069-4759-bda9-29951f06cd30" alt="" data-size="line"> Config

Open `Playgama Bridge` extension in the editor.

<figure><img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FPc1yXwOFWiDVXFPGTqx6%2FScreenshot%202025-04-17%20at%202.45.34%E2%80%AFPM.png?alt=media&#x26;token=7da52346-ed94-414d-97ef-fc13fd107a51" alt=""><figcaption></figcaption></figure>

Select `onFirstSceneLoaded` function. There you can set up various identifiers and in-game purchases.

You can see an explanation of the file structure here: [playgama-bridge-config](https://wiki.playgama.com/playgama/sdk/playgama-bridge-config "mention").

<figure><img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2F5EvEOoLz35rUrju8fBMn%2FScreenshot%202025-04-17%20at%202.48.09%E2%80%AFPM.png?alt=media&#x26;token=b891204b-13ed-4d16-ba20-3df40b17f627" alt=""><figcaption></figcaption></figure>

### <img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2F9BooaofCI33U9Np5oeif%2FFrame%203%20(1).png?alt=media&#x26;token=0750b56a-a069-4759-bda9-29951f06cd30" alt="" data-size="line"> Initialization

The initialization happens automatically, but be sure to wait until it's complete before starting any game logic, such as retrieving the player's profile or storage data.

<figure><img src="https://1088849411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ukgSPDBOdbQp4FYtbz1%2Fuploads%2FOMafYnTQeNwlyJGNgEe2%2FScreenshot%202025-04-17%20at%203.01.05%E2%80%AFPM.png?alt=media&#x26;token=120a1866-1c7a-451c-8740-85e23ec88118" alt=""><figcaption></figcaption></figure>
