Home / Tech spec
Technical specification
Measured from the current build of the platform: the Unity client, the game server, the slot engine, the database, and the admin console. Every package — from the $999 single game to the 30-game bundle — includes all of it.
01
One Unity project runs every title. The client only animates results: reels, balance, and features are decided by the server.
| Engine | Unity 6000.3.20f1 · Universal Render Pipeline 17.3 (2D renderer) · uGUI · Input System |
|---|---|
| Key packages | Addressables 3.1 · Localization 1.5 · Newtonsoft JSON 3.2 · Timeline · Visual Effect Graph |
| Build targets | Android (IL2CPP, ARM64, min API 25) with a command-line signed-APK build; WebGL; macOS. A full client build can be shared on request. |
| Content packaging | Each title is a remote Addressables group downloaded on demand; the lobby and shared UI ship in the app. The game server can host the bundles itself at /addressables. |
| Code layout | Boot, Core (wire models), Game (slot-style machine, reels, coin round, lobby, respin board), Net (REST client, asset loading), UI (HUD, rules pages, localization), Timeline (server-event presentation), Editor (build and art tooling) |
| Networking | REST over UnityWebRequest with JWT bearer auth. Spin commands carry protocol version 2 and a fresh idempotency key; one safe retry reuses the same request bytes. |
| Embedding | A slot panel entry point lets a host Unity app list the games and launch them with its own session token; an exporter packs the runtime as a DLL SDK. |
| Localization | 12 locales, a shared UI string table (165 keys), and per-title rules pages; language picker plus device-locale detection |
| Tests | 65 EditMode and 8 PlayMode test files (≈686 test cases by source count) |
02
A single ASP.NET Core 8 service hosts the game API, the SignalR hub, the admin console, and optionally the client's content bundles.
| Stack | .NET 8 · ASP.NET Core · EF Core (Pomelo MySQL 8.0) · JWT Bearer · BCrypt.Net · Swashbuckle |
|---|---|
| Startup checks | Validates every game definition, applies database migrations, and checks pinned feature sessions; the server refuses to start on invalid data. |
| Background work | Scheduled math deployments publish at a set UTC time. |
| Health | GET /health |
| Endpoint | Access | Purpose |
|---|---|---|
POST /api/auth/register | Public | Create a player account |
POST /api/auth/login | Public | Sign in; returns a JWT with virtual-coin balance and revision |
GET /api/games | Public | Lobby list, optionally with maintenance status |
GET /api/games/{id}/config | Player | Reels, symbol table, coin levels, features, math version and hashes |
POST /api/games/{id}/spin | Player | Coin round, free round, or feature round |
POST /api/games/{id}/command | Player | Feature commands such as the free-spin choice |
GET /api/games/{id}/session | Player | Reconnect to an unfinished feature |
GET /api/balance | Player | Virtual-coin balance and revision |
/api/admin/* | Admin (per-area permission) | 42 endpoints behind the admin console |
/hubs/live | Player | SignalR hub pushing virtual-coin balance updates |
POST /api/games/{gameKey}/spin Authorization: Bearer <jwt> { "protocolVersion": 2, "command": "spin", "gameKey": "{gameKey}", "coinAmount": 1.0, "lines": 20, "amountMinor": 200000, "currency": "XGC", "idempotencyKey": "7f3c…", "sessionRevision": 41 }
{
"roundId": "…",
"state": "base",
"reels": [[3,7,1],[…]],
"result": { … },
"freeRounds": { … },
"events": [ … ],
"availableCommands": ["spin"],
"balanceMinor": 998000,
"balanceRevision": 1043,
"mathVersion": "…",
"mathHash": "…"
}
03
One data-driven engine runs every title from its JSON definition. New games are mostly new definitions and art, not new server code.
Paylines, ways (fixed or variable rows), pay-anywhere, and row-anywhere evaluators, plus cascades (tumbles) and a max-multiplier cap.
Free rounds with retriggers, player-choice free-round packages, respins, gem respins, sticky, multiplier and raining wilds, and feature rounds.
Optional shared feature pools and fixed feature tiers, scored as multipliers.
Cryptographic RNG (.NET RandomNumberGenerator) in production; a seeded RNG for simulations and tests. Every round's full result is stored, so any round can be replayed in the admin console.
Game math is defined per title and can be tuned from the admin console. Detailed math notes are available on request under NDA.
Each title is three JSON parts — base game, free rounds, and logic — with SHA-256 math and definition hashes. Users in a feature round stay on the version they started.
Validate, publish, or schedule a new definition from the admin console with hot reload, automatic archiving, one-click restore, and a change log of every attempt.
Multi-threaded Monte-Carlo runs on the production engine (default 100,000 spins), including what-if runs on a candidate definition before it goes live.
Command-line definition checks and 19 offline golden suites covering the engine, virtual-coin contract, protocol, features, and maintenance rules.
04
MySQL or MariaDB through Entity Framework Core. 17 migrations run automatically at startup. Every financial command is one database transaction with row locks.
| Table | Holds |
|---|---|
Users | Users and admins, BCrypt password hash, virtual-coin balance, balance revision, block and admin permissions |
Transactions | Every virtual-coin balance movement with before/after balance and source |
GameLogs | Every round with its full result, command type, and math version |
SpinCommands | Idempotency receipts: request hash and stored response |
FeatureSessions | Reconnectable, version-pinned feature-round state per user and game |
GameStats | Per-game ledger and enabled flag |
| Virtual-coin pools | Shared virtual-coin pool and feature-round pools |
GameMaintenances | Global or per-game maintenance windows |
MathChangeLogs · ScheduledMathDeployments | Math publish history and scheduled releases |
| Math simulation runs | Saved simulator runs with settings and reports |
Database constraints and a trigger keep balances in range and balance revisions monotonic.
05
A web console served by the game server at /admin. The console UI is in Korean. Access is available on request.
| Area | What the admin can do |
|---|---|
| Dashboard | KPIs over rolling 1, 3, 6, and 12-hour windows |
| Realtime | Live play activity and request success, failure, and latency |
| Games | Enable or disable games, edit game math settings, and schedule global or per-game maintenance |
| Math | Edit, validate, publish, schedule, and restore game definitions |
| Simulator | Run and compare math simulations |
| Players | Search players, adjust balances, block accounts, grant maintenance bypass |
| Reports | Per-game results split into base game, free rounds, and feature rounds |
| Rounds | Spin history with filters, round detail and replay, raw game logs |
| Audit | Math changes, balance adjustments, and admin actions |
| Security | Create admin accounts and grant none, view, or edit per area |
Permissions are carried in the admin's token and enforced on every admin API call, not only hidden in the UI.
06
07
The 13 live titles as defined in their math files. Virtual coins only.
| Title | Grid | Lines | Main features | Extra feature | Max multiplier |
|---|---|---|---|---|---|
| Savanna Storm | 5×4 | 1,024 ways | Free spins 8/15/20 with retrigger, ×1–×3 wilds, symbol upgrades from a collector | 100× | — |
| Sunstone Citadel | 5×4 | 50 lines | Free spins 10/15/20 | — | — |
| Velvet Fortune | 5×3 | 50 lines | Respins with four feature tiers; 6 free rounds with ×5 multipliers | — | — |
| Jadeveil Temple | 5×3 | Row-anywhere | Choice of 5 free-round packages (10×2 to 3×8), shared top feature tier | — | — |
| Frostpeak Dominion | 5×3 | 5 lines | Repeat-feature free rounds, adjacent-reel scatter matches, paired feature tiers | — | — |
| Mischief & Gold | 5×3 | 25 lines | Respins with multiplier coins and five feature tiers; 12 free rounds | — | — |
| Verdant Fang | 5×3 | 25 lines | Wilds ×2–×20, 10 free rounds with retrigger, gem respin | — | 10,000× |
| Amberclaw Dynasty | 5×3 | 243 ways | Respins with five feature tiers; 8 free rounds | 100× | — |
| Sunscarab Vault | 5×3 | 50 lines | Respins with four feature tiers; 9 free rounds | 100× | — |
| Copperfang Canyon | 5×3 | 20 lines | Free spins 5/10/15 | — | — |
| Crimsonwood Tales | 5×3 | 20 lines | Free rounds 8/10/12, scatter coin collect at 5/15/50× | — | — |
| The Animal Party | 5×3 | 20 lines | Sticky wilds in free rounds, ×2/×3 wilds, random free-round count | — | 6,750× |
| Stormforge Legacy | 5×3 | 20 lines | ×1/×2 wilds, 8 free spins | — | 6,750× |
Extra features and the max multiplier are expressed as multipliers of the coin amount used for the round. Game math is set per title in the admin console.
08
| Server OS | Linux x64 (publish script and systemd unit included) |
|---|---|
| Runtime | .NET 8 (ASP.NET Core) |
| Database | MySQL or MariaDB; the account must be able to create triggers and check constraints |
| Network | Plain HTTP on a configurable port (7760 by default); terminate TLS at your reverse proxy or load balancer |
| Game content | Game definitions in a games folder; client bundles served from the game server or any static host |
| Client build | Unity 6000.3.20f1; Android builds need the Android module and your signing keystore |