Construct 3 quickstart

FRVR ships a Construct 3 plugin — a .zip you install into Construct that exposes the SDK as a regular C3 object, with events / actions / conditions / expressions.

The plugin covers ads, IAP, local storage, cloud storage, and analytics tracking.

1. Install the plugin

Download the latest plugin zip from the Downloads page — e.g. frvr-construct-1.0.0.10.zip.

In Construct 3:

1. Menu → View → Addon Manager → Install new addon…
2. Pick the downloaded zip.
3. Restart Construct 3.

2. Add the FRVR SDK object

Add a single FRVR SDK object to your project. This must happen before any FRVR actions become available in the event sheet — Construct won’t expose the SDK actions until the object exists.

Once the object is in the project you’ll see its actions listed under it in the event sheet picker (Show Interstitial, Show Rewarded, Set Local Item, Get Cloud Item, Log Event, Purchase, …).

3. Build settings

When exporting your project:

Turn OFF Offline support

In the build export dialog, disable Offline support. Offline mode caches the HTML shell and will prevent FRVR’s release pipeline from injecting the right channel bundle at package time.

Otherwise, a normal Web (HTML5) export is what you want.

4. Event sheet patterns

Ads

• On a button tap → FRVR SDK: Show Interstitial
• On “Watch Ad” pressed → FRVR SDK: Show Rewarded
• On FRVR SDK: On reward granted → give the reward (only fires on a completed watch)
• On FRVR SDK: On ad skipped → tell the player they skipped — grant nothing
• On FRVR SDK: On ad error → show “no ad available” and re‑enable the button

The plugin has no “rewarded ready” condition — leave the button tappable and let On ad error handle the no‑inventory case. Full details in Ads (Construct 3).

Analytics

• On layout start → FRVR SDK: Level Start (“level_1”)
• On layout end → FRVR SDK: Level End (“level_1”)
• Custom event → FRVR SDK: Log Event (“shop_open”)

Storage

• FRVR SDK: Set local item (“coins”, Coins) to persist on device.
• FRVR SDK: Set cloud item (“save”, SaveJson) to sync across devices.
• Read with Get local item / Get cloud item.

IAP

• FRVR SDK: Purchase product (“coins_100”)
• On FRVR SDK: On purchase success → grant the item (read FRVR SDK.LastPurchase), then Consume purchase for consumables.
• On FRVR SDK: On purchase error → show the “try again” toast (read FRVR SDK.LastIAPError).
• At startup, FRVR SDK: Get unconsumed purchases → on On unconsumed purchases retrieved, loop FRVR SDK.LastUnconsumedPurchases and consume each. See IAP (Construct 3).

Common gotchas

• Actions missing from the picker? You haven’t added the FRVR SDK object to your project yet. Add one and they’ll appear.
• Works locally, breaks once published? You forgot to disable Offline support in the export dialog. Re-export.
• Ad calls no-op? The dev channel throttles interstitials by default (≈5 min apart, blocked for the first ~100 s). A rewarded request with no inventory fires On ad error rather than showing anything — wire that trigger so it’s visible.

Building for production

Export as usual (Menu → Project → Export → Web (HTML5)). FRVR’s release pipeline packages the export per platform and injects the right channel bundle — you don’t reference a production channel anywhere in the project.