Developer portal

Integration guide

Unity public configuration

Read game configuration with a public key, without embedding a secret.

Sandbox TEST integration
No cash value or production wallet credit. This guide and its examples use contract 9ae5180d5f8f.

A public read, with a fixed origin

Use GET /api/game-sdk/v2/config with one publicKey query value. The bundled UnityPublicConfig.cs source validates a fixed HTTPS origin and the exact public key format, snapshots the endpoint, disables redirects and sends no bearer. Copy and review this source in your Unity project; it is not a published package dependency.

Configuration includes sandbox status, rules and thresholds for display. A zero allowance or empty rules list remains valid. The server enforces its current rules again when accepting an event; a client configuration cannot grant money or prove a completed level.

var configClient = new Ggbucks.PublicV2.PublicConfigClient(
    "https://api.ggbucks.com",
    publicKeyFromYourGameConfiguration);
var config = await configClient.GetConfigAsync();
// Display TEST ggbucks and keep ordinary gameplay available on failure.

Validate on the target runtime

Compile the supplied source with your actual Unity version. Verify platform TLS trust, no-redirect behavior, invalid response handling and offline gameplay on a signed device build. The public client has no event, account approval or balance mutation methods.

Use the same contract in your project

Read the focused agent skill or download its source and contract ZIP. Review the included source before adding it to your game. Exact fields and action variants are available in the API reference.