Define soft and hard currencies and track player balances.
Currencies are the units your economy runs on — coins, gems, energy, or anything else. Each
game defines its own currencies; every player has a wallet holding their balances.
Dashboard
Unity
Unreal
Define your currencies in the dashboard — a currency is just a named unit; you decide whether
it’s earned, purchased, or both. You can also inspect player wallets here.
Define currencies and inspect player wallets in the dashboard.
AddGameFundsAsync credits the signed-in player’s wallet. The SDK resolves the
currency-tagged player template for you; a schema sync bakes its id so the call skips that
lookup. Balances read back as ordinary player data — the wallet is the row for that template.
// Grant. Resolves the "currency"-tagged template at runtime.PlayerData wallet = await FlockClient.Instance.Commands.AddGameFundsAsync("gold", 500);// After Code Generation → Sync Schemas, with a typed currency:wallet = await FlockClient.Instance.Commands.AddGameFundsAsync(FlockFundId._100, 500);// Read the signed-in player's balances.PlayerData balances = await FlockClient.Instance.Player.GetMyDataByTagAsync("currency");
Grants are money-safe. A grant fails rather than queueing when the server is unreachable, and
is never re-sent after an ambiguous failure — a timeout may mean the credit already landed, so the
SDK will not risk crediting twice. Only provably-unprocessed failures (408/429) retry, so wrap the
call in try/catch and let the player retry deliberately.
FlockFundId members are currency ids, not names (hence _100 — a leading underscore is
added when an id starts with a digit). Currency names live only on the dashboard’s admin
endpoint, which the SDK’s API key cannot reach.
Flock Add Game Funds credits the signed-in player’s wallet. The SDK resolves the
currency-tagged template, and a schema sync bakes its id so the call skips that lookup.
Sdk->GetCommandProvider()->AddGameFunds(TEXT("coins"), 250, OnCredited);// After a sync, with a typed currency:FFlockGenerated::AddFunds(this, EFlockCurrencyId::Gold, 100, OnCredited);
Grants are money-safe. A grant fails rather than queueing when the server is unreachable, and
is never re-sent after an ambiguous failure — a timeout may mean the credit already landed, so the
SDK will not risk crediting twice. Read balances back as ordinary player data.
Shop purchases debit the relevant wallet automatically as part of
the transaction — you don’t adjust balances by hand for a normal buy.
Qwacks
Flock
Protokite
Data Duck