Releases: QwackStack/FlockUnitySdk
Releases · QwackStack/FlockUnitySdk
Flock Official release
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) FlockEventshub exposing init, auth, and session lifecycle events
Editor & codegen
- Qwacks → Flock editor window backed by the
FlockConfigScriptableObject - 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
FlockBootstrapcomponent, or callFlockClient.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