Product in Practice
This page brings the working parts of MetaMarket together: what is implemented, one flow from sign-in to a state change, how integration works today, and where each capability is documented.
What is implemented
The core engine and integration surface are already used by MetaMarket's own games. Each item links to the page that documents its real interface.
Identity and device authentication. A player is a durable account; a device proves possession of an on-device key before it is issued a session. See Authentication.
Actions and state. A game reports actions; the engine evaluates each against the app's configuration and holds authoritative state. See Sending Actions and Reading State.
Quests and progression. An accept-to-complete lifecycle with staged, sequential, and parallel orchestration. See Quests and Progression.
Rewards, resources, quotas, inventory. One reward-package delivery path, resources that settle on read, refillable quotas, and an inventory. See Rewards and Inventory and Resources and Quotas.
Local and shared economy. Per-game currencies plus a platform currency and loyalty standing a game feeds through platform-owned quests but cannot mint or read. See Local and Shared Economies.
Configuration. A game's mechanics are a typed configuration document the engine reads per request. See App Configuration.
For the exact status of each, Product availability is canonical.
One complete flow
A real path from an empty client to a state change, using the actual routes and response shapes. It shows what a partner can observe end to end: sign-in, an action, the resulting local state, and the milestone report that hands off to the platform. The platform-side grant that milestone triggers is described where it happens rather than shown as an integrator-visible response, because a game cannot read the shared balance. This is what MetaMarket's own pet-care game does.
The game is registered. MetaMarket provisions the app id, the gateway address, and the app's configuration (its allowed actions and resources). Registration is assisted today; see Getting access.
A player authenticates. The client generates a device key and calls
POST /api/auth/device-login. An unknown device is bootstrapped as a guest; the response is{ accessToken, refreshToken, accessTokenExpiresAt }, with an RS256 access token on a 15-minute lifetime.The session starts.
POST /api/session/startreturns the app'sstart_session_directives. Running one of those directives (atrack_actionscall) opens the pet game's starter package, and its contents come back in that call'seffects, not in thesession/startresponse.The game reports an action. A
careaction on the pet:
The engine evaluates it against configuration.
careis a declared action that writes the pet'sgrowthresource. An action the app's config does not declare is not applied: it comes back counted inskippedwith HTTP 200, not an error.State changes, and a quest reacts. The write moves
growth. A staged "grow your pet" quest checksgrowthas an absolute condition, and its final task becomes claimable on the quest's next evaluation, not inside this action's response.
Before. The pet's growth resource is at 95.
Action. The care action with value 5, shown above.
Response (the real four-channel envelope):
After. growth is 100. The effects channel echoes the new absolute value, so the client updates without a second read; the staged quest's absolute check passes on its next evaluation, when its final task becomes claimable. What the integrator can observe ends there. A platform-owned bridge quest reacts to the milestone on the platform side and may credit the shared currency, but that grant does not appear in the game's response and is confirmed on platform-operated surfaces, not by the integrator.
The game reads state.
GET /api/player/statereturns the player's composite state, current at read time.An error or skip is handled. A spend a resource cannot cover (a
useon an exhausted quota) returns400with a stablecode; an undeclared or wrong-lane action is not applied and shows up inskipped. See Treat a non-zero skipped as a failure.The activity is recorded. Each action, reward, and economy movement is written to the platform's operational logs for monitoring and investigation.
This flow covers the game-side chain, from sign-in through the milestone report. The platform-side GG or loyalty grant that milestone triggers is not shown here, because a game cannot read the shared balance; its status is on Product availability, where it is marked platform-operated and proven in MetaMarket's own games. The full requests and responses for the game-side steps are in Worked Examples. Running them is not self-service: the Integration walkthrough is the same flow you run once assisted onboarding has provided an app id, the SDK, and a test environment.
How integration works today
MetaMarket is at an assisted-integration stage, and the docs say so rather than implying self-service. A studio is onboarded with the team: the app is registered, its configuration is prepared and reviewed together, and a test environment is provided. The typed .NET SDK is delivered at onboarding rather than from a public package feed, and any stack integrates over the HTTP API. Evaluate MetaMarket is the process; Product availability is the maturity of each capability.
What these links do and do not show
Each capability above links to the page documenting its real interface, which is what lets you check the description against the contract rather than take it on trust. They do not establish production usage at scale. Where something is proven only in MetaMarket's own games, Product Availability says so on the row for that capability.
What is planned
Planned work is on the Roadmap, kept separate from what runs today.
Last updated