Gully Studio developer docs
Gully Studio developer docs
Gully Studio is the game studio of Gully Labs (opens in a new tab). Games are built mostly in Unity 6 LTS, with assets and tools from the Unity Asset Store, and they run on the same services as every other Gully product: players sign in with Gully ID, pay through Gully Pay, and keep items, scores, quests and prizes on Gully Chain (testnet chain ID 485590).
These docs cover the whole path, from creating a private game repo out of the studio template to shipping signed builds from CI. The developer portal (opens in a new tab) has the quickstart stepper, SDK versions, sample projects and the live status of studio services.
#How the pieces fit
Unity 6 game (private repo from gully-studio-unity-template)
|
+-- Gully Game SDK (UPM, MIT)
| GullyIdClient ........ id.gullychain.xyz (OIDC + PKCE)
| JsonRpcClient ........ testnet-rpc.gullychain.xyz
| or rpc.gullyrpc.xyz/<project>/evm/485590
| GullyArcadeClient .... testnet-arcade.gullychain.xyz + GullyArcade contract
| X402Client ........... your server -> Gully Pay API
| ITransactionSender ... the player's account (the SDK holds no keys)
|
+-- Gully Quests contracts on Gully Chain (achievements, offerwall quests)
|
+-- Multiplayer
FishNet netcode -> headless Linux dedicated servers
Nakama backend (auth, matchmaking, leaderboards, storage)
all on Gully infrastructure, behind Caddy#Where to start
| If you want to | Read |
|---|---|
| Create a new game repo with the studio's settings and CI | Getting started |
| Add the Gully Game SDK to a Unity project | Gully Game SDK |
| Let players sign in with one Gully identity | Gully ID sign-in |
| Send transactions from the player's account | Wallet |
| Read contracts and balances on Gully Chain | Gully Chain |
| Turn achievements into on-chain quests | Gully Quests |
| Sell items or charge per call | Payments |
| Build an online game | Multiplayer |
| Fund player rewards from advertisers | Offerwall |
| Ship builds from GitHub Actions | Release and CI |
| Get through App Store and Google Play review | Store policy |
| Stay inside the Asset Store licence | Asset Store licence |
| Use the logo, badges and colours | Brand |
#Repositories
| Repo | Visibility | What |
|---|---|---|
| gully-labs/gully-game-sdk (opens in a new tab) | Public, MIT | Unity package: Gully ID, Gully Chain, Gully Pay x402, Gully Arcade |
gully-labs/gully-studio-unity-template |
Private | Unity 6 LTS project template: Force Text, Git LFS, UnityYAMLMerge, GameCI |
| gully-labs/unity-builder (opens in a new tab) | Public, MIT | Fork of game-ci/unity-builder used by the template's CI |
| gully-labs/nakama (opens in a new tab) | Public, Apache-2.0 | Fork of Heroic Labs Nakama, the game backend |
| gully-labs/agones (opens in a new tab), quilkin (opens in a new tab), open-match (opens in a new tab) | Public, Apache-2.0 | Game server hosting, UDP proxy and matchmaking forks |
Note
Game repos are private and stay private. Asset Store content may ship inside a built game but must never be redistributed as source. See Asset Store licence.
#Status
The SDK is at v0.1.0: work in progress, and APIs may change before 1.0. Gully Chain is a testnet. Frog Hop, the first arcade title, is live on testnet; the first Unity titles are in development. Each page marks what is live and what is still being built.