Skip to content

Releases: QwackStack/FlockUnitySdk

Flock Official release

27 Jun 10:18
ed39f90

Choose a tag to compare

Flock Unity SDK 1.19.0

First public release of the Flock Unity SDK (com.flock.sdk) — the complete
toolkit for wiring a Unity game to the Flock backend: auth, player data, shop,
game commands, analytics, and strongly-typed codegen.

Requires Unity 2020.3+ and Newtonsoft Json for Unity
(com.unity.nuget.newtonsoft-json 3.0.2+). If you import the .unitypackage,
add Newtonsoft first via Package Manager → Add package by name.

Install

Download FlockSDK-1.19.0.unitypackage below and import via
Assets → Import Package → Custom Package. Then open Qwacks → Flock to
set API URL, API Key, Game ID, and Game Version.

Features

Authentication

  • Email, device, Google, Apple, Steam, Facebook, and Discord login
  • Automatic silent token refresh with a session-expired event
  • Login persistence — saved sessions restored on startup
  • JWT token management; auth methods throw on failure (no error-state returns)

Player & game data

  • Player data reads with pagination; strongly-typed player-data accessors via codegen
  • Game configuration with typed accessors generated from your schemas
  • Game and game version metadata — lookup by ID or name
  • Player ban lookup
  • Asset listing and lookup by ID (with progress, concurrency, and caching)

Shop & commands

  • Browse shops and items, purchase, and inventory management (free items supported)
  • Server-side game commands: update player data, add funds
  • Money mutations (purchase, add funds) are not auto-retried — protects
    against double-charging; other commands are retry-safe

Offline & reliability

  • Offline-safe initialization — no network call at startup (game version ID is
    baked into the config asset at edit time)
  • Disk-cached static content keeps serving after one online session
  • Offline write queue with optimistic cache and automatic sync on reconnect
  • Automatic retry with exponential backoff and structured error handling
  • WebGL transport adapter

Analytics

  • Session tracking, custom events, and transaction logging
  • No-op safe when disabled

Errors & events

  • Coded-error envelope surfaced through FlockException.Code (typed error enums)
  • FlockEvents hub exposing init, auth, and session lifecycle events

Editor & codegen

  • Qwacks → Flock editor window backed by the FlockConfig ScriptableObject
  • Codegen tab — strongly-typed code for player templates, game configs, and
    game commands; fail-closed sync with CI drift detection
  • Onboarding aids: setup checklist, play-mode guard, and a quick-start sample

Startup

  • Hands-off auto-initialization from config at launch, or use the drop-in
    FlockBootstrap component, or call FlockClient.Create(config) yourself

Notes

  • WebGL: set EnableAssetCache = false (no synchronous file writes on that platform)
  • Logout() is local-only (no server-side token revocation) by design

Release v1.0.0

10 Jun 19:55

Choose a tag to compare