idosgames-platform

endpoint

https://site.idosgames.com/api/v2/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is idosgames-platform live?

Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.

Is idosgames-platform free to use?

Not measured yet.

What tools does idosgames-platform have?

137 tools: save_authentication, get_title_custom_data, save_title_custom_data, save_purchase, save_localization, save_advertising, get_authentication, get_feature_tracking, ….

Is idosgames-platform safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• save_authentication unknown never probed

  PARTIAL SAVE: writes ONLY the 'Authentication' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Authentication — which third-party sign-in methods the title offers and the public OAuth client IDs each platform build needs (currently Google: Web / Android / iOS / Desktop client IDs). Contains NO secrets: OAuth client IDs are public by protocol design, and none of the sign-in flows uses a client secret. Device / e-mail / Telegram / SSO logins need no configuration and are absent from this section. The ID-token audience differs per platform (web and Android tokens carry the Web client ID, iOS tokens the iOS client ID), so several IDs are filled at once and the server accepts any of them.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "AuthenticationDefinitions",
        "properties": {
          "Apple": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AppleAuthDefinition"
              }
            ],
            "description": "Sign in with Apple configuration (bundle ID for native iOS, Services ID for the web flow)."
          },
          "Email": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AuthEmailDefinition"
              }
            ],
            "description": "Who transactional e-mails come from. The SMTP password is NOT here - it lives in the private config."
          },
          "Google": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/GoogleAuthDefinition"
              }
            ],
            "description": "Google sign-in configuration (public OAuth client IDs per platform build)."
          },
          "Sessions": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AuthSessionsDefinition"
              }
            ],
            "description": "Session policy: token lifetimes, concurrent-device cap, re-authentication window and nonce strictness."
          },
          "AntiAbuse": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AuthAntiAbuseDefinition"
              }
            ],
            "description": "Abuse thresholds: account creation per IP, password brute-force lockout, e-mail sending caps."
          },
          "NativeSso": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AuthNativeSsoDefinition"
              }
            ],
            "description": "Signing in through idosgames.com from NATIVE builds (Android, iOS, desktop). The web and iframe flows need no configuration and are not affected by this block."
          }
        },
        "description": "Title-level authentication settings: which third-party sign-in methods the title offers and the public OAuth client IDs each platform build needs. Contains NO secrets - OAuth client IDs are public by protocol design. Device / e-mail / Telegram / SSO logins need no configuration and are not listed here."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "AppleAuthDefinition": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Master switch. When false the server rejects Apple login/link and the client hides the button."
          },
          "BundleID": {
            "type": [
              "null",
              "string"
            ],
            "description": "iOS app bundle ID. This is what the native build's token carries in aud."
          },
          "ServiceID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Services ID — Apple's separate identifier for the WEB flow (with its own return URLs). Web tokens carry it in aud instead of the bundle ID. Empty = no Apple sign-in on the web."
          },
          "AdditionalAudiences": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Extra accepted audiences: a second app of the same team, a build with a different bundle ID, or a migration between identifiers."
          }
        },
        "description": "Sign in with Apple. No secrets: verifying the identity token needs only Apple's public keys and the audience. The .p8 private key belongs to the authorization-code flow, which is not used here. Unlike Google there is no platform-wide fallback: the audience is the app's bundle ID, which is unique per game."
      },
      "AuthEmailDefinition": {
        "type": "object",
        "properties": {
          "ReplyTo": {
            "type": [
              "null",
              "string"
            ],
            "description": "Reply-To address. Worth setting even for a no-reply sender: players do reply, and without it the reply is lost."
          },
          "SenderName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name the player sees in the From field."
          },
          "SenderEmail": {
            "type": [
              "null",
              "string"
            ],
            "description": "From address. Empty = the one configured in the private SMTP settings."
          },
          "UseTitleSmtp": {
            "type": "boolean",
            "description": "Send through the title's own SMTP. False = platform sender (settings are kept but unused)."
          },
          "TemplateKeyPrefix": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key prefix for e-mail subjects and bodies. Empty = platform keys."
          },
          "PasswordSecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding the SMTP password. Takes precedence over the plaintext password in the private config."
          },
          "VerificationMaxAttempts": {
            "type": "integer",
            "format": "int32",
            "description": "Wrong-code attempts before the code is burnt and a new one must be requested. 0 = platform default."
          },
          "VerificationCodeTtlMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime of the registration confirmation code, in minutes. 0 = platform default."
          },
          "VerificationResendCooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between resends of the confirmation code to the SAME address, in seconds. 0 = platform default."
          }
        },
        "description": "Sender of transactional e-mails. Public part only: no credentials. Empty = platform sender, exactly as before."
      },
      "NativeSsoReturnMode": {
        "enum": [
          0,
          1
        ],
        "type": "integer",
        "description": "",
        "x-enumNames": [
          "Poll",
          "DeepLink"
        ]
      },
      "GoogleAuthDefinition": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Master switch. When false the server rejects LoginWithGoogle / LinkGoogle and the client hides the button."
          },
          "IosClientID": {
            "type": [
              "null",
              "string"
            ],
            "description": "iOS OAuth client ID. Also the source of the reversed-client-ID URL scheme written into Info.plist at build time."
          },
          "WebClientID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Web OAuth client ID. Used by the web build (GIS), by Android (as Credential Manager serverClientId) and optionally by iOS (as serverClientID). Most titles need only this one."
          },
          "AndroidClientID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Android OAuth client ID. NEVER an ID-token audience (Android tokens carry aud = WebClientID). Kept so the dashboard and the build check can tell the publisher whether their package name + SHA-1 is registered: without that registration Android sign-in fails on the device and leaves no trace on the server."
          },
          "DesktopClientID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Desktop OAuth client ID (\"Desktop app\" client type) used by the Unity Editor and desktop builds via the system browser + PKCE. Empty = no Editor sign-in."
          },
          "AdditionalAudiences": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Extra accepted audiences, for migrating between OAuth clients while builds carrying the old client ID are still in players hands."
          },
          "DisablePlatformFallback": {
            "type": "boolean",
            "description": "Disable the platform-wide fallback client (GOOGLE_CLIENT_ID env var). Default false on purpose: the default must mean the behaviour that existed before this section, otherwise adding it would silently break Google sign-in for every existing title."
          }
        },
        "description": "Google sign-in. The ID-token audience differs per platform, which is Google behaviour and not a choice: Web/GIS and Android/Credential-Manager tokens carry aud = WebClientID, iOS tokens carry aud = IosClientID, loopback/PKCE desktop tokens carry aud = DesktopClientID. The server accepts a token whose aud matches ANY of the filled IDs."
      },
      "AuthSessionsDefinition": {
        "type": "object",
        "properties": {
          "RequireNonce": {
            "type": "boolean",
            "description": "Require a nonce in Google/Apple tokens. Default false for compatibility: builds already in players' hands do not send one. A nonce that IS sent is always verified regardless of this flag."
          },
          "AccessTtlHours": {
            "type": "integer",
            "format": "int32",
            "description": "Access ticket lifetime in hours. 0 = the previous hardcoded 24h."
          },
          "RefreshTtlDays": {
            "type": "integer",
            "format": "int32",
            "description": "Refresh token lifetime in days. 0 = platform default."
          },
          "ReauthWindowMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "How recent the login must be for sensitive operations (unlink, revoke-all), in minutes. 0 = platform default."
          },
          "MaxConcurrentSessions": {
            "type": "integer",
            "format": "int32",
            "description": "Max concurrent devices per player. 0 = platform default, which is 1; values above the platform ceiling of 10 are clamped, not refused. When exceeded the OLDEST session is revoked rather than refusing the new login."
          }
        },
        "description": "Session policy of the title: access/refresh lifetimes, concurrent session cap, re-auth window, nonce strictness. Zero means \"keep the previous behaviour\"."
      },
      "AuthAntiAbuseDefinition": {
        "type": "object",
        "properties": {
          "RefreshPerHour": {
            "type": "integer",
            "format": "int32",
            "description": "Session refreshes per hour. 0 = platform default."
          },
          "EmailsPerIpPerHour": {
            "type": "integer",
            "format": "int32",
            "description": "Password-reset e-mails a single IP may trigger per hour. 0 = platform default."
          },
          "AccountsPerIpPerDay": {
            "type": "integer",
            "format": "int32",
            "description": "How many accounts a single IP may create per day. 0 = platform default."
          },
          "LinkAttemptsPerHour": {
            "type": "integer",
            "format": "int32",
            "description": "Identity link attempts per player per hour. 0 = platform default."
          },
          "PasswordLockMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "How long the temporary password lock lasts, in minutes. 0 = platform default."
          },
          "NativeSsoPollsPerHour": {
            "type": "integer",
            "format": "int32",
            "description": "Native-SSO request polls per hour. This is the only action the client repeats by design, so the per-second flood limit does not describe it. 0 = platform default."
          },
          "PasswordAttemptsBeforeLock": {
            "type": "integer",
            "format": "int32",
            "description": "Failed password attempts before a temporary lock. 0 = platform default."
          },
          "VerificationEmailsPerIpPerHour": {
            "type": "integer",
            "format": "int32",
            "description": "Registration confirmation e-mails a single IP may trigger per hour. Separate from EmailsPerIpPerHour on purpose: registrations must not eat the password-reset quota. 0 = platform default."
          }
        },
        "description": "Anti-abuse thresholds for authentication. Zero means the platform default, NOT \"unlimited\"."
      },
      "AuthNativeSsoDefinition": {
        "type": "object",
        "properties": {
          "UrlScheme": {
            "type": [
              "null",
              "string"
            ],
            "description": "App URL scheme without the '://' part, e.g. \"mygame\". Only used in DeepLink mode. Taken from the config and never from the request - a client-supplied return address would be an open redirect."
          },
          "ReturnMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/NativeSsoReturnMode"
              }
            ],
            "description": "Return mechanism: Poll (default, zero setup, works on every platform) or DeepLink (instant, requires a URL scheme registered in the config AND in the build)."
          },
          "RequestTtlSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "How long a Poll-mode sign-in request stays valid, in seconds. This is the window in which the person is expected to finish signing in and come back. 0 = platform default."
          },
          "PollIntervalSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "How often the game should poll for the result, in seconds. A hint for the client so it does not run into the poll quota by accident - the actual limit is NativeSsoPollsPerHour. 0 = platform default."
          }
        },
        "description": "How the sign-in result gets from the browser back into a NATIVE build. Poll needs no publisher setup and works everywhere; DeepLink returns instantly but requires a URL scheme in both the config and the build. Contains no secrets."
      }
    },
    "additionalProperties": false
  }

  arguments 354 lines copy
• get_title_custom_data unknown never probed

  GET ONLY the 'TitleCustomData' field of TitlePublicConfigurationModel. SCHEMA + limits for the title-wide key-value store (feature flags, project-wide globals, event state, balancing knobs that don't fit any typed definition below). This section holds ONLY the key schema — the VALUES live in the TitleCustomData store, one document per title, managed with the dedicated title-data tools (get_title_data / save_title_data). Each key declares a Scope (Static = authored config; Runtime = mutable state written only by CloudCode scripts) and a Bucket (Public = readable by game clients; Private = server/CloudCode only).

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_title_custom_data unknown never probed

  PARTIAL SAVE: writes ONLY the 'TitleCustomData' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. SCHEMA + limits for the title-wide key-value store (feature flags, project-wide globals, event state, balancing knobs that don't fit any typed definition below). This section holds ONLY the key schema — the VALUES live in the TitleCustomData store, one document per title, managed with the dedicated title-data tools (get_title_data / save_title_data). Each key declares a Scope (Static = authored config; Runtime = mutable state written only by CloudCode scripts) and a Bucket (Public = readable by game clients; Private = server/CloudCode only).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "TitleCustomDataDefinitions",
        "properties": {
          "Keys": {
            "type": [
              "null",
              "object"
            ],
            "description": "Schema-managed keys of the TitleCustomData store. Dictionary key is TitleCustomDataKeyDefinition.KeyID. A definition pins the key's Scope (Static/Runtime) and Bucket (Public/Private) — writes to another scope/bucket are rejected. Unregistered keys are free-form unless RejectUnregisteredKeys is true.",
            "additionalProperties": {
              "$ref": "#/definitions/TitleCustomDataKeyDefinition"
            }
          },
          "MaxKeysPerBucket": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of keys per (scope, bucket) pair — Static.Public, Static.Private, Runtime.Public, Runtime.Private. Protects the title document from unbounded growth. Recommended: 256."
          },
          "DefaultTtlSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Default TTL in seconds for unregistered keys. null means no TTL. Expired records are filtered on read and purged on the next write."
          },
          "MaxTotalSizeBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Total size limit of the whole title store (both scopes, both buckets) in bytes. Protects against MongoDB's 16 MB document limit. Recommended: 4,000,000 (~4 MB)."
          },
          "RejectUnregisteredKeys": {
            "type": "boolean",
            "description": "If true, writes to unregistered keys are rejected (strict schema mode). If false (default), unregistered keys are accepted as free-form with the default limits."
          },
          "DefaultMaxValueLengthBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Default value size limit in bytes (UTF-8) for unregistered keys. Registered keys use their own MaxValueLengthBytes. Recommended: 8192 (8 KB)."
          }
        },
        "description": "Schema and limits of the title-wide key-value store. The VALUES live in the separate TitleCustomData collection (one document per title), not in this config section. Each key declares a Scope (Static = authored config; Runtime = mutable state written only by CloudCode scripts) and a Bucket (Public = readable by game clients; Private = server/CloudCode only). Clients can never write this store."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "TitleDataScope": {
        "enum": [
          "Static",
          "Runtime"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Static",
          "Runtime"
        ],
        "x-enum-descriptions": [
          "Authored configuration. Written by the management backend (publisher dashboard, AI Coder's SaveTitleData) and cached like the rest of the title config. CloudCode can read it but never write it.",
          "Mutable title state. Written ONLY by CloudCode and always read straight from the database (never cached), so a counter read right after a write is correct."
        ]
      },
      "TitleDataBucket": {
        "enum": [
          "Public",
          "Private"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Public",
          "Private"
        ],
        "x-enum-descriptions": [
          "Readable by every player through the client TitleCustomData endpoint. Examples: event schedule, global progress, public feature flags.",
          "Never returned to clients. Server code and CloudCode scripts only. Examples: server-side thresholds, anti-fraud settings, internal counters."
        ]
      },
      "CustomDataValueType": {
        "enum": [
          "String",
          "Int",
          "Bool",
          "Json"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "String",
          "Int",
          "Bool",
          "Json"
        ],
        "x-enum-descriptions": [
          "Arbitrary string. Validated by length only.",
          "Integer. Must parse as long via long.TryParse. Returned to the client as a string.",
          "Boolean. Must be \"true\" or \"false\" (case-insensitive, via bool.TryParse).",
          "Valid JSON document. Any structure parseable via JToken.Parse. Size limited by MaxValueLengthBytes."
        ]
      },
      "TitleCustomDataKeyDefinition": {
        "type": "object",
        "properties": {
          "KeyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique key identifier across all scopes and buckets. Must not contain '.' or '$'."
          },
          "Scope": {
            "oneOf": [
              {
                "$ref": "#/definitions/TitleDataScope"
              }
            ],
            "description": "Storage scope: Static (authored config, written via the management backend / AI Coder) or Runtime (mutable state, written only by CloudCode). Fixed by config."
          },
          "Bucket": {
            "oneOf": [
              {
                "$ref": "#/definitions/TitleDataBucket"
              }
            ],
            "description": "Visibility bucket: Public (readable by game clients) or Private (server/CloudCode only). Fixed by config."
          },
          "ValueType": {
            "oneOf": [
              {
                "$ref": "#/definitions/CustomDataValueType"
              }
            ],
            "description": "Expected value format: String, Int, Bool or Json. Validated on every write. Counters used with CloudCode's IncrementTitleCustomData must be declared as Int."
          },
          "TtlSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Key TTL in seconds. null means permanent. On write the server sets ExpiresAt = now + TtlSeconds; expired records are filtered on read."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Developer-facing description of the key's purpose. Does not affect validation."
          },
          "DefaultValue": {
            "type": [
              "null",
              "string"
            ],
            "description": "Default value materialized on read when the record does not exist or has expired. Never written to the DB until an explicit write. null means absent keys stay absent."
          },
          "MaxValueLengthBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Hard value size limit in bytes (UTF-8) for this key. Overrides TitleCustomDataDefinitions.DefaultMaxValueLengthBytes."
          }
        },
        "description": "Definition of a single registered TitleCustomData key: its scope, bucket and validation rules."
      }
    },
    "additionalProperties": false
  }

  arguments 178 lines copy
• save_purchase unknown never probed

  PARTIAL SAVE: writes ONLY the 'Purchase' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Real-money in-app purchases (IAP) for Google Play and the Apple App Store. Product catalogue with per-store SKUs (StoreProductIDs), what each purchase grants (Rewards), subscription products that activate a Premium entitlement, audience gates and purchase limits, plus per-store receipt-verification settings. Distinct from Store (in-game shop paid with virtual currency) and from Premium (which describes the entitlement itself, while this describes how it is sold in the stores). Contains NO secrets: the Google service-account JSON and the App Store Server API key are referenced by TitleSecrets entry name only; the Play licensing public key and Apple root certificates are public by nature and live here.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "PurchaseDefinitions",
        "properties": {
          "Refund": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapRefundPolicy"
              }
            ],
            "description": "Default refund policy for every product of the title. A product overrides it with its own Refund block or a preset. When unset the platform defaults apply."
          },
          "Stores": {
            "type": [
              "null",
              "object"
            ],
            "description": "Per-store settings. Key = IapStore name (\"GooglePlay\" / \"AppleAppStore\" / \"TelegramStars\").",
            "additionalProperties": {
              "$ref": "#/definitions/IapStoreDefinition"
            }
          },
          "Enabled": {
            "type": "boolean",
            "description": "Master switch for the whole IAP subsystem. When false the server rejects every receipt validation regardless of per-product and per-store settings."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapPresetRegistry"
              }
            ],
            "description": "Reusable product configuration blocks (rewards and rules)."
          },
          "Products": {
            "type": [
              "null",
              "object"
            ],
            "description": "Product catalog. Key = IapProductDefinition.ProductID (OUR stable identifier, not the store SKU).",
            "additionalProperties": {
              "$ref": "#/definitions/IapProductDefinition"
            }
          },
          "Validation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapValidationSettings"
              }
            ],
            "description": "Validation rules shared by all stores."
          }
        },
        "description": "Real-money in-app purchase (IAP) configuration for Google Play and Apple App Store. Product catalog (what the player buys and receives) is separated from per-store settings (how a receipt is verified). One product can be sold in both stores under different SKUs via StoreProductIDs."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "IapStore": {
        "enum": [
          "GooglePlay",
          "AppleAppStore",
          "TelegramStars"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "GooglePlay",
          "AppleAppStore",
          "TelegramStars"
        ],
        "x-enum-descriptions": [
          "Google Play Billing (Android).",
          "Apple App Store / StoreKit (iOS, macOS, tvOS).",
          "Telegram Stars — payment in Telegram Stars (mini apps and bots). The client holds no receipt: the server creates the invoice and Telegram reports the payment to the title bot's webhook. Product price is IapProductDefinition.TelegramStarsPrice."
        ]
      },
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "IapProductType": {
        "enum": [
          "Consumable",
          "NonConsumable",
          "Subscription"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Consumable",
          "NonConsumable",
          "Subscription"
        ],
        "x-enum-descriptions": [
          "Consumable: can be bought repeatedly; each purchase grants Rewards again (currency packs, bundles).",
          "Non-consumable: granted once forever (remove ads, content unlock). Re-validating the same receipt (restore) does not grant twice but reports ownership back to the client.",
          "Subscription: activates a premium entitlement (IapSubscriptionBinding.PremiumID) for the period reported by the store. Renewals and revocations arrive via server notifications."
        ]
      },
      "IapRulesPreset": {
        "type": "object",
        "properties": {
          "Rules": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapProductRules"
              }
            ],
            "description": "Preset rules."
          }
        },
        "description": "Reusable availability rule set."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "IapProductRules": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who the product is available to — unified SegmentGate. null/empty = everyone. IMPORTANT: the gate is checked at grant time, while the player pays in the store BEFORE the server learns about the purchase, so a gated product must be hidden by the client storefront. A gate rejection is recorded in the transaction ledger for support."
          },
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Sales end (UTC). null = no expiration."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Purchase limits: TotalCap = lifetime, DailyCap = per UTC day. 0 on an axis = unlimited. Like the gate, enforced at grant time — see the warning on Gate."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Sales start (UTC). null = from the beginning."
          }
        },
        "description": "Product availability rules. An empty object means \"on sale to everyone, always\"."
      },
      "IapRefundPolicy": {
        "type": "object",
        "properties": {
          "ResourceAction": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapRefundResourceAction"
              }
            ],
            "description": "What to do with the granted resources. Unset = Keep."
          },
          "RevokeEntitlement": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Revoke entitlements: expire the premium immediately for a subscription, drop ownership for a non-consumable (ads come back, content locks). Unset = for subscriptions fall back to IapSubscriptionBinding.RevokeOnRefund (kept for already-configured titles), for other types the default is true."
          },
          "BlockFuturePurchases": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Forbid this player from buying THIS product again after a refund. Unset = false. Enforced where purchase limits are — at grant time — so the player pays in the store and gets a rejection recorded in the ledger. Pair it with a storefront that hides the blocked product (the flag is reported in IapProductAvailability)."
          }
        },
        "description": "What the platform does when a purchase is refunded. Every field is nullable on purpose: the merge rule is \"unset = inherit from the level above, set = final, including false\". Read these fields only through IapRefundDefaults. Priority: product → product preset → title-level PurchaseDefinitions.Refund → platform default."
      },
      "IapRefundPreset": {
        "type": "object",
        "properties": {
          "Refund": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapRefundPolicy"
              }
            ],
            "description": "Preset refund policy."
          }
        },
        "description": "Reusable refund policy."
      },
      "IapRewardPreset": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Preset rewards."
          }
        },
        "description": "Reusable purchase reward set."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "IapPresetRegistry": {
        "type": "object",
        "properties": {
          "Rules": {
            "type": [
              "null",
              "object"
            ],
            "description": "Rule presets. Key = PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/IapRulesPreset"
            }
          },
          "Refund": {
            "type": [
              "null",
              "object"
            ],
            "description": "Refund policy presets. Key = PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/IapRefundPreset"
            }
          },
          "Rewards": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reward presets. Key = PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/IapRewardPreset"
            }
          }
        },
        "description": "Registry of reusable IAP product blocks. Same purpose as Character/Leaderboard presets: a rule is described once and reused by many products."
      },
      "IapProductPresets": {
        "type": "object",
        "properties": {
          "Rules": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Rules preset (IapPresetRegistry.Rules). Merged FIELD-WISE: preset is the base, inline product fields override it, and PresetBinding.Remove drops preset fields by name (\"StartUtc\", \"EndUtc\", \"Gate\", \"Limits\")."
          },
          "Refund": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Refund policy preset (IapPresetRegistry.Refund). Merged FIELD-WISE like Rules: preset is the base, inline product fields override it, and PresetBinding.Remove drops preset fields by name (\"ResourceAction\", \"RevokeEntitlement\", \"BlockFuturePurchases\")."
          },
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Rewards preset (IapPresetRegistry.Rewards). Whole-block: if the product has its own Rewards it wins and the preset is not merged (a reward grant has no key to merge by)."
          }
        },
        "description": "Product references to reusable blocks. Resolved by PurchaseConfigResolver on the engine side; a non-existent PresetID is treated as \"no preset\" and never throws."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "IapStoreDefinition": {
        "type": "object",
        "properties": {
          "KeyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Apple App Store Server API: Key ID of the issued key. Not a secret."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Accepting purchases from this store is enabled."
          },
          "StoreID": {
            "oneOf": [
              {
                "$ref": "#/definitions/IapStore"
              }
            ],
            "description": "Store identifier; must match the key in PurchaseDefinitions.Stores."
          },
          "IssuerID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Apple App Store Server API: Issuer ID from App Store Connect. Not a secret. The signing private key (.p8) is addressed via SecretName."
          },
          "SecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding the store's shared secret: the Google Play service-account JSON (Play Developer API access) or the App Store shared secret. The value itself is never stored here and never leaves the server."
          },
          "PackageName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Android package name (com.example.game) or iOS bundle ID. Compared against the value inside the receipt when IapValidationSettings.RequirePackageMatch is on."
          },
          "PlayPublicKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Google Play: the app's RSA licensing public key (base64 from Play Console, \"Licensing & in-app billing\"). Public by nature — it verifies the receipt signature and cannot be used to forge one. Required by the LocalSignature mode."
          },
          "VerificationMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/IapVerificationMode"
              }
            ],
            "description": "Receipt verification mode."
          },
          "AcknowledgePurchases": {
            "type": "boolean",
            "description": "GOOGLE ONLY. Acknowledge the purchase in the store after granting rewards (acknowledge / consume). Without acknowledgement Google auto-refunds after three days. Requires the networked verification mode or separately configured Play Developer API access. There is nothing to acknowledge on Apple — the client closes the transaction through StoreKit and the server takes no part in it, so the value is IGNORED for the Apple store."
          },
          "NotificationPackageName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Expected package in this store's server notifications. Empty = use PackageName. A separate field is needed by titles whose notifications arrive from a different package (e.g. after an app migration)."
          },
          "RequireCertificateChain": {
            "type": "boolean",
            "description": "Require a full certificate chain up to the Apple root (built into the platform, not configurable). false verifies only the leaf signature — acceptable on a test bench, but in production it means \"accept a receipt signed by anyone\"."
          }
        },
        "description": "Per-store settings: how a receipt is verified and how a purchase is acknowledged."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "IapVerificationMode": {
        "enum": [
          "LocalSignature",
          "SignedTransaction",
          "StoreServer",
          "LegacyReceipt",
          "Unverified"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "LocalSignature",
          "SignedTransaction",
          "StoreServer",
          "LegacyReceipt",
          "Unverified"
        ],
        "x-enum-descriptions": [
          "Google Play: the receipt's RSA signature is checked against the licensing public key (IapStoreDefinition.PlayPublicKey). No network, no quotas, no secrets. Blind to refunds and revocations — those arrive via server notifications.",
          "Apple: StoreKit 2 signed transaction (JWS ES256 with an x5c chain up to the Apple root). No network. Like LocalSignature, it does not see refunds by itself.",
          "Call the store's server API: Google Play Developer API (purchases.products.get / purchases.subscriptionsv2.get) or Apple App Store Server API. The most authoritative answer (sees refunds, revocations, current subscription status) but depends on third-party availability and quotas.",
          "Apple: legacy verifyReceipt (base64 app receipt). Deprecated by Apple; kept for StoreKit 1 titles that have not moved to signed transactions.",
          "Verification disabled: the receipt is accepted as-is. FOR TEST BENCHES AND DEBUGGING ONLY — in this mode any player can grant themselves any product. The server marks every such purchase in the transaction ledger."
        ]
      },
      "IapProductDefinition": {
        "type": "object",
        "properties": {
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name shown in the client / admin."
          },
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/IapProductType"
              }
            ],
            "description": "Product type: consumable, non-consumable or subscription."
          },
          "Rules": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapProductRules"
              }
            ],
            "description": "Product availability rules: sales window, audience gate, purchase limits."
          },
          "Refund": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapRefundPolicy"
              }
            ],
            "description": "What to do when the store refunds this product to the player. Unset = fall back to PurchaseDefinitions.Refund and then to the platform default. Read it only through IapRefundDefaults."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Product is on sale. false = withdrawn (validating old receipts is still possible for non-consumable restore)."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapProductPresets"
              }
            ],
            "description": "References to reusable blocks in PurchaseDefinitions.Presets."
          },
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "What the player receives on purchase. For Subscription products this is the welcome grant on first activation; renewals are handled by IapSubscriptionBinding.RenewalRewards. Premium mechanics (PremiumBonuses / PremiumTiers) apply as everywhere else."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Our stable product identifier. Never change after publication — player purchase counters and transaction ledger entries reference it."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Product assets (icon, banner). Key = asset slug, value = path or URL.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Free-form product parameters for game code (e.g. \"BadgeText\", \"SortOrder\"). Not interpreted by the platform.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Subscription": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IapSubscriptionBinding"
              }
            ],
            "description": "Premium subscription binding. Required for Subscription products, ignored otherwise."
          },
          "PriceUsdCents": {
            "type": "integer",
            "format": "int64",
            "description": "Declared price in USD cents — for analytics and default storefront display ONLY. The amount actually paid comes from the receipt; the server never treats this field as the source of truth about a payment."
          },
          "StoreProductIDs": {
            "type": [
              "null",
              "object"
            ],
            "description": "Product SKU per store. Key = IapStore name, value = the STORE-side product identifier (Google Play product ID / Apple product identifier). The server maps a receipt to our product through this dictionary: SKU inside the receipt → ProductID. Duplicate SKUs across products are not allowed.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "TelegramStarsPrice": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Price in Telegram Stars (XTR, whole number). Unlike other stores WE set this price: the server issues the invoice and Telegram charges exactly this amount, so the field is the source of truth about the payment and the amount in the payment update is checked against it. Unset or not positive = the product is not sold in Telegram."
          }
        },
        "description": "Definition of a single real-money product."
      },
      "IapValidationSettings": {
        "type": "object",
        "properties": {
          "AllowSandbox": {
            "type": "boolean",
            "description": "Accept sandbox / test-track purchases. Usually false in production: the sandbox issues genuine receipts for zero payment."
          },
          "MaxPurchaseAgeDays": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum purchase age in days still accepted for a FIRST grant. 0 = unlimited. Guards against replaying a year-old receipt onto a fresh account; does not affect non-consumable restore (which confirms ownership without granting)."
          },
          "MaxReceiptsPerBatch": {
            "type": "integer",
            "format": "int32",
            "description": "How many receipts one ValidatePurchasesBatch (restore) call accepts. Clamped by the platform BatchSupport.MaxBatchSize. 0 = platform default."
          },
          "RequirePackageMatch": {
            "type": "boolean",
            "description": "Require the package name / bundle ID inside the receipt to match IapStoreDefinition.PackageName. Disable only during a package migration."
          },
          "RefundCheckHorizonDays": {
            "type": "integer",
            "format": "int32",
            "description": "For how many days after a purchase the platform keeps asking Apple whether it was refunded. 0 = always ask. Apple ONLY: there refunds are discovered with a per-customer request, so a long-time payer is polled forever, while Google has no per-player refund query at all and uses one app-wide pass whose cost does not depend on the player count. The trade-off: a refund issued after the horizon is never seen. Do not set it below 90 days — that is the usual window for Apple billing disputes."
          },
          "RejectCrossUserReceipts": {
            "type": "boolean",
            "description": "Reject a receipt whose TransactionID was already granted to ANOTHER player. true is the standard behavior; the flag exists for titles where account merging makes moving a purchase between UserIDs a normal operation."
          }
        },
        "description": "Receipt validation rules shared by all stores."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "IapSubscriptionBinding": {
        "type": "object",
        "properties": {
          "PremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "PremiumID in cfg.Premium.Definitions activated by this subscription. A Subscription product without a valid PremiumID would charge the player and grant nothing."
          },
          "RenewalRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "What to grant on EACH renewal (monthly subscriber bonus). null = entitlement only, no resources. Renewals arrive via store server notifications."
          },
          "RevokeOnRefund": {
            "type": "boolean",
            "description": "Revoke the premium entitlement on refund/revoke notifications. true = the subscription is expired immediately; false = the entitlement lives out the paid period (kinder to the player, costlier for the economy)."
          },
          "FallbackDurationDays": {
            "type": "integer",
            "format": "int32",
            "description": "Duration in days used when the store did not report an expiration date. 0 = fall back to PremiumDefinition.DurationDays. The normal path is expiresDate from the receipt — that is the truth about the period."
          }
        },
        "description": "Link between an IAP product and a platform premium subscription. Activation writes into UserDataDocument.Premium.Subscriptions[PremiumID] — the same container used by Premium.PurchaseWithResources and ActivateTrial, so every premium gate works with IAP subscriptions unchanged."
      },
      "IapRefundResourceAction": {
        "enum": [
          "Keep",
          "Clawback",
          "ClawbackForce"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Keep",
          "Clawback",
          "ClawbackForce"
        ],
        "x-enum-descriptions": [
          "Take nothing back — only mark the refund in the ledger and (if configured) revoke the entitlement. This is how the platform behaved historically and remains the default.",
          "Claw back what was granted but never below the floor: only the remaining amount is deducted. If the player spent everything, nothing is deducted and the operation still succeeds. Safe: inventory invariants stay intact.",
          "Claw back the full amount, allowing the currency balance to go below CurrencyDefinition.Economy.MinBalance — including negative. The debt is paid off by later grants: while the balance is negative the player effectively receives nothing. Applies to CURRENCIES only — items have no negative quantity and are always deducted up to what is present. Also drops the race guard on the deduction, since the point of the mode is that it goes through regardless of the balance."
        ]
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      }
    },
    "additionalProperties": false
  }

  arguments 1169 lines copy
• save_localization unknown never probed

  PARTIAL SAVE: writes ONLY the 'Localization' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Localization SETTINGS — which locales the title offers, which one is the default (and therefore the fallback), what to render for a missing key, and the store limits. The translation TABLES are deliberately NOT here: they live in the separate TitleLocalization collection (one document per title+locale) and are delivered one file per locale, because text changes far more often than balance and must not invalidate the whole title config. Client resolution is t(x) = own table -> fallback table -> x itself, which is why a title whose DisplayName fields hold literal names keeps working unchanged: a literal is simply a key with no translation. Add or edit translations through the Localization endpoints, not through this section.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "LocalizationDefinitions",
        "properties": {
          "Locales": {
            "type": [
              "null",
              "object"
            ],
            "description": "Locales offered to the player, keyed by canonical locale code (\"en\", \"pt-br\"). The same code becomes part of the table document _id and of the CDN object key.",
            "additionalProperties": {
              "$ref": "#/definitions/LocalizationLocaleDefinition"
            }
          },
          "IsEnabled": {
            "type": "boolean",
            "description": "Master switch. When false the server serves neither the manifest nor any table, and the client renders the config strings as-is."
          },
          "DefaultLocale": {
            "type": [
              "null",
              "string"
            ],
            "description": "Default locale, which is also the FALLBACK: its table is what the client additionally downloads when its own locale is not fully translated. Stored canonically (lower-case, '-' separator). Empty means \"en\"."
          },
          "MissingKeyMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/LocalizationMissingKeyMode"
              }
            ],
            "description": "What the client renders when a key is missing from both its own and the fallback table."
          },
          "MaxEntriesPerLocale": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of entries in a SINGLE locale table. Guards the document against unbounded growth (BSON's 16 MB ceiling) and the importer against an accidentally uploaded foreign file. Recommended: 20000."
          },
          "MaxValueLengthBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Length limit of a single translation in bytes (UTF-8). Long-form text (rules, licences) belongs in TitleCustomData, not here. Recommended: 4096."
          }
        },
        "description": "Localization settings of the title. The translation TABLES are not stored here: they live in the separate TitleLocalization collection (one document per title+locale) and are delivered one file per locale. This section only declares which locales exist, which one is the fallback, and the store limits."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LocalizationMissingKeyMode": {
        "enum": [
          "ReturnKey",
          "ReturnMarkedKey",
          "ReturnEmpty"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ReturnKey",
          "ReturnMarkedKey",
          "ReturnEmpty"
        ],
        "x-enum-descriptions": [
          "Render the key itself. This is the default, and it is what keeps titles whose config holds literal names (rather than keys) working unchanged.",
          "Render the key wrapped in markers (⟦quest.daily.title⟧) — proofreading mode: gaps are visible on screen instead of in a report.",
          "Render an empty string. Appropriate when blank space is preferable to a technical string on top of finished artwork."
        ]
      },
      "LocalizationLocaleDefinition": {
        "type": "object",
        "properties": {
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Order in the picker. Ties are broken by locale code."
          },
          "Locale": {
            "type": [
              "null",
              "string"
            ],
            "description": "Canonical locale code — a readability mirror of the dictionary key. It does not affect resolution: the dictionary key is the identifier, as in every other config section."
          },
          "IsEnabled": {
            "type": "boolean",
            "description": "When false the language is hidden from the picker and not served, but its table is kept. This is how a language is switched off while it is being translated, without discarding the translator's work."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Language name written IN THAT LANGUAGE (\"Русский\", \"Deutsch\") — an endonym, not a translation: the picker is read by someone who may not know the current language. Localizing it through the table itself would be circular, so it lives in the config."
          }
        },
        "description": "A single entry of the available-languages list. It exists so the game can draw the language picker BEFORE any table has been downloaded."
      }
    },
    "additionalProperties": false
  }

  arguments 110 lines copy
• save_advertising unknown never probed

  PARTIAL SAVE: writes ONLY the 'Advertising' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Advertising — logical ad Placements (rewarded video, interstitial, banner, app-open), the mediation Providers that serve them (AppLovin MAX, LevelPlay, ...) with per-platform app IDs and ad unit IDs, per-format settings, frequency capping, premium ad-removal perks, GDPR/ATT consent policy, rewarded-video server-side verification (SSV) and the daily revenue import from the provider's Reporting API. Shared secrets (SSV keys, report keys) are NOT stored here — only the NAME of the TitleSecrets entry that holds them.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "AdvertisingDefinitions",
        "properties": {
          "Banner": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BannerSettings"
              }
            ],
            "description": "Global banner settings."
          },
          "AppOpen": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AppOpenSettings"
              }
            ],
            "description": "Global app-open ad settings."
          },
          "Consent": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AdConsentSettings"
              }
            ],
            "description": "Regulatory consent settings (GDPR / CCPA / PIPL)."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Master switch for the whole advertising system. When false the server rejects every ad permit/impression request regardless of per-placement settings."
          },
          "Providers": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ad SDK provider configuration. Key is AdProviderDefinition.ProviderID (e.g. \"applovin\").",
            "additionalProperties": {
              "$ref": "#/definitions/AdProviderDefinition"
            }
          },
          "Reporting": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AdReportingSettings"
              }
            ],
            "description": "LEGACY single-provider report import, kept for back-compat (it predates multi-provider support and describes AppLovin only). Per-provider settings live in AdProviderDefinition.Reporting and win; this block is consulted only when a provider has none AND its Kind is AppLovinMax. Resolution lives in AdReportingDefaults.EffectiveFor."
          },
          "Placements": {
            "type": [
              "null",
              "object"
            ],
            "description": "Catalog of logical ad placements. Key is AdPlacementDefinition.PlacementID.",
            "additionalProperties": {
              "$ref": "#/definitions/AdPlacementDefinition"
            }
          },
          "CreditSinks": {
            "type": [
              "null",
              "object"
            ],
            "description": "Catalog of places where the player may SPEND RewardedVideoCredit. Key is AdCreditSinkDefinition.SinkID. Normally the credit is spent by the very operation it pays for and needs no sink; this catalog is for spends whose mechanic is entirely client-side and therefore has no server operation of its own (ability reroll inside a run, continue-after-death, skipping an offline timer). Cost and limits come from config, not from the client: the client only names the sink.",
            "additionalProperties": {
              "$ref": "#/definitions/AdCreditSinkDefinition"
            }
          },
          "Interstitial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/InterstitialSettings"
              }
            ],
            "description": "Global interstitial settings."
          },
          "Verification": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AdVerificationSettings"
              }
            ],
            "description": "Server-side verification (SSV) settings for rewarded video."
          },
          "RewardedVideo": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardedVideoSettings"
              }
            ],
            "description": "Global rewarded-video settings shared by all rewarded placements."
          },
          "FrequencyCapping": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AdFrequencyCappingSettings"
              }
            ],
            "description": "Global frequency caps applied on top of per-placement and per-format limits."
          },
          "PremiumAdReductions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumAdReduction"
            },
            "description": "Premium perks that disable ad formats for subscribers. Single best matching tier wins, no stacking (standard PremiumTierModifier selection)."
          },
          "MaxClientRevenueMicrosPerImpression": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on client-reported revenue per single impression, in micro-USD (1 USD = 1000000). Anything above is clamped and flagged. Client-side revenue can be forged, and one player could otherwise poison the report the publisher buys traffic on. Default 5000000 ($5) is generous for a real impression. 0 disables clamping (test stands only)."
          }
        },
        "description": "Title-level advertising configuration: placements, SDK providers, per-format settings, frequency capping, premium ad reductions, consent and rewarded-video server-side verification."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "AdType": {
        "enum": [
          "Banner",
          "Interstitial",
          "RewardedVideo",
          "RewardedInterstitial",
          "AppOpen",
          "Native"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Banner",
          "Interstitial",
          "RewardedVideo",
          "RewardedInterstitial",
          "AppOpen",
          "Native"
        ],
        "x-enum-descriptions": [
          "Persistent banner ad.",
          "Full-screen ad that interrupts gameplay.",
          "Rewarded video: watched to completion, grants the player a reward.",
          "Hybrid of interstitial and rewarded: shown like an interstitial but grants a reward when watched to completion.",
          "Ad shown when the app returns from background.",
          "Native ad embedded into the game UI."
        ]
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "AdUnitConfig": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/AdType"
              }
            ],
            "description": "Expected format of this ad unit. Must match the placement's Type; the server validates this when issuing a permit."
          },
          "IosUnitID": {
            "type": [
              "null",
              "string"
            ],
            "description": "iOS ad unit ID."
          },
          "WebUnitID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Web ad unit ID."
          },
          "AndroidUnitID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Android ad unit ID."
          }
        },
        "description": "One ad unit: platform-specific IDs for a given placement at a given provider."
      },
      "AdProviderKind": {
        "enum": [
          "AppLovinMax",
          "LevelPlay"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AppLovinMax",
          "LevelPlay"
        ],
        "x-enum-descriptions": [
          "AppLovin MAX: the publisher composes the callback URL from macros, signature is sha1(EVENT_ID + Event Key), the response body is ignored.",
          "Unity LevelPlay (formerly ironSource): the provider composes the callback URL with its own fixed parameter names, signature is md5(timestamp+eventId+userId+rewards+privateKey), and the response must carry an acknowledgement body or the callback is retried."
        ]
      },
      "BannerPosition": {
        "enum": [
          "Top",
          "Bottom",
          "Left",
          "Right"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Top",
          "Bottom",
          "Left",
          "Right"
        ]
      },
      "BannerSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Banner switch, applied on top of the master Advertising.Enabled switch."
          },
          "Position": {
            "oneOf": [
              {
                "$ref": "#/definitions/BannerPosition"
              }
            ],
            "description": "Banner position on screen."
          },
          "PermitTtlSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Banner permit lifetime in seconds; default 6 hours. Separate from the shared TTL because a banner lives for the whole session and keeps reporting against its permit, while a fullscreen ad is done in a minute."
          },
          "RefreshIntervalSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Banner auto-refresh interval in seconds. Typical range 30-60."
          },
          "MaxImpressionsPerMinute": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum banner impressions the server accepts per minute of permit lifetime. A banner physically refreshes no faster than RefreshIntervalSeconds, so anything well above that rate is fabricated by the client. 0 disables the check."
          }
        },
        "description": "Global banner settings."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "AppOpenSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "App-open switch, applied on top of the master Advertising.Enabled switch."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum interval between app-open impressions, in seconds."
          },
          "DailyImpressionCap": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum app-open impressions per UTC day. 0 = unlimited."
          }
        },
        "description": "App-open ad settings (shown when the app returns from background)."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "AdCallbackAckMode": {
        "enum": [
          "AckAcceptedOnly",
          "AckAlways"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AckAcceptedOnly",
          "AckAlways"
        ],
        "x-enum-descriptions": [
          "Acknowledge only ACCEPTED callbacks. A rejected one keeps being retried, which surfaces a wrong key in the provider's own dashboard instead of silently dropping rewards. Cost: retry traffic while the key is wrong, and the response differs between a valid and an invalid callback.",
          "Acknowledge EVERYTHING, including rejected callbacks. No retries and no observable difference between a valid and an invalid callback. Cost: the provider's dashboard looks healthy, so a wrong key is only visible in our own AdEventLog (InvalidSignature outcome)."
        ]
      },
      "AdConsentSettings": {
        "type": "object",
        "properties": {
          "RegulatedRegions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "ISO country codes where consent collection is mandatory. Outside this list ads run under legitimate interest."
          },
          "CurrentPolicyVersion": {
            "type": [
              "null",
              "string"
            ],
            "description": "Current privacy-policy version. Bumping it invalidates previously stored consents and forces a re-prompt."
          },
          "RequireTrackingConsent": {
            "type": "boolean",
            "description": "Whether explicit tracking consent is required (ATT prompt on iOS)."
          },
          "RequirePersonalizedAdsConsent": {
            "type": "boolean",
            "description": "Whether explicit consent for personalized ads is required."
          }
        },
        "description": "Regulatory consent settings (GDPR / CCPA / PIPL)."
      },
      "AdSsvSignatureMode": {
        "enum": [
          "EventToken",
          "EventTokenAll"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "EventToken",
          "EventTokenAll"
        ]
      },
      "PremiumAdReduction": {
        "type": "object",
        "properties": {
          "DisableAppOpen": {
            "type": "boolean",
            "description": "Disable app-open ads for subscribers of this tier."
          },
          "DisableBanners": {
            "type": "boolean",
            "description": "Disable banners for subscribers of this tier."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          },
          "DisableInterstitials": {
            "type": "boolean",
            "description": "Disable interstitials for subscribers of this tier."
          }
        },
        "description": "Premium perk that disables ad formats for subscribers. Enforced server-side before a permit is issued. Single best matching tier wins, no stacking."
      },
      "AdReportingSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether report import is enabled for this title."
          },
          "SecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding the provider's Report Key. The key is PER TITLE, not per publisher: one publisher may hold several mediation accounts. The value is never exposed."
          },
          "RevisionWindowDays": {
            "type": "integer",
            "format": "int32",
            "description": "How many recent days to re-pull on every import. The provider keeps revising a closed day for several days, so a one-shot import would freeze an unrevised number forever. Default 4."
          }
        },
        "description": "Daily import of revenue from the provider's Reporting API. This is the only source that matches the actual payout; it arrives a day late and keeps being revised for a few more days, so the import re-pulls a window of recent days rather than just yesterday."
      },
      "AdProviderDefinition": {
        "type": "object",
        "properties": {
          "Kind": {
            "oneOf": [
              {
                "$ref": "#/definitions/AdProviderKind"
              }
            ],
            "description": "Mediation vendor; selects the SSV verification algorithm and the report-import strategy. Absent = AppLovinMax."
          },
          "Units": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ad unit IDs per placement. Key is AdPlacementDefinition.PlacementID.",
            "additionalProperties": {
              "$ref": "#/definitions/AdUnitConfig"
            }
          },
          "Enabled": {
            "type": "boolean",
            "description": "Per-provider switch."
          },
          "IosAppID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Provider app ID for the iOS build."
          },
          "Priority": {
            "type": "integer",
            "format": "int32",
            "description": "Provider priority in mediation. Higher value = higher priority in the client SDK waterfall."
          },
          "WebAppID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Provider app ID for the Web build."
          },
          "Reporting": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AdProviderReportingSettings"
              }
            ],
            "description": "Report-import settings for this provider. Absent = fall back to the root Advertising.Reporting, and only for AppLovinMax. Resolved by AdReportingDefaults.EffectiveFor."
          },
          "ProviderID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique provider identifier within the title (e.g. \"applovin\")."
          },
          "AndroidAppID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Provider app ID for the Android build."
          }
        },
        "description": "Configuration of one ad SDK provider (AppLovin MAX, LevelPlay, AdMob, ...)."
      },
      "InterstitialSettings": {
        "type": "object",
        "properties": {
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum interval between interstitial impressions, in seconds, on top of the per-placement cooldown."
          },
          "DailyImpressionCap": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum interstitial impressions per UTC day. 0 = unlimited."
          },
          "MaxImpressionsPerSession": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum interstitial impressions per session. 0 = unlimited."
          },
          "MinSessionTimeBeforeFirstSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "How many seconds from session start interstitials are suppressed, protecting the first minutes of gameplay."
          }
        },
        "description": "Global interstitial settings."
      },
      "AdPlacementDefinition": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/AdType"
              }
            ],
            "description": "Ad format type of this placement."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Per-placement switch."
          },
          "PlacementID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique placement identifier. Used as the key in Advertising.Placements and in the player's Advertising.Placements. Must not contain '.' or '$'."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum interval between impressions of this placement, in seconds. Checked against the player's LastShownAt. 0 = no cooldown."
          },
          "CreditsRewarded": {
            "type": "integer",
            "format": "int64",
            "description": "Base amount of RewardedVideoCredit granted per verified view on this placement. Meaningful only for RewardedVideo and RewardedInterstitial; ignored otherwise."
          },
          "AllowedProviderIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Provider whitelist for this placement. null or empty means every enabled provider is allowed."
          },
          "DailyImpressionCap": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum impressions of this placement per UTC day. 0 = unlimited."
          }
        },
        "description": "One logical ad placement. Concrete SDK ad units are bound through AdProviderDefinition.Units keyed by the same PlacementID."
      },
      "RewardedVideoSettings": {
        "type": "object",
        "properties": {
          "DailyViewCap": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum rewarded views per UTC day across all placements. 0 = unlimited."
          },
          "MaxCreditsBalance": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum RewardedVideoCredit balance a single player may accumulate. 0 = unlimited."
          },
          "DailyCreditEarnCap": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum credits a player may earn per UTC day. 0 = unlimited."
          },
          "DefaultCreditsPerView": {
            "type": "integer",
            "format": "int64",
            "description": "Default credit reward used when the placement's CreditsRewarded is 0."
          },
          "MinSecondsBetweenViews": {
            "type": "integer",
            "format": "int32",
            "description": "Global minimum interval between rewarded views of different placements. Prevents bypassing per-placement cooldowns by switching placements."
          }
        },
        "description": "Global rewarded-video settings, shared by every rewarded placement."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "AdCreditSinkDefinition": {
        "type": "object",
        "properties": {
          "Cost": {
            "type": "integer",
            "format": "int64",
            "description": "How many credits one unit costs. Anything below 1 is treated as 1: there is no free sink, that would be a mere counter."
          },
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who the sink is available to. null/empty = everyone. Unified platform gate — resolved by SegmentGateEvaluator.Passes."
          },
          "SinkID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Sink identifier — also the key in Advertising.CreditSinks and in the player's counters. Must not contain '.' or '$': it becomes a path inside the Mongo document."
          },
          "Enabled": {
            "type": "boolean",
            "description": "A disabled sink answers with a denial but stays in the config."
          },
          "DailyLimit": {
            "type": "integer",
            "format": "int32",
            "description": "How many times per UTC day this sink may be spent. 0 = unlimited."
          },
          "SessionLimit": {
            "type": "integer",
            "format": "int32",
            "description": "How many times per game session this sink may be spent. 0 = unlimited."
          },
          "MaxUnitsPerRequest": {
            "type": "integer",
            "format": "int32",
            "description": "How many units one request may spend. A larger request is clamped, not rejected."
          }
        },
        "description": "One place where RewardedVideoCredit is spent (see AdvertisingDefinitions.CreditSinks). The server guarantees only that the credit is debited exactly once and within the configured limits; it cannot deliver what was paid for, because the mechanic is client-side. Use for conveniences (reroll, continue, speed-up), never as the gate to server-side value — that must be paid for by the operation that grants it."
      },
      "AdVerificationSettings": {
        "type": "object",
        "properties": {
          "SignatureMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/AdSsvSignatureMode"
              }
            ],
            "description": "AppLovin ONLY. Which provider token to verify. EventToken (default) is sha1(EVENT_ID + key) as documented; EventTokenAll covers every callback parameter but its canonical string must be confirmed against a live callback before enabling. Providers of other Kinds have a single documented scheme and ignore this field."
          },
          "RejectedCallbackAck": {
            "oneOf": [
              {
                "$ref": "#/definitions/AdCallbackAckMode"
              }
            ],
            "description": "What to answer a callback that FAILED signature verification. Only meaningful for vendors that require an acknowledgement body (LevelPlay); AppLovin ignores the body. Default AckAcceptedOnly."
          },
          "SecretNameByProvider": {
            "type": [
              "null",
              "object"
            ],
            "description": "Name of the TitleSecrets entry holding the provider's shared secret (e.g. AppLovin Event Key). Key is ProviderID, value is the secret NAME such as \"APPLOVIN_EVENT_KEY\". The secret value itself is never stored here and never leaves the server.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "PendingRequestTtlSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Pending request TTL in seconds; after it expires the request can no longer be confirmed. Typical range 60-180."
          },
          "MaxPendingRequestsPerUser": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum concurrent pending requests per player. Guards the player document against pending-request flooding."
          },
          "ClientGrantFallbackSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "How many seconds to wait for the SSV callback after the client reports completion before granting the reward without it. 0 (default) = never grant without SSV. Only meaningful when RequireServerSideVerification is true; a late callback is idempotent and never double-grants."
          },
          "RequireServerSideVerification": {
            "type": "boolean",
            "description": "Whether SSV confirmation is required before crediting the player. When false the client's own completion report is trusted (test/dev mode)."
          }
        },
        "description": "Server-side verification (SSV) settings for rewarded video. Only shared-secret providers are supported (AppLovin MAX, Unity LevelPlay); the secret lives in TitleSecrets and is referenced by name only."
      },
      "AdFrequencyCappingSettings": {
        "type": "object",
        "properties": {
          "MaxImpressionsPerDay": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum ad impressions per UTC day. 0 = unlimited."
          },
          "MaxImpressionsPerHour": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum ad impressions per hour. 0 = unlimited."
          },
          "MaxImpressionsPerSession": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum ad impressions per game session. 0 = unlimited."
          }
        },
        "description": "Global ad frequency caps counted across all formats, applied on top of per-placement and per-format limits."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "AdProviderReportingSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether report import is enabled for this provider."
          },
          "SecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding the primary reporting credential: AppLovin Report Key, or LevelPlay Secret Key. The value is never exposed."
          },
          "RevisionWindowDays": {
            "type": "integer",
            "format": "int32",
            "description": "How many recent days to re-pull on every import. 0 = inherit the root Advertising.Reporting.RevisionWindowDays."
          },
          "RefreshTokenSecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding the SECOND credential, for vendors that need a pair. LevelPlay Refresh Token; unused for AppLovin."
          }
        },
        "description": "Report-import settings for ONE provider; overrides the root Advertising.Reporting where present. A separate block is required because vendors need a different number of credentials: AppLovin authenticates with a single Report Key, LevelPlay with a PAIR (Secret Key + Refresh Token) exchanged for a bearer token."
      }
    },
    "additionalProperties": false
  }

  arguments 943 lines copy
• get_authentication unknown never probed

  GET ONLY the 'Authentication' field of TitlePublicConfigurationModel. Authentication — which third-party sign-in methods the title offers and the public OAuth client IDs each platform build needs (currently Google: Web / Android / iOS / Desktop client IDs). Contains NO secrets: OAuth client IDs are public by protocol design, and none of the sign-in flows uses a client secret. Device / e-mail / Telegram / SSO logins need no configuration and are absent from this section. The ID-token audience differs per platform (web and Android tokens carry the Web client ID, iOS tokens the iOS client ID), so several IDs are filled at once and the server accepts any of them.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_feature_tracking unknown never probed

  GET ONLY the 'FeatureTracking' field of TitlePublicConfigurationModel. Feature tracking — which CONCRETE actions are recorded as their own line in the player's FeatureUsage, on top of the default per-module tracking. Entries look like "Character:EquipItems" (module name from the route + the module's action name). Purely an analytics setting: it makes those actions selectable as steps in custom funnels (Analytics → Funnels). Tracking starts when an action is added — there is no data for the past, because the action was not recorded then. Capped at 40 entries: every tracked id becomes a key in the player document, which is read on every request.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• list_my_titles unknown never probed

  List the games (Titles) this connection may work with: TitleID, name, publication status and the permissions granted on each — call it first when the user names a game or says "my game", then pass its TitleID as title_id to the other tools. A game's sandbox copy is a separate Title (DevTitleID) with its own permissions (DevAccess); an empty Access means the live game itself is not granted. Filter by name or id with "search"; long lists are paged (skip/limit, HasMore). Read-only; takes no title_id.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "properties": {
      "skip": {
        "type": "integer",
        "description": "How many games to skip (paging). Default 0."
      },
      "limit": {
        "type": "integer",
        "description": "Page size, default 50, max 60."
      },
      "search": {
        "type": "string",
        "description": "Optional substring of the game's name or TitleID."
      }
    },
    "additionalProperties": false
  }

  arguments 18 lines copy
• get_image_data unknown never probed

  GET ONLY the 'ImageData' field of TitlePublicConfigurationModel. Dictionary<string,string> of arbitrary named image asset URLs/paths for the Title — splash screens, banners, icons, loading screens, marketing art. Key is a project-defined slug (e.g. "main_banner", "login_bg"), value is a URL or storage path. For per-currency icons use Currency.VirtualCurrencies[].AssetPaths; for per-item icons use Item; for character art use Character.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_image_data unknown never probed

  PARTIAL SAVE: writes ONLY the 'ImageData' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Dictionary<string,string> of arbitrary named image asset URLs/paths for the Title — splash screens, banners, icons, loading screens, marketing art. Key is a project-defined slug (e.g. "main_banner", "login_bg"), value is a URL or storage path. For per-currency icons use Currency.VirtualCurrencies[].AssetPaths; for per-item icons use Item; for character art use Character.

  mcp-tool

  12345678910111213141516171819202122

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "DictionaryOfStringAndString",
        "description": "New value for the ImageData field.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 22 lines copy
• get_asset_bundle unknown never probed

  GET ONLY the 'AssetBundle' field of TitlePublicConfigurationModel. Dictionary<string,string> of named bundle/manifest URLs (Unity AssetBundles, Addressables manifests, etc.). Key is a logical bundle slug, value is its CDN URL. Use this for binary game content; for images alone use ImageData.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_asset_bundle unknown never probed

  PARTIAL SAVE: writes ONLY the 'AssetBundle' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Dictionary<string,string> of named bundle/manifest URLs (Unity AssetBundles, Addressables manifests, etc.). Key is a logical bundle slug, value is its CDN URL. Use this for binary game content; for images alone use ImageData.

  mcp-tool

  12345678910111213141516171819202122

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "DictionaryOfStringAndString",
        "description": "New value for the AssetBundle field.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 22 lines copy
• get_cloud_code unknown never probed

  GET ONLY the 'CloudCode' field of TitlePublicConfigurationModel. Server-side scripting (CloudCode): the active JavaScript revision the title runs, plus execution policy — engine limits, rate limits, per-handler metadata, whether logs/stack traces are revealed to clients. Scripts are the ONLY way to write protected player data (UserCustomData ReadOnly/Internal buckets) and mutable title data (TitleCustomData Runtime scope). Prefer the dedicated cloud-code tools over editing this section by hand: they compute the code hash, bump the revision number and archive the previous one.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_feature_tracking unknown never probed

  PARTIAL SAVE: writes ONLY the 'FeatureTracking' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Feature tracking — which CONCRETE actions are recorded as their own line in the player's FeatureUsage, on top of the default per-module tracking. Entries look like "Character:EquipItems" (module name from the route + the module's action name). Purely an analytics setting: it makes those actions selectable as steps in custom funnels (Analytics → Funnels). Tracking starts when an action is added — there is no data for the past, because the action was not recorded then. Capped at 40 entries: every tracked id becomes a key in the player document, which is read on every request.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "FeatureTrackingDefinitions",
        "properties": {
          "Actions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Actions to record separately, as \"Module:Action\" (e.g. \"Character:EquipItems\"). Names match the route: FunctionName and the module's action enum. Case-insensitive."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Master switch. Off — only module-level feature usage is recorded, as before."
          }
        },
        "description": "New value for the FeatureTracking field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 35 lines copy
• save_cloud_code unknown never probed

  PARTIAL SAVE: writes ONLY the 'CloudCode' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Server-side scripting (CloudCode): the active JavaScript revision the title runs, plus execution policy — engine limits, rate limits, per-handler metadata, whether logs/stack traces are revealed to clients. Scripts are the ONLY way to write protected player data (UserCustomData ReadOnly/Internal buckets) and mutable title data (TitleCustomData Runtime scope). Prefer the dedicated cloud-code tools over editing this section by hand: they compute the code hash, bump the revision number and archive the previous one.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "CloudCodeDefinitions",
        "properties": {
          "Http": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CloudCodeHttpPolicy"
              }
            ]
          },
          "Enabled": {
            "type": "boolean"
          },
          "Handlers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CloudCodeHandlerMetadata"
            }
          },
          "Webhooks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CloudCodeWebhook"
            },
            "description": "Incoming webhooks: POST https://api.idosgames.com/api/v2/{titleID}/Public/CloudCode/Webhook/{id} runs a handler for an external service (payments, site forms, bots) with args = { Trigger: 'Webhook', WebhookID, Headers, Query, Body }. The request is verified BEFORE the handler runs — HMAC-SHA256 of the raw body with a title secret, or the secret itself as a token header. The handler's result is the HTTP response."
          },
          "RateLimit": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CloudCodeRateLimitConfig"
              }
            ]
          },
          "Schedules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CloudCodeSchedule"
            },
            "description": "Handlers run on a schedule: every IntervalMinutes from StartAtUtc, with args = { Trigger: 'Schedule', ScheduleID, ScheduledAtUtc, Args }. At most 20 schedules; the most frequent is every 5 minutes. Runs as the server (no player session); one run per slot, missed slots are not replayed."
          },
          "DefaultLimits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CloudCodeLimits"
              }
            ]
          },
          "ActiveRevision": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CloudCodeActiveRevision"
              }
            ]
          },
          "ResourcePolicy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CloudCodeResourcePolicy"
              }
            ],
            "description": "The script's right to move player resources and start InApp AI. Enabled=false (default): server.ApplyResourceOperation and server.StartAIGeneration refuse outright."
          },
          "RevealLogsToClient": {
            "type": "boolean"
          },
          "ExecutionLogTtlDays": {
            "type": "integer",
            "format": "int32"
          },
          "PersistExecutionLog": {
            "type": "boolean"
          },
          "RevealStackTraceToClient": {
            "type": "boolean"
          }
        },
        "description": "New value for the CloudCode field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "CloudCodeLimits": {
        "type": "object",
        "properties": {
          "MaxCodeBytes": {
            "type": "integer",
            "format": "int32"
          },
          "MaxLogsBytes": {
            "type": "integer",
            "format": "int32"
          },
          "MaxStackDepth": {
            "type": "integer",
            "format": "int32"
          },
          "MaxStatements": {
            "type": "integer",
            "format": "int32"
          },
          "TimeoutMilliseconds": {
            "type": "integer",
            "format": "int32"
          },
          "MaxFunctionResultBytes": {
            "type": "integer",
            "format": "int32"
          },
          "MaxApiCallsPerExecution": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "CloudCodeWebhook": {
        "type": "object",
        "properties": {
          "ID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Webhook id — the last segment of its URL (letters, digits, '_' up to 64 chars)."
          },
          "Auth": {
            "oneOf": [
              {
                "$ref": "#/definitions/CloudCodeWebhookAuth"
              }
            ],
            "description": "How requests are verified."
          },
          "Header": {
            "type": [
              "null",
              "string"
            ],
            "description": "Header with the signature or token. null = X-Signature (HmacSha256) or X-Webhook-Token (Token)."
          },
          "Enabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "null or true = enabled; false = requests are refused."
          },
          "Handler": {
            "type": [
              "null",
              "string"
            ],
            "description": "Handler name in the active revision (handlers.<name>)."
          },
          "SecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of a title secret (kind Secret) used to verify requests. The value never reaches the script."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "What the webhook is for."
          }
        },
        "description": "An incoming webhook."
      },
      "CloudCodeSchedule": {
        "type": "object",
        "properties": {
          "ID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Schedule id (letters, digits, '_' up to 64 chars)."
          },
          "Args": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional JSON passed to the handler as args.Args (up to 8 KB)."
          },
          "Enabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "null or true = enabled; false = paused."
          },
          "Handler": {
            "type": [
              "null",
              "string"
            ],
            "description": "Handler name in the active revision (handlers.<name>)."
          },
          "StartAtUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor time in UTC: runs happen at StartAtUtc + k × IntervalMinutes. null = aligned to 00:00 UTC (60 = on the hour, 1440 = at midnight UTC)."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "What the schedule is for."
          },
          "IntervalMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "Run every N minutes (5..10080)."
          }
        },
        "description": "A handler run on a schedule."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "CloudCodeHttpPolicy": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Master switch. When false, server.HttpRequest is rejected outright."
          },
          "AllowedHosts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed hosts: exact match (api.stripe.com) or subdomain wildcard (*.stripe.com). An empty list means nothing is allowed — there is deliberately no allow-all mode."
          },
          "MaxResponseBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Response size cap in bytes. 0 means the default (65536). A larger body is dropped and flagged instead of truncated silently."
          },
          "AllowInsecureHttp": {
            "type": "boolean",
            "description": "Allow plain http:// in addition to https://. False by default: a substituted secret would travel in clear text."
          },
          "TimeoutMilliseconds": {
            "type": "integer",
            "format": "int32",
            "description": "Per-request timeout in ms. 0 means the default (5000). Clamped server-side so the call fits inside the 10-second execution budget."
          },
          "MaxRequestsPerExecution": {
            "type": "integer",
            "format": "int32",
            "description": "How many outbound requests one execution may make. 0 means the default (3)."
          }
        },
        "description": "Outbound HTTP policy for CloudCode scripts. Disabled by default; requests are only allowed to explicitly listed hosts."
      },
      "CloudCodeWebhookAuth": {
        "enum": [
          "HmacSha256",
          "Token"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "HmacSha256",
          "Token"
        ],
        "x-enum-descriptions": [
          "HMAC-SHA256 of the raw body with the secret, hex (optionally 'sha256=' prefixed), in Header (default X-Signature).",
          "The secret itself in Header (default X-Webhook-Token)."
        ]
      },
      "CloudCodeRateLimitRule": {
        "type": "object",
        "properties": {
          "MaxRequests": {
            "type": "integer",
            "format": "int32"
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32"
          },
          "BlockDurationSeconds": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "CloudCodeActiveRevision": {
        "type": "object",
        "properties": {
          "Code": {
            "type": [
              "null",
              "string"
            ]
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CloudCodeLimits"
              }
            ]
          },
          "Comment": {
            "type": [
              "null",
              "string"
            ]
          },
          "CodeHash": {
            "type": [
              "null",
              "string"
            ]
          },
          "Revision": {
            "type": "integer",
            "format": "int32"
          },
          "CreatedBy": {
            "type": [
              "null",
              "string"
            ]
          },
          "ActivatedBy": {
            "type": [
              "null",
              "string"
            ]
          },
          "CreatedAtUtc": {
            "type": "string",
            "format": "date-time"
          },
          "ActivatedAtUtc": {
            "type": "string",
            "format": "date-time"
          },
          "PrecompileOnLoad": {
            "type": "boolean"
          },
          "IncludeStackTrace": {
            "type": [
              "boolean",
              "null"
            ]
          }
        }
      },
      "CloudCodeResourcePolicy": {
        "type": "object",
        "properties": {
          "Caps": {
            "type": [
              "null",
              "object"
            ],
            "description": "Grant caps by resource key: \"VirtualCurrency:{CurrencyID}\", \"Item:{CatalogID}:{ItemID}\", \"RewardedVideoCredit\". No key = no cap.",
            "additionalProperties": {
              "$ref": "#/definitions/CloudCodeResourceCapRule"
            }
          },
          "Enabled": {
            "type": "boolean",
            "description": "Master switch. false: server.ApplyResourceOperation and server.StartAIGeneration are refused outright."
          },
          "AllowEventTokens": {
            "type": "boolean",
            "description": "Allow the script to move event tokens (ResourceBundle.EventTokens) — leaderboard scores, event tokens."
          },
          "AllowedGrantTypes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntryType"
            },
            "description": "Resource types the script may GRANT. null/empty = default (VirtualCurrency, Item). CryptoCurrency and RewardedVideoCredit require explicit listing. Purchase is ALWAYS forbidden (not a storable resource — the player's store money, the script cannot control it)."
          },
          "AllowedConsumeTypes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntryType"
            },
            "description": "Resource types the script may CONSUME from the player. null/empty = default (VirtualCurrency, Item). Consuming does not mint value, so this list is intentionally less strict than the grant one, but Purchase is forbidden just the same."
          }
        },
        "description": "The script's right to move player resources and start InApp AI. Enabled=false (default): both methods refuse outright, before any other field is read. Crypto under THIS policy is only the first gate ('the script may touch crypto at all'); the actual safety of a crypto grant (caps, pool backing) is CryptoCurrencyDefinition.ServerGrantPolicy of EACH currency, and always applies regardless of this policy."
      },
      "CloudCodeHandlerMetadata": {
        "type": "object",
        "properties": {
          "Name": {
            "type": [
              "null",
              "string"
            ]
          },
          "Disabled": {
            "type": "boolean"
          },
          "Description": {
            "type": [
              "null",
              "string"
            ]
          }
        }
      },
      "CloudCodeRateLimitConfig": {
        "type": "object",
        "properties": {
          "UserLimit": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CloudCodeRateLimitRule"
              }
            ]
          },
          "TitleLimit": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CloudCodeRateLimitRule"
              }
            ]
          },
          "PerHandlerUserLimit": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/definitions/CloudCodeRateLimitRule"
            }
          }
        }
      },
      "CloudCodeResourceCapRule": {
        "type": "object",
        "properties": {
          "TitleDaily": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Title-wide daily cap. null = no cap on this axis."
          },
          "PerPlayerDaily": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Per-player daily cap. null = no cap on this axis."
          }
        },
        "description": "One CloudCode resource-grant cap. See CloudCodeResourcePolicy.Caps."
      }
    },
    "additionalProperties": false
  }

  arguments 545 lines copy
• get_currency unknown never probed

  GET ONLY the 'Currency' field of TitlePublicConfigurationModel. Currency catalogue: VirtualCurrencies (Gold, Gems, Energy, etc.) AND CryptoCurrencies (on-chain tokens). Defines IDs, economy (USD value, balance limits), recharge rules for energy-like currencies, conversion rules, and per-currency permissions. The CurrencyID of each entry is referenced by Item prices, Store SKUs, Reward payouts, Quest rewards, Lootbox loot, etc. NOTE: the "Main" CryptoCurrency entry is protected and cannot be overwritten — your changes to that key will be silently ignored.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_attribution unknown never probed

  GET ONLY the 'Attribution' field of TitlePublicConfigurationModel. Acquisition attribution — how the engine records WHERE a player came from. The signal (utm_source/medium/campaign/term/content, the ad network's click id, the referrer, the invite code) arrives with the login request and is stored as a chain of touch points on the player: the first touch is immutable, the last touch tracks win-backs, and the chain in between feeds multi-touch models. This section only tunes that recording: how many touches to keep, how long after a touch an identical signal is still considered the same click rather than a new one, and optional aliases that normalise messy source/medium values into canonical ones for analytics. Referral invites are recorded through this same mechanism as a channel, so they show up in the acquisition reports alongside paid traffic.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_currency unknown never probed

  PARTIAL SAVE: writes ONLY the 'Currency' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Currency catalogue: VirtualCurrencies (Gold, Gems, Energy, etc.) AND CryptoCurrencies (on-chain tokens). Defines IDs, economy (USD value, balance limits), recharge rules for energy-like currencies, conversion rules, and per-currency permissions. The CurrencyID of each entry is referenced by Item prices, Store SKUs, Reward payouts, Quest rewards, Lootbox loot, etc. NOTE: the "Main" CryptoCurrency entry is protected and cannot be overwritten — your changes to that key will be silently ignored.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "CurrencyDefinitions",
        "properties": {
          "CryptoCurrencies": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/definitions/CryptoCurrencyDefinition"
            }
          },
          "VirtualCurrencies": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/definitions/VirtualCurrencyDefinition"
            }
          },
          "CryptoIouForScriptsAndAI": {
            "type": "boolean",
            "description": "CloudCode server.ApplyResourceOperation and AI feature rewards also grant the unbacked part of a crypto grant as the currency's IOU instead of refusing. Off by default — module rewards (quests, events, leaderboards, store) always use the IOU when the currency has one."
          },
          "CryptoAutoRepayIouOnWithdrawal": {
            "type": "boolean",
            "description": "Lazily repay IOUs on withdrawal: when the player's crypto balance does not cover a withdrawal, the missing part is converted from the player's IOUs of that crypto into real crypto from the players' reward pool of the same network (only as much as needed, while the pool lasts). On by default."
          },
          "CryptoRewardsFromDeveloperShare": {
            "type": "boolean",
            "description": "Crypto rewards to players that the players' reward pool cannot cover are topped up from the developer's share of the pool. Off by default — the developer turns it on. When off (or the share is short too), the shortfall is granted as the currency's IOU virtual currency (UnbackedRewardCurrencyID)."
          }
        },
        "description": "New value for the Currency field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "CryptoLimits": {
        "type": "object",
        "properties": {
          "DailyWithdrawUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Per-player daily withdrawal limit in USD equivalent. Null means no daily limit. AML-driven, USD-denominated for consistency across volatile currencies."
          },
          "MonthlyWithdrawUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Monthly withdrawal limit in USD equivalent. Separate from daily because KYC tiers typically have both. Null means no monthly limit."
          },
          "KycRequiredAboveUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "USD-equivalent threshold for a single withdrawal above which KYC is required. Null means KYC not required for this currency."
          }
        }
      },
      "CurrencyType": {
        "enum": [
          "Virtual",
          "Crypto"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Virtual",
          "Crypto"
        ]
      },
      "CurrencyAudit": {
        "type": "object",
        "properties": {
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Record creation time. Set once on insert and immutable thereafter."
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Record last-modified time. Updated on every save. Used for audit and client cache invalidation."
          }
        }
      },
      "CurrencyStatus": {
        "enum": [
          "Active",
          "Hidden",
          "Deprecated",
          "Maintenance"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Active",
          "Hidden",
          "Deprecated",
          "Maintenance"
        ],
        "x-enum-descriptions": [
          "Available in all operations and shown to players.",
          "Hidden in UI but operations are formally allowed (e.g. internal tests).",
          "New earnings/purchases disabled; existing balance can still be spent.",
          "All operations temporarily blocked (maintenance, emergency stop)."
        ]
      },
      "RechargeConfig": {
        "type": "object",
        "properties": {
          "Max": {
            "type": "integer",
            "format": "int64",
            "description": "Recharge cap: balance ceiling for auto-recharge. A batch is clipped exactly at this value (if less than Rate is missing, only the remainder is credited); at or above it nothing is credited. Above this, currency can only be gained via explicit grants. Distinct from the global cap in Economy.MaxBalance."
          },
          "Rate": {
            "type": "integer",
            "format": "int64",
            "description": "Units credited per FULL period, granted as a single batch. Rate=5 with Period=60 means +5 once a minute, not +1 every 12 seconds: an incomplete period credits nothing and its time is carried over."
          },
          "Period": {
            "type": "integer",
            "format": "int64",
            "description": "Length of one recharge period in seconds. Units are credited on full-period boundaries measured from the last accrual or spend, not on a wall-clock grid."
          }
        }
      },
      "ConversionTarget": {
        "type": "object",
        "properties": {
          "Rate": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Fixed conversion rate: units of target per 1 unit of source. Used only when Conversion.RateMode = Manual; ignored under Automatic."
          },
          "MaxAmount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Maximum source amount per conversion operation. Null means no limit. Protects against single-shot balance drains."
          },
          "MinAmount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Minimum source amount per conversion operation. Null means no limit. Prevents dust conversions that round to 0 target."
          },
          "DailyLimit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Per-player daily limit for conversions on this specific pair (in source currency units). Null means no limit. Counted by UTC days."
          },
          "TargetCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "CurrencyID of the target currency the conversion is allowed to."
          },
          "TargetCurrencyType": {
            "oneOf": [
              {
                "$ref": "#/definitions/CurrencyType"
              }
            ],
            "description": "Type of target currency. Determines which dictionary to resolve TargetCurrencyID against (virtual or crypto). Required."
          }
        }
      },
      "ConversionRateMode": {
        "enum": [
          "Automatic",
          "Manual"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Automatic",
          "Manual"
        ],
        "x-enum-descriptions": [
          "Rate is computed automatically from ValueInUSD of source and target currencies.",
          "Rate is taken manually from ConversionTarget.Rate per pair."
        ]
      },
      "CurrencyConversion": {
        "type": "object",
        "properties": {
          "Fee": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Conversion fee as a SHARE of the debited amount: 0.05 = 5% (the platform-wide unit, see RateSpec). Empty or 0 means no fee. Taken from the source currency BEFORE calculating the received amount. Deliberately NOT named FeePercent: the Percent suffix is banned platform-wide because it was the source of 0..1 vs 0..100 confusion."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Master conversion switch. False disables conversion regardless of Targets content."
          },
          "Targets": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ConversionTarget"
            },
            "description": "Whitelist of target currencies with conversion parameters. Null/empty means no conversion allowed. One-directional: a target listed here does not imply the reverse is allowed."
          },
          "RateMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ConversionRateMode"
              }
            ],
            "description": "Rate calculation mode for this currency as conversion source. Automatic uses Economy.ValueInUSD; Manual uses per-pair ConversionTarget.Rate."
          }
        }
      },
      "CryptoNetworkBinding": {
        "type": "object",
        "properties": {
          "Decimals": {
            "type": "integer",
            "format": "int32",
            "description": "On-chain decimals for this token in this network. Used to convert whole units to/from smallest units in raw on-chain transactions. Distinct from DisplayDecimals."
          },
          "NetworkID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Network identifier from the title-level networks config (e.g. \"ethereum\", \"bsc\", \"tron\"). Network config itself lives elsewhere."
          },
          "MinWithdraw": {
            "type": "number",
            "format": "decimal",
            "description": "Minimum amount per withdrawal in this network. Enforced on the withdrawal path: a smaller amount is refused."
          },
          "ContractAddress": {
            "type": [
              "null",
              "string"
            ],
            "description": "Token smart-contract address in this network (ERC-20/BEP-20/TRC-20). Null for native coins (ETH, BNB, TRX, BTC); distinguishes native transfer vs contract call."
          },
          "DepositsEnabled": {
            "type": "boolean",
            "description": "Deposit switch for this currency-network pair. Allows disabling one network during incidents without affecting others."
          },
          "WithdrawalsEnabled": {
            "type": "boolean",
            "description": "Withdrawal switch for this currency-network pair. Used to pause withdrawals on one network (e.g. drained hot-wallet) while others keep working."
          }
        }
      },
      "CryptoServerGrantMode": {
        "enum": [
          "Disabled",
          "Backed"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Disabled",
          "Backed"
        ],
        "x-enum-descriptions": [
          "Only for CloudCode and AI rewards while CryptoIouForScriptsAndAI is off: their crypto grants are refused. Default. Module rewards ignore the mode.",
          "Only for CloudCode and AI rewards while CryptoIouForScriptsAndAI is off: in the SAME transaction the grant is paid from the players' reward pool, the rest from the developer's share if CryptoRewardsFromDeveloperShare is on. If that is short, the whole operation rolls back. Module rewards ignore the mode."
        ]
      },
      "VirtualCurrencyEconomy": {
        "type": "object",
        "properties": {
          "MaxBalance": {
            "type": "integer",
            "format": "int64",
            "description": "Hard upper balance cap. Anti-exploit safeguard and global cap over Recharge.Max. long.MaxValue means effectively unlimited."
          },
          "MinBalance": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum allowed balance. Usually 0; negative values are allowed for credit/penalty mechanics. Any debit that would breach this is rejected before balance change."
          },
          "ValueInUSD": {
            "type": "number",
            "format": "decimal",
            "description": "Base USD value per unit of currency. Used for cross-currency conversion equivalence, BI valuation of rewards/lootboxes, and store pricing via the multiplier."
          },
          "DailyEarnLimit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Max amount of currency a player can EARN per UTC day. Null means no limit."
          },
          "InitialDeposit": {
            "type": "integer",
            "format": "int64",
            "description": "Amount of currency granted to a new player at account creation. 0 means none. Applied once during wallet initialization."
          },
          "DailySpendLimit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Max amount of currency a player can SPEND per UTC day. Null means no limit. Compliance mechanism for real-money currencies."
          },
          "ValueInUSDUpdatedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Timestamp when ValueInUSD was last updated. Consumers of the cached price can use it to decide whether to refresh the quote."
          }
        }
      },
      "CryptoServerGrantPolicy": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/CryptoServerGrantMode"
              }
            ],
            "description": "Grant mode."
          },
          "RefuseOverCap": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "What happens when a daily cap is reached. true = the reward is refused entirely with CRYPTO_SERVER_GRANT_CAP_EXCEEDED:{currency} (nothing is granted, not even an IOU). null/false = the reward is granted as the IOU currency."
          },
          "FundingNetworkID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Which network (one of this currency's Networks) pays rewards from its pool. Not needed when the currency lives in one network — that one is used. Required when Mode = Backed."
          },
          "TitleDailyTokens": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Title-wide daily cap on crypto rewards, in whole tokens. null = no cap. Over the cap: see RefuseOverCap (IOU by default; CloudCode/AI without IOU: refused)."
          },
          "PerPlayerDailyTokens": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Per-player daily cap on crypto rewards, in whole tokens. null = no cap. Over the cap: see RefuseOverCap (IOU by default; CloudCode/AI without IOU: refused)."
          }
        },
        "description": "Server-issued grant policy for one crypto currency. See CryptoServerGrantMode."
      },
      "CryptoCurrencyDefinition": {
        "type": "object",
        "properties": {
          "Audit": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurrencyAudit"
              }
            ],
            "description": "Record metadata: creation and last-modified times. Shared type with virtual currencies."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CryptoLimits"
              }
            ],
            "description": "Compliance limits (AML/KYC). Separate from Permissions because this is regulatory. Null means no limits set (usually dev/testnet only)."
          },
          "Status": {
            "oneOf": [
              {
                "$ref": "#/definitions/CurrencyStatus"
              }
            ],
            "description": "Current lifecycle status. Allows soft retirement without deleting the record so transaction history continues to reference CurrencyID."
          },
          "Networks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CryptoNetworkBinding"
            },
            "description": "Currency-to-network bindings: which networks the currency lives in, with per-network parameters (contract address, on-chain decimals, minimums, fee)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Paths to currency assets (icons, network logos, animations). Element purpose is defined by client convention.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Conversion": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurrencyConversion"
              }
            ],
            "description": "Conversion rules for this currency. Targets can be other crypto or virtual currencies (distinguished by ConversionTarget.TargetCurrencyType). Null means fully disabled."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique stable crypto-currency identifier (e.g. \"BTC\", \"ETH\", \"USDT\"). Primary key used across balance operations, analytics, and references. Immutable after creation."
          },
          "ValueInUSD": {
            "type": "number",
            "format": "decimal",
            "description": "Cached USD value per unit (from oracle/exchange). Used for USD display, USD-limit/KYC checks, and BI. Not authoritative for real-time conversion — fetch live quote from price service."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for internal use (admin panel, logs). Player-facing localization is handled separately by CurrencyID key."
          },
          "Permissions": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CryptoCurrencyPermissions"
              }
            ],
            "description": "Behavioral flags: what can be done with the currency (deposits, withdrawals, in-game spend, conversion to virtual)."
          },
          "DisplayDecimals": {
            "type": "integer",
            "format": "int32",
            "description": "Number of decimals to show in UI and accept on user input. Presentational only; on-chain decimals per token+network are in CryptoNetworkBinding.Decimals."
          },
          "ServerGrantPolicy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CryptoServerGrantPolicy"
              }
            ],
            "description": "Daily caps on rewards of this currency (everything but deposits): module rewards (quests, events, season, store, lootboxes, IAP products...), an AI feature Reward and CloudCode's server.ApplyResourceOperation. Rewards are always paid in crypto from the players' reward pool of this title (plus the developer's share if CryptoRewardsFromDeveloperShare is on); what the pool cannot cover, or what exceeds a cap, is granted as the IOU currency (UnbackedRewardCurrencyID). null = no caps. Editable for Main too. Mode matters only for CloudCode and AI rewards while CryptoIouForScriptsAndAI is off. Does not affect deposits, withdrawals or player spend."
          },
          "ValueInUSDUpdatedAt": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Timestamp of the last ValueInUSD update. Consumers can decide whether to use cached value or fetch a fresh quote."
          },
          "PlayerTradeFeePercent": {
            "type": "number",
            "format": "decimal",
            "description": "Developer fee (percent) on PLAYER-TO-PLAYER trades in this currency: a marketplace sale, a PvP win, a purchase from a Workshop author. The seller/winner receives the amount minus this fee; the fee moves to the developer's share of the title pool. One value for every trading module. Max 50%. In-game prices are not affected — spent crypto already goes to the developer in full."
          },
          "WithdrawalBurnPercent": {
            "type": "number",
            "format": "decimal",
            "description": "Percentage of a player token withdrawal that is BURNED on-chain (EVM: DEAD address, Solana: incinerator). The server binds the burn amount into the withdrawal signature. Developer fee + Community Marketing fee + burn must not exceed 50%; the platform's own withdrawal commission is separate."
          },
          "UsdPriceRefreshMinutes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Main token only: how often (minutes) the engine refreshes the token USD price on in-game crypto spends. Custom value needs a paid plan; default 720 (twice a day). Each refresh counts as an API call. 5..10080."
          },
          "UnbackedRewardCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IOU virtual currency of this crypto: the part of a crypto reward that is not backed at grant time (by the players' reward pool, plus the developer's share if CryptoRewardsFromDeveloperShare is on) is granted in this virtual currency 1:1. The player sees crypto was owed; the developer repays it with real crypto from the dashboard. When the player spends this crypto in the game, the IOU is spent first. Must be a key of VirtualCurrencies. Not set — an unbacked reward is refused."
          },
          "DeveloperWithdrawalFeePercent": {
            "type": "number",
            "format": "decimal",
            "description": "Developer fee (percent) on a PLAYER withdrawal of this currency: that share of the withdrawn amount moves to the developer's share of the title pool. Deposits are credited to the player in full; crypto the player spends in-game also goes to the developer. Developer fee + Community Marketing fee + burn must not exceed 50%."
          },
          "CommunityMarketingWithdrawalFeePercent": {
            "type": "number",
            "format": "decimal",
            "description": "Community Marketing fee (percent) on a PLAYER withdrawal of this currency: that share of the withdrawn amount funds the Community Marketing pool (rewards for promoting the game on social media). Developer fee + Community Marketing fee + burn must not exceed 50%."
          }
        }
      },
      "CryptoCurrencyPermissions": {
        "type": "object",
        "properties": {
          "DepositsEnabled": {
            "type": "boolean",
            "description": "Global deposit switch for this currency (across all networks). For per-network control use CryptoNetworkBinding.DepositsEnabled."
          },
          "SpendableInGame": {
            "type": "boolean",
            "description": "Whether the currency can be spent in-game (store purchases, event bets). False restricts it to deposit/withdraw/convert only."
          },
          "WithdrawalsEnabled": {
            "type": "boolean",
            "description": "Global withdrawal switch for this currency. See DepositsEnabled."
          },
          "ConvertibleToVirtual": {
            "type": "boolean",
            "description": "Whether this currency can be converted to/from virtual currencies. False rejects targets with TargetCurrencyType=Virtual even if listed in Conversion.Targets."
          }
        }
      },
      "VirtualCurrencyDefinition": {
        "type": "object",
        "properties": {
          "Audit": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurrencyAudit"
              }
            ],
            "description": "Record metadata: creation and last modification times. Used for audit, incident investigation, and client cache invalidation."
          },
          "Status": {
            "oneOf": [
              {
                "$ref": "#/definitions/CurrencyStatus"
              }
            ],
            "description": "Current lifecycle status of the currency. Allows soft retirement without deleting the record so transaction history continues to reference CurrencyID."
          },
          "Economy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/VirtualCurrencyEconomy"
              }
            ],
            "description": "Economic parameters: USD value, initial deposit, balance limits, granularity. Describes the currency's value and storage bounds."
          },
          "Recharge": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RechargeConfig"
              }
            ],
            "description": "Auto-recharge configuration. Null means the currency does not self-recharge (gold, gems). When set, the currency behaves as an energy resource (hearts, moves, energy)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Paths to currency assets (icons of various sizes, animated versions, SVG, etc.). Element purpose is defined by project convention on the client side.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Conversion": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurrencyConversion"
              }
            ],
            "description": "Rules for converting this currency to others. Null means conversion is fully disabled."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique stable currency identifier (e.g. \"GOLD\", \"GEMS\", \"ENERGY\"). Primary key used in balance operations, analytics events, and cross-references from other entities. Immutable after creation."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for internal use (admin panel, logs, tooling). Not intended for player-facing display; player localization is handled separately by CurrencyID key."
          },
          "Permissions": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/VirtualCurrencyPermissions"
              }
            ],
            "description": "Behavioral flags: what can be done with the currency (trade, purchase with real money, convert, refund)."
          }
        }
      },
      "VirtualCurrencyPermissions": {
        "type": "object",
        "properties": {
          "IsTradable": {
            "type": "boolean",
            "description": "Whether the currency can be transferred between players (gifts, P2P trade, guild bank). False by default."
          },
          "IsRefundable": {
            "type": "boolean",
            "description": "Whether the currency is refundable on IAP refunds and compensations. True by default; disable for derived currencies obtained by conversion."
          },
          "IsPurchasable": {
            "type": "boolean",
            "description": "Whether the currency can be purchased with real money (IAP, storefront). Used when building storefronts and validating IAP callbacks."
          }
        }
      }
    },
    "additionalProperties": false
  }

  arguments 685 lines copy
• save_attribution unknown never probed

  PARTIAL SAVE: writes ONLY the 'Attribution' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Acquisition attribution — how the engine records WHERE a player came from. The signal (utm_source/medium/campaign/term/content, the ad network's click id, the referrer, the invite code) arrives with the login request and is stored as a chain of touch points on the player: the first touch is immutable, the last touch tracks win-backs, and the chain in between feeds multi-touch models. This section only tunes that recording: how many touches to keep, how long after a touch an identical signal is still considered the same click rather than a new one, and optional aliases that normalise messy source/medium values into canonical ones for analytics. Referral invites are recorded through this same mechanism as a channel, so they show up in the acquisition reports alongside paid traffic.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "AttributionDefinitions",
        "properties": {
          "StoreLinks": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreLinkDefinitions"
              }
            ],
            "description": "Where to send a person who opened this title's link: one URL per platform, shown on the shareable invite page idosgames.com/go/{titleID}. Sits inside attribution but answers a DIFFERENT question - the rest of this section configures HOW a touch is recorded, this says WHERE to send someone. Each URL is validated BY HOST when saved; an empty one means the platform is not configured and its button is not rendered at all."
          },
          "MediumAliases": {
            "type": [
              "null",
              "object"
            ],
            "description": "Same as SourceAliases but for utm_medium — e.g. \"cpc\" -> \"paid_search\", \"social-cpc\" -> \"paid_social\".",
            "additionalProperties": {
              "type": "string"
            }
          },
          "SourceAliases": {
            "type": [
              "null",
              "object"
            ],
            "description": "Optional normalisation for utm_source. Key is what the client sent (lower-cased and trimmed), value is the canonical name used in analytics — e.g. \"fb\" -> \"facebook\", \"g\" -> \"google\". Leave empty to store values exactly as received.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "MaxHistoryEntries": {
            "type": "integer",
            "format": "int32",
            "description": "Max length of the player's touch-point chain (UserAttributionState.History). When exceeded, MIDDLE entries are evicted — the first touch and the last touch are always kept. 0 or negative disables multi-touch entirely (only FirstTouch/LastTouch are stored). Recommended 10..50, default 20."
          },
          "DeferredMatchEnabled": {
            "type": "boolean",
            "description": "Whether to match an install against a click registered earlier, when the request itself carried no signal at all. Needed where the marketing tag cannot survive the trip: the player taps an ad in a browser, goes through the app store and comes back inside the game, and the parameter is lost on the way. WARNING: this is a GUESS, not a fact - the click is matched by fingerprint (network, platform, OS version, country), and behind a mobile carrier's shared address there can be hundreds of candidates. Such touches are marked with trust level Inferred and must be shown as a separate line in reports."
          },
          "DeferredMatchTtlMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "How many minutes a registered click waits for its install before expiring. A day is the compromise: the store visit and the download take hours, but the wider the window, the more candidates share one fingerprint. 0 or less means the default. WARNING: SHORTENING this on live traffic temporarily loses some matches - the fingerprint index is read from the newest end, and a shorter TTL makes new claims expire BEFORE older ones, so a still-live older claim drops below the cut-off and is never seen. It heals itself after one old window; raising the value is always safe."
          },
          "ReengagementWindowMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "Deduplication window in minutes. A new signal arriving less than this long after the last touch is treated as a repeat click on the same link and is NOT recorded as a separate touch. 0 disables dedup — every signal becomes a new touch. Recommended 5..60, default 30."
          },
          "DeferredMatchMaxCandidates": {
            "type": "integer",
            "format": "int32",
            "description": "How many matching click records still count as a match. This is the only guard against false attribution: behind a carrier's shared NAT one fingerprint covers a whole building, so once the number of candidates passes this limit nothing is matched at all - guessing one out of forty is worse than attributing nobody. 0 or less means the default."
          }
        },
        "description": "New value for the Attribution field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "StoreLinkDefinitions": {
        "type": "object",
        "properties": {
          "TelegramUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "Telegram mini app or bot URL. Only t.me, telegram.me, telegram.dog or a tg:// scheme. Empty hides the button."
          },
          "GooglePlayUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "Google Play listing URL. Validated BY HOST on save: only play.google.com, market.android.com, play.app.goo.gl or a market:// scheme. Link shorteners are refused - what hides behind them cannot be checked without following them. Empty means the platform is not configured and its button is not rendered, which is honest; a button leading somewhere wrong is not."
          },
          "AppleAppStoreUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "App Store listing URL. Only apps.apple.com, itunes.apple.com, appstore.com, apple.co or an itms-apps:// scheme. Empty hides the button."
          },
          "AutoRedirectMobile": {
            "type": "boolean",
            "description": "Send a phone straight to its own store instead of showing the platform picker. OFF by default, and never applied on desktop: the link is often opened on a work computer while the person plays on a phone, so there the choice must stay. WARNING - the page first waits for the click to be registered (with a short cap) and only then leaves: navigating away immediately would kill that request mid-flight and break deferred matching in exactly its main case, an ad tapped on a phone followed by a store install. Inside Telegram no redirect happens either - someone opening the link in a chat wants the mini app, not a store page."
          }
        }
      }
    },
    "additionalProperties": false
  }

  arguments 108 lines copy
• get_item unknown never probed

  GET ONLY the 'Item' field of TitlePublicConfigurationModel. Item catalogue — every consumable, equipment piece, resource, gear or generic inventory entity the player can own. Defines item IDs, names, categories, stack rules, rarities. Referenced by Store SKUs (as contents), Lootbox loot tables, Quest rewards, Craft recipes, and Reward payouts. For premium-tier bundles use Premium; for character entities use Character.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_item unknown never probed

  PARTIAL SAVE: writes ONLY the 'Item' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Item catalogue — every consumable, equipment piece, resource, gear or generic inventory entity the player can own. Defines item IDs, names, categories, stack rules, rarities. Referenced by Store SKUs (as contents), Lootbox loot tables, Quest rewards, Craft recipes, and Reward payouts. For premium-tier bundles use Premium; for character entities use Character.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "ItemDefinitions",
        "properties": {
          "Catalogs": {
            "type": [
              "null",
              "object"
            ],
            "description": "All catalogs of the title. A catalog is a thematic grouping of items. Key is CatalogID, unique within the title.",
            "additionalProperties": {
              "$ref": "#/definitions/ItemCatalog"
            }
          }
        },
        "description": "Root container for all item catalogs of a title. Source of truth for every ItemID used in the game."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "NFTModel": {
        "type": "object",
        "properties": {
          "Networks": {
            "type": [
              "null",
              "object"
            ],
            "description": "Per-network bindings. Key is NetworkID from cfg.Blockchain.Networks. The same ItemID has different ContractAddress + TokenID per network.",
            "additionalProperties": {
              "$ref": "#/definitions/NFTNetworkBinding"
            }
          },
          "MetadataUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL to token JSON metadata (typically IPFS or Arweave) in OpenSea standard. Shared across networks."
          }
        },
        "description": "Blockchain binding for an item. One Item can be bound to multiple networks; deposit/withdraw selects the binding by operation NetworkID."
      },
      "ItemStats": {
        "type": "object",
        "properties": {
          "Power": {
            "type": "integer",
            "format": "int32",
            "description": "Base item Power, added to CharacterModel.Power on equip. Scaled by instance Level via ItemUpgrade.PowerScalingFactor. 0 = no explicit Power contribution."
          },
          "FlatBonuses": {
            "type": [
              "null",
              "object"
            ],
            "description": "Flat bonuses added to the base stat. Key is stat name (\"Health\", \"Damage\", \"Armor\"), value is the addition.",
            "additionalProperties": {
              "type": "number",
              "format": "double"
            }
          },
          "PercentBonuses": {
            "type": [
              "null",
              "object"
            ],
            "description": "Percent bonuses multiplying the (base + flat) total. Key is stat name, value is a fraction of 1.0 (0.05 = +5%).",
            "additionalProperties": {
              "type": "number",
              "format": "double"
            }
          }
        },
        "description": "Item stat modifiers. Applied as flat additions over base first, then percent multipliers on top."
      },
      "CurvePoint": {
        "type": "object",
        "properties": {
          "Value": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Value at this point. Empty = the point is ignored."
          },
          "AtStep": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Step (level / rank / stage) at which this point takes effect. Empty = the point is ignored."
          }
        },
        "description": "One breakpoint of a table curve."
      },
      "CurveShape": {
        "enum": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "x-enum-descriptions": [
          "Value does not change with the step. Same behaviour as an unset curve.",
          "Additive in the value's own units: base + PerStep * (step - firstStep).",
          "Additive share of the base: base * (1 + PerStepRate * (step - firstStep)). 0.1 = +10% of base per step.",
          "Compounding: base * (1 + GrowthRate)^(step - firstStep).",
          "Table of multipliers over the base: base * interpolate(Points, step).",
          "Table of absolute values: interpolate(Points, step). The base is ignored."
        ]
      },
      "ItemCatalog": {
        "type": "object",
        "properties": {
          "Items": {
            "type": [
              "null",
              "object"
            ],
            "description": "All items in this catalog. Key is ItemID (unique within the catalog). Full item address is the (CatalogID, ItemID) pair.",
            "additionalProperties": {
              "$ref": "#/definitions/ItemDefinition"
            }
          }
        },
        "description": "Catalog: a set of items of one thematic group. Item references (ItemID + CatalogID) resolve here."
      },
      "ItemUpgrade": {
        "type": "object",
        "properties": {
          "Fodder": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ItemUpgradeFodder"
              }
            ],
            "description": "Fodder valuation rules for same-item upgrade payment. Controls W(L) (how a level-L copy is valued) and whether leveled copies can be spent. Null = legacy FlatCount + ProtectLeveled."
          },
          "MaxLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Hard cap on the instance Level. 1 means already at max (cannot be upgraded). Values <= 0 are clamped to 1."
          },
          "CostCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Cost curve over the level. Computed from the price in PriceOptions; the step is the target level (numbered from 1). Empty = the same price at every level. Leave Base empty — the base is the configured price."
          },
          "PowerCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Growth curve for ItemStats.Power over the instance level. Empty = item Power does not grow. Leave Base empty."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay for one upgrade step. Dictionary key = PriceOption.OptionID; each option's Amount is the base cost, scaled linearly per target level via CostScalingFactor. A store-paid option is not allowed here: a store SKU is a fixed price tier and cannot follow a per-level formula.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "FlatBonusCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Growth curve for ItemStats.FlatBonuses over the instance level. The base is the bonus itself, the step is the item level. Empty = flat bonuses do not grow. Leave Base empty."
          },
          "PercentBonusCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Growth curve for ItemStats.PercentBonuses over the instance level. Empty = percent bonuses do not grow. Leave Base empty."
          }
        },
        "description": "Upgrade rules for an unstackable item instance: cap, cost curve, stat scaling."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "ItemMetadata": {
        "type": "object",
        "properties": {
          "AuthorID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Author/creator ID. Used for UGC content and branded collaborations (UI attribution, royalty payments)."
          },
          "RarityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Rarity ID from the title's rarity dictionary (e.g. \"Common\", \"Rare\", \"Epic\", \"Legendary\"). Drives UI framing and duplicate-conversion value."
          },
          "CollectionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the collection/set the item belongs to. For stickers, the Album page ID; for cosmetics, the thematic set ID."
          }
        },
        "description": "Item metadata for rarity display, collection membership, and attribution. Used by the Albums subsystem and the UI layer."
      },
      "ItemEquipment": {
        "type": "object",
        "properties": {
          "IdleRateBonus": {
            "type": "number",
            "format": "double",
            "description": "Bonus to the idle-accrual rate (units per second) while the item is equipped. Summed across all items equipped on the character and added to the IdleRateConfig formula; counted only when the accrual has EquipmentBonusEnabled. 0 = the item does not affect the rate."
          },
          "AllowedSlotIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "SlotIDs where the item can be placed (e.g. \"Head\", \"Chest\", \"MainHand\", \"Trinket1\")."
          },
          "UseRequirements": {
            "type": [
              "null",
              "object"
            ],
            "description": "Item-side stat requirements. Key is StatID, value is minimum stat level on the character. Validated in EquipItems identically to CharacterEquipmentSlot.StatRequirements.",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          },
          "MinCharacterLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum character level (CharacterModel.Level) required to equip. 0 means no requirement."
          },
          "AllowedCharacterIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Whitelist of characters that can equip the item. Empty or null means any character (subject to other requirements)."
          }
        },
        "description": "Equipment rules: who can equip the item, where, and under what conditions."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ItemDefinition": {
        "type": "object",
        "properties": {
          "NFT": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/NFTModel"
              }
            ],
            "description": "NFT binding when the item is tokenized on-chain. Null for ordinary off-chain items."
          },
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Arbitrary tags for filtering and grouping (e.g. \"rare\", \"event_halloween_2026\", \"tradable\", \"seasonal\")."
          },
          "Stats": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ItemStats"
              }
            ],
            "description": "Game stats (flat + percent bonuses). Set only for items granting stats. Null means no effect on the stat system."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique item ID within the catalog."
          },
          "Weight": {
            "type": "integer",
            "format": "int32",
            "description": "Item weight in randomized drops (crafting, lootboxes, sticker packs). Higher value means higher drop rate in weighted pools."
          },
          "Upgrade": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ItemUpgrade"
              }
            ],
            "description": "Upgrade rules for the item instance level. Null = item cannot be upgraded. Independent from equipment — non-equippable items can also be upgradable."
          },
          "Metadata": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ItemMetadata"
              }
            ],
            "description": "Meta info: rarity, collection/set membership, author. Used by the Albums subsystem and for UGC attribution."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Owner catalog ID. Together with ItemID forms the full item address."
          },
          "Equipment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ItemEquipment"
              }
            ],
            "description": "Equipment rules: minimum level, allowed slots and characters. Null means the item cannot be equipped."
          },
          "ItemClass": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item class used for grouping and logic (e.g. \"Weapon\", \"Armor\", \"Consumable\", \"Sticker\", \"LootBox\", \"Cosmetic\")."
          },
          "MaxSupply": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Max number of instances that may exist SIMULTANEOUSLY across the whole title (circulating supply). Enforced centrally in ResourceService at genuine mint/burn sites (lootbox, store, quest, craft): grants increment circulation guarded by this cap, burns decrement it. Moves (trade/marketplace escrow/gift) don't change it. Null/<=0 = unlimited. Stored in the separate TitleSupplyCounters collection, not in config."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Paths to visual/audio assets keyed by purpose (e.g. \"icon\", \"model\", \"thumbnail\", \"preview_video\", \"sfx_use\").",
            "additionalProperties": {
              "type": "string"
            }
          },
          "CustomData": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary custom data. Used by designers for parameters that don't fit typed blocks.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsTradable": {
            "type": "boolean",
            "description": "Whether P2P transfer is allowed. Controls availability in the trade module."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "UI display description (localization key or literal string)."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "UI display name (localization key or literal string)."
          },
          "IsStackable": {
            "type": "boolean",
            "description": "True: copies stack as Amount in ItemTotals. False: each copy is a separate UnstackableItemInstanceState with its own InstanceID, wear and custom data."
          },
          "ExpirationDurationSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Instance lifetime in seconds from the moment it enters inventory (AcquiredAt). When set (> 0), each granted UnstackableItemInstanceState gets ExpiresAt = AcquiredAt + this value. Null/<=0 means permanent. Only applies to non-stackable items."
          }
        },
        "description": "Definition of one item — the template from which player instances are created. Holds all static data and optional blocks (NFT, Stats, Equipment, Metadata)."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScalarCurveSpec": {
        "type": "object",
        "properties": {
          "Base": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Base the curve is computed from. Empty = use the base supplied by the caller. Fill it only where the base is a publisher setting (a multiplier starting at 1.5, a table's value before its first point) — where the base comes from data (a stat value, a level price, an item bonus) leaving it empty is required, otherwise it overrides the real base."
          },
          "Shape": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveShape"
              }
            ],
            "description": "Curve shape. Empty = Flat, i.e. no growth."
          },
          "Points": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CurvePoint"
            },
            "description": "Table breakpoints (Shape=Table or TableAbsolute). Empty = no growth."
          },
          "PerStep": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Units added per step (Shape=PerStep). Empty or 0 = no growth."
          },
          "MaxResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Upper bound of the result. Empty = there is NO upper bound (not 0)."
          },
          "MinResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Lower bound of the result. Empty = there is NO lower bound (not 0)."
          },
          "GrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Compounding rate per step (Shape=Geometric): 0.1 = x1.1 per step. Empty or 0 = no growth."
          },
          "PerStepRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Share of the base added per step (Shape=PerStepRate): 0.1 = +10% of base per step. Empty or 0 = no growth."
          },
          "Interpolation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveInterpolation"
              }
            ],
            "description": "How to interpolate between points. Empty = Step."
          },
          "TailGrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Growth beyond the last table point (share per step). Empty = hold the last point's value."
          }
        },
        "description": "Scalar curve f(base, step): how a value grows with a level, rank, stage or count. THE MODULE'S RULE: an empty field does nothing — an unset curve is the identity f(base,n)=base, an unset bound means there is no bound. All rates are shares (0.1 = +10%), never multipliers, so 0 and empty always mean the same thing."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "ItemUpgradeFodder": {
        "type": "object",
        "properties": {
          "Selection": {
            "oneOf": [
              {
                "$ref": "#/definitions/FodderSelectionMode"
              }
            ],
            "description": "How fodder is selected and how leveled (Level>1) copies are treated."
          },
          "WeightCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Curve of a copy's value by its level for FodderValuationMode.Merge: computed from a base of 1, the step is the copy level (numbered from 1), so a level-1 copy is always worth exactly 1. The WHOLE curve is honoured — shape, table points and bounds, not just its growth. The classic rule 'R copies of level L make one L+1' is Shape=Geometric with GrowthRate = R - 1 (R=2 becomes 1), but it is no longer the only option: fodder is charged in VALUE POINTS, not copies. Empty = every copy is worth the same."
          },
          "ValuationMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/FodderValuationMode"
              }
            ],
            "description": "Per-level value formula W(L). Self-item cost is expressed in value points; fodder accumulates W(level) until the target is covered."
          }
        },
        "description": "Fodder valuation/selection settings for same-item level upgrade. Two axes: ValuationMode (per-level value formula) and Selection (how leveled copies are picked/protected)."
      },
      "NFTNetworkBinding": {
        "type": "object",
        "properties": {
          "TokenID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Token ID within the contract (EVM uint256; Solana mint address or Metaplex edition number)."
          },
          "MaxLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Number of item levels encoded as a contiguous tokenId block from TokenID (the block base): tokenId(level) = TokenID + (level - 1). 1 (default) = single tokenId (== TokenID). Reverse: level = tokenId - TokenID + 1."
          },
          "TokenStandard": {
            "type": [
              "null",
              "string"
            ],
            "description": "Token standard: \"ERC-721\", \"ERC-1155\", \"SPL\", \"Metaplex\"."
          },
          "ContractAddress": {
            "type": [
              "null",
              "string"
            ],
            "description": "Smart-contract address (EVM) or mint address (Solana)."
          }
        },
        "description": "Binding of one Item to one specific network."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "CurveInterpolation": {
        "enum": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "x-enum-descriptions": [
          "Step: hold the previous point's value until the next one. Behaviour of an unset field.",
          "Linear between adjacent points.",
          "Geometric between adjacent points: lo * (hi/lo)^t."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "FodderSelectionMode": {
        "enum": [
          "ProtectLeveled",
          "CheapestFirst",
          "ClientSelected",
          "SameLevelOnly"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ProtectLeveled",
          "CheapestFirst",
          "ClientSelected",
          "SameLevelOnly"
        ]
      },
      "FodderValuationMode": {
        "enum": [
          "FlatCount",
          "Merge",
          "InvestmentRefund"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "FlatCount",
          "Merge",
          "InvestmentRefund"
        ]
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      }
    },
    "additionalProperties": false
  }

  arguments 1015 lines copy
• get_premium unknown never probed

  GET ONLY the 'Premium' field of TitlePublicConfigurationModel. Premium offerings catalogue — paid subscriptions, premium passes, real-money bundle skus, supporter tiers. Distinct from Store (regular in-game shop with virtual-currency prices) and from DealOffer (limited-time promotional offers). Use this specifically for monetization tiers / IAP that grant ongoing benefits.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_premium unknown never probed

  PARTIAL SAVE: writes ONLY the 'Premium' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Premium offerings catalogue — paid subscriptions, premium passes, real-money bundle skus, supporter tiers. Distinct from Store (regular in-game shop with virtual-currency prices) and from DealOffer (limited-time promotional offers). Use this specifically for monetization tiers / IAP that grant ongoing benefits.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "PremiumDefinitions",
        "properties": {
          "Definitions": {
            "type": [
              "null",
              "object"
            ],
            "description": "List of premium subscription definitions for the title.",
            "additionalProperties": {
              "$ref": "#/definitions/PremiumDefinition"
            }
          }
        },
        "description": "Root container of premium subscriptions / premium passes for the title. Holds a dictionary of definitions keyed by PremiumID. Distinct from Store (in-game shop with virtual-currency prices) and from DealOffer (time-limited promotions)."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumDefinition": {
        "type": "object",
        "properties": {
          "Tier": {
            "type": "integer",
            "format": "int32",
            "description": "Product tier level (1, 2, 3...). Higher = more premium. Compared against SegmentGate.MinPremiumTier and similar gates."
          },
          "Benefits": {
            "type": [
              "null",
              "object"
            ],
            "description": "Free-form benefits granted to the subscriber. Keys are benefit slugs (e.g. 'ExpMult', 'GoldMult', 'DailyVipAccess', 'NoAds', 'SkinSlotBonus'). Values are numeric parameters (e.g. 1.2, 2.0, 1.0=true, 0.0=false, 5.0=slot count). Concrete keys are project-defined and consumed by game code.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "PremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stable premium product identifier (e.g. 'silver_vip', 'battle_pass_premium'). Never change after publication — references from Store/Season will break."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the product shown in the client / admin."
          },
          "DurationDays": {
            "type": "integer",
            "format": "int32",
            "description": "Subscription duration in days. 0 = permanent, 30 = monthly, 365 = yearly."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Payment options for the subscription (for different currencies or bundles). Key = PremiumPriceOption.OptionID, value = price definition. Multiple options allow paying with currency, items, or a bundle.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "TrialDurationDays": {
            "type": "integer",
            "format": "int32",
            "description": "Trial period length in days (e.g. 3 or 7). 0 = no trial."
          }
        },
        "description": "Definition of a single premium product (subscription, premium pass, VIP tier). Specifies identifier, tier, duration, prices (virtual currency and store products) and the benefits granted to the owner."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      }
    },
    "additionalProperties": false
  }

  arguments 435 lines copy
• get_reward unknown never probed

  GET ONLY the 'Reward' field of TitlePublicConfigurationModel. Reward templates — reusable bundles of currency + items + buffs that can be granted to a player. Referenced by Quest, TimedEvent, CoopEvent, Season, DailyLogin, Referral, etc. Define a reward once here, then reference it everywhere instead of inlining payouts.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_reward unknown never probed

  PARTIAL SAVE: writes ONLY the 'Reward' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Reward templates — reusable bundles of currency + items + buffs that can be granted to a player. Referenced by Quest, TimedEvent, CoopEvent, Season, DailyLogin, Referral, etc. Define a reward once here, then reference it everywhere instead of inlining payouts.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "RewardDefinitions",
        "properties": {
          "Claims": {
            "type": [
              "null",
              "object"
            ],
            "description": "Simple click-to-claim rewards. Supports one-shot bonuses, repeating claims with rolling-window limits, and server-triggered rewards. Empty/null disables the subsystem.",
            "additionalProperties": {
              "$ref": "#/definitions/ClaimRewardDefinition"
            }
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardPresetRegistry"
              }
            ],
            "description": "Registry of reusable reward config blocks. null = presets unused. Expanded once when the config is materialized (PlatformCache.ResolveCompositeSections)."
          },
          "Comebacks": {
            "type": [
              "null",
              "object"
            ],
            "description": "Comeback reward configs (return-after-absence). Each is an independent policy. Empty/null disables the subsystem.",
            "additionalProperties": {
              "$ref": "#/definitions/ComebackRewardDefinition"
            }
          },
          "TierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TierRewardSettings"
              }
            ],
            "description": "Global tier-reward resolution rules applied to all tiered systems of the title (premium, season, etc.). Null uses defaults (Additive / NoStack)."
          },
          "IdleAccruals": {
            "type": [
              "null",
              "object"
            ],
            "description": "Idle-income accruals. Each is an independent resource stream with its own rate, cap and activation requirements. Empty/null disables the subsystem.",
            "additionalProperties": {
              "$ref": "#/definitions/IdleAccrualDefinition"
            }
          },
          "DailyCalendars": {
            "type": [
              "null",
              "object"
            ],
            "description": "Daily-login calendars. Each calendar is an independent day-by-day progression. Empty/null disables the subsystem.",
            "additionalProperties": {
              "$ref": "#/definitions/DailyCalendarDefinition"
            }
          },
          "MilestoneRewardMultiplier": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardProgressionMultiplierSpec"
              }
            ],
            "description": "Title-wide progression-based milestone reward multiplier (cash multiplier). Applies to ALL milestones of every system (TimedEvent, Leaderboard, DealOffer, Quest, CommunityChest, Referral) via MilestoneRewardResolver as the last overlay. Targeting (IncludeRewards/ExcludeRewards, ResourceBundle by Type+ID; empty = all rewards) is configured in the spec. null = disabled."
          }
        },
        "description": "Root config for universal, system-agnostic rewards. Umbrella over four independent subsystems: DailyCalendars, IdleAccruals, Comebacks, Claims."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "CurvePoint": {
        "type": "object",
        "properties": {
          "Value": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Value at this point. Empty = the point is ignored."
          },
          "AtStep": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Step (level / rank / stage) at which this point takes effect. Empty = the point is ignored."
          }
        },
        "description": "One breakpoint of a table curve."
      },
      "CurveShape": {
        "enum": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "x-enum-descriptions": [
          "Value does not change with the step. Same behaviour as an unset curve.",
          "Additive in the value's own units: base + PerStep * (step - firstStep).",
          "Additive share of the base: base * (1 + PerStepRate * (step - firstStep)). 0.1 = +10% of base per step.",
          "Compounding: base * (1 + GrowthRate)^(step - firstStep).",
          "Table of multipliers over the base: base * interpolate(Points, step).",
          "Table of absolute values: interpolate(Points, step). The base is ignored."
        ]
      },
      "RewardMode": {
        "enum": [
          "Additive",
          "Replace"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Additive",
          "Replace"
        ],
        "x-enum-descriptions": [
          "Rewards are granted on top of the base Rewards.",
          "Rewards fully replace the base Rewards."
        ]
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ComebackTier": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Tier reward. Supports the full premium logic (PremiumBonuses / PremiumTiers)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Optional per-tier assets. Designer-defined keys.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "MinAbsenceSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum absence in seconds to qualify for this tier. Compared against (now - LastSeenAt).TotalSeconds at return time."
          }
        },
        "description": "One tier of a comeback reward."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "DailyClaimMode": {
        "enum": [
          "CalendarDayUtc",
          "SlidingWindow"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "CalendarDayUtc",
          "SlidingWindow"
        ],
        "x-enum-descriptions": [
          "New claim available on a new UTC date (LastClaimAt.Date < today). Simple and predictable; ignores player timezone.",
          "New claim available ClaimCooldownSeconds after the previous one. Timezone-friendly but the claim slot drifts over time."
        ]
      },
      "DailyRewardDay": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this day. Supports the full platform premium logic via PremiumBonuses / PremiumTiers."
          },
          "DayNumber": {
            "type": "integer",
            "format": "int32",
            "description": "Explicit day number (starting from 1). Unique within the calendar; next expected day = CollectedDays + 1."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Optional per-day assets (day icon, chest artwork). Designer-defined keys.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsMilestone": {
            "type": "boolean",
            "description": "UI flag for a milestone day (e.g. day 7/14/30). Does not affect server logic; only a hint for the client."
          }
        },
        "description": "Config of one day in a daily-rewards calendar."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "IdleRateConfig": {
        "type": "object",
        "properties": {
          "PowerCoefficient": {
            "type": "number",
            "format": "double",
            "description": "Coefficient multiplied by user.PublicData.Power and added to the rate. 0 disables the addend."
          },
          "BaseRatePerSecond": {
            "type": "number",
            "format": "double",
            "description": "Constant base rate in units per second. Applied to every player unconditionally."
          },
          "PremiumMultipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierMultiplier"
            },
            "description": "Premium rate multipliers. One best-matching multiplier is picked (highest MinPremiumTier) — multipliers do not stack. Defaults to 1.0 when none match."
          },
          "BoardRankCoefficient": {
            "type": "number",
            "format": "double",
            "description": "Coefficient multiplied by user.PublicData.BoardRank and added to the rate. 0 disables the addend."
          },
          "EquipmentCharacterID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Character from which to compute the equipment bonus. Null/empty falls back to DefaultData.Main."
          },
          "EquipmentBonusEnabled": {
            "type": "boolean",
            "description": "Whether to include the sum of IdleRateBonus from items equipped on EquipmentCharacterID. False disables the addend."
          }
        },
        "description": "Accrual rate formula composition. All addends are summed, then multiplied by the best matching premium multiplier."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ClaimRewardMode": {
        "enum": [
          "Manual",
          "Auto"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Manual",
          "Auto"
        ],
        "x-enum-descriptions": [
          "Player initiates the claim via the client API (RewardV2.ClaimReward).",
          "Server-only (background job, GM grant, anti-fraud compensation). Client ClaimReward is rejected."
        ]
      },
      "ScalarCurveSpec": {
        "type": "object",
        "properties": {
          "Base": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Base the curve is computed from. Empty = use the base supplied by the caller. Fill it only where the base is a publisher setting (a multiplier starting at 1.5, a table's value before its first point) — where the base comes from data (a stat value, a level price, an item bonus) leaving it empty is required, otherwise it overrides the real base."
          },
          "Shape": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveShape"
              }
            ],
            "description": "Curve shape. Empty = Flat, i.e. no growth."
          },
          "Points": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CurvePoint"
            },
            "description": "Table breakpoints (Shape=Table or TableAbsolute). Empty = no growth."
          },
          "PerStep": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Units added per step (Shape=PerStep). Empty or 0 = no growth."
          },
          "MaxResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Upper bound of the result. Empty = there is NO upper bound (not 0)."
          },
          "MinResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Lower bound of the result. Empty = there is NO lower bound (not 0)."
          },
          "GrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Compounding rate per step (Shape=Geometric): 0.1 = x1.1 per step. Empty or 0 = no growth."
          },
          "PerStepRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Share of the base added per step (Shape=PerStepRate): 0.1 = +10% of base per step. Empty or 0 = no growth."
          },
          "Interpolation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveInterpolation"
              }
            ],
            "description": "How to interpolate between points. Empty = Step."
          },
          "TailGrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Growth beyond the last table point (share per step). Empty = hold the last point's value."
          }
        },
        "description": "Scalar curve f(base, step): how a value grows with a level, rank, stage or count. THE MODULE'S RULE: an empty field does nothing — an unset curve is the identity f(base,n)=base, an unset bound means there is no bound. All rates are shares (0.1 = +10%), never multipliers, so 0 and empty always mean the same thing."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "DailyMissBehavior": {
        "enum": [
          "Forgiving",
          "ResetToStart",
          "ResetBy"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Forgiving",
          "ResetToStart",
          "ResetBy"
        ],
        "x-enum-descriptions": [
          "Miss has no effect; next day = CollectedDays + 1. Soft calendar.",
          "On miss, resets CollectedDays to 0. Streak calendar.",
          "On miss, rolls CollectedDays back by ResetByDays. Partial penalty."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ProgressionSource": {
        "enum": [
          "BoardStageLevel",
          "BoardRank",
          "BoardCyclesCompleted",
          "CharacterLevel",
          "SeasonTier",
          "EventTokenTotalEarned",
          "VirtualCurrencyBalance",
          "PlayerLevel"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardStageLevel",
          "BoardRank",
          "BoardCyclesCompleted",
          "CharacterLevel",
          "SeasonTier",
          "EventTokenTotalEarned",
          "VirtualCurrencyBalance",
          "PlayerLevel"
        ]
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "ClaimLimitOverride": {
        "type": "object",
        "properties": {
          "WindowSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Override for WindowSeconds. Null does not override."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier this override applies to."
          },
          "CooldownSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Override for CooldownSeconds. Null does not override."
          },
          "TotalClaimLimit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Override for TotalClaimLimit. Null does not override."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Specific premium-ID. Null means any subscription matching MinPremiumTier."
          },
          "MaxClaimsPerWindow": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Override for MaxClaimsPerWindow. Null does not override; 0 removes the limit for this tier."
          }
        },
        "description": "Per-tier override of limits and cooldown for a ClaimRewardDefinition. One best-matching override by MinPremiumTier is picked; null fields fall back to base values."
      },
      "CurveInterpolation": {
        "enum": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "x-enum-descriptions": [
          "Step: hold the previous point's value until the next one. Behaviour of an unset field.",
          "Linear between adjacent points.",
          "Geometric between adjacent points: lo * (hi/lo)^t."
        ]
      },
      "IdleFirstClaimMode": {
        "enum": [
          "EmptyOnFirstClaim",
          "InitOnFirstAccess",
          "AccruedFromConfigStart"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "EmptyOnFirstClaim",
          "InitOnFirstAccess",
          "AccruedFromConfigStart"
        ],
        "x-enum-descriptions": [
          "First claim yields 0 and sets LastCollectAt = now. No write on read; player forfeits the first accrual.",
          "On the very first access (incl. read-only), the server initializes LastCollectAt = now. Accrual starts on first sight; costs a DB write on first read.",
          "Accrual counted from AvailableFromUtc. Falls back to now when null. Late joiners get income for the elapsed period (capped by MaxAccumulationSeconds)."
        ]
      },
      "RewardAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who the reward is available to. null/empty = everyone. Resolved by SegmentGateEvaluator.Passes."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Claim limits (CooldownSeconds, MaxPerWindow + WindowSeconds, TotalCap). 0 on an axis = unlimited. null = no limits. Applies to ClaimRewardDefinition; unused by other reward types."
          }
        },
        "description": "Reward availability block: audience gate plus claim limits. Direct analogue of QuestAvailability and TimedBoostAvailability. All fields are nullable without initializers — required by preset merging. Read only via RewardDefinitionDefaults."
      },
      "TierRewardSettings": {
        "type": "object",
        "properties": {
          "RewardMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/RewardMode"
              }
            ],
            "description": "Tier-reward resolution mode. Additive: tier rewards are added on top of the base reward. Replace: tier rewards fully replace the base reward."
          },
          "RewardStackLowerTiers": {
            "type": "boolean",
            "description": "Whether lower-tier rewards stack with higher-tier ones. True: a player at tier 5 gets tiers 1..5 merged. False: only the best matching tier."
          }
        },
        "description": "Global tier-reward resolution rules applied to ALL tiered systems of the title (premium, season, battle pass, etc.). One mode per title."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "RewardPresetBindings": {
        "type": "object",
        "properties": {
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset binding for the Availability block."
          }
        },
        "description": "Container of preset wiring — one PresetBinding per block. Inline data lives on the definition itself. null = presets unused."
      },
      "RewardPresetRegistry": {
        "type": "object",
        "properties": {
          "Availability": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable availability blocks (gate + limits), keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/RewardAvailability"
            }
          }
        },
        "description": "Registry of reusable reward config blocks. The field mirrors the same-named definition block. Analogue of QuestPresetRegistry."
      },
      "ClaimRewardDefinition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ClaimRewardMode"
              }
            ],
            "description": "Who initiates the claim. Manual: player via client API. Auto: server-only (background job, GM grant, compensation); client calls are rejected."
          },
          "ClaimID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique identifier. Used as the key in UserRewardState.Claims. Must not contain '.' or '$'."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardPresetBindings"
              }
            ],
            "description": "Preset wiring (the Availability block). null = presets unused."
          },
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Reward to grant. Supports the full premium logic (PremiumBonuses / PremiumTiers)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary UI assets. Designer-defined keys.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description for UI/admin panel."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardAvailability"
              }
            ],
            "description": "Claim limits — unified LimitSpec: CooldownSeconds (min seconds between claims); MaxPerWindow + WindowSeconds (sliding \"N per M seconds\", checked against RecentClaimTimestamps, not calendar-aligned); TotalCap (all-time, 1 = one-shot). 0 on an axis = no limit. Per-tier overrides via PremiumLimitOverrides."
          },
          "AvailableFromUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Reward is unavailable before this UTC moment."
          },
          "AvailableUntilUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Reward is unavailable from this UTC moment onwards."
          },
          "PremiumLimitOverrides": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClaimLimitOverride"
            },
            "description": "Per-tier overrides of limits and cooldown for premium players. One best-matching override is picked (highest MinPremiumTier) — does not stack."
          }
        },
        "description": "Config of a simple claim reward. Covers one-shot, repeating-with-limits, and server-triggered scenarios; all limits are optional and combinable."
      },
      "IdleAccrualDefinition": {
        "type": "object",
        "properties": {
          "Rate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IdleRateConfig"
              }
            ],
            "description": "Rate composition. Final rate per second = (base + Power and BoardRank coefficients + equipment IdleRateBonus sum) × best premium multiplier."
          },
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base reward set. Standard amounts are multiplied by (accruedSeconds × finalRatePerSecond) at claim time. PremiumBonuses/PremiumTiers pass through to ResourceService."
          },
          "AccrualID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique accrual identifier. Used as the key in UserRewardState.IdleAccruals. Must not contain '.' or '$'."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary UI assets. Designer-defined keys.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description for UI/admin panel."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI."
          },
          "Requirements": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/IdleAccrualRequirements"
              }
            ],
            "description": "Activation requirements. All must be satisfied at claim time, otherwise the claim is denied. Denial does not move LastCollectAt."
          },
          "FirstClaimMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/IdleFirstClaimMode"
              }
            ],
            "description": "Behavior on the player's first access to this accrual (when LastCollectAt = MinValue)."
          },
          "MinClaimSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum seconds between two claims of the same accrual. Anti-spam. 0 means no limit."
          },
          "AvailableFromUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Accrual is unavailable before this UTC moment. Null means no lower bound. Also used as accrual-start with AccruedFromConfigStart."
          },
          "AvailableUntilUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Accrual is unavailable from this UTC moment onwards. Null means no upper bound."
          },
          "MaxAccumulationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Max accumulation time in seconds. Time beyond this is forfeited. 0 means no cap (risky for long-term economy)."
          }
        },
        "description": "Config of one idle-income accrual. Income accrues at IdleRateConfig while offline; claim computes accrued seconds (capped), applies the rate, and scales Rewards."
      },
      "PremiumTierMultiplier": {
        "type": "object",
        "properties": {
          "Multiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier value. 1.0 = neutral, 2.0 = double, 0.5 = half. Not clamped by the platform; consumer code is responsible for validating non-positive values."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Premium multiplier of an arbitrary value (e.g. idle accrual rate) — third type of premium modifier alongside PremiumTierBonus and PremiumTierDiscount. Best matching tier wins, multipliers do not stack. If no tier matches, effective multiplier is 1.0."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "DailyCalendarDefinition": {
        "type": "object",
        "properties": {
          "Days": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DailyRewardDay"
            },
            "description": "Per-day reward config sorted by DayNumber. Day numbers must be unique starting from 1."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardPresetBindings"
              }
            ],
            "description": "Preset wiring (the Availability block). null = presets unused."
          },
          "ClaimMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/DailyClaimMode"
              }
            ],
            "description": "Mode that determines when a new claim becomes available."
          },
          "IsLooping": {
            "type": "boolean",
            "description": "After the last day: true loops back to day 1 (infinite calendar); false stops giving rewards."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary UI assets (icon, banner, background, etc.). Designer-defined keys. Does not affect server logic.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "CalendarID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique calendar identifier. Used as the key in UserRewardState.DailyCalendars. Must not contain '.' or '$'."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description for UI/admin panel."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the calendar for UI."
          },
          "ResetByDays": {
            "type": "integer",
            "format": "int32",
            "description": "Used only with MissBehavior = ResetBy: number of days to roll CollectedDays back on miss. Lower bound is 0."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardAvailability"
              }
            ],
            "description": "Who can access the calendar — unified SegmentGate. null/empty = everyone. Lives in the Availability block so it can be shared via presets."
          },
          "MissBehavior": {
            "oneOf": [
              {
                "$ref": "#/definitions/DailyMissBehavior"
              }
            ],
            "description": "Action to take on a missed-window progress (see MissThresholdMultiplier)."
          },
          "AvailableFromUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Calendar is unavailable before this UTC moment. Null means no lower bound."
          },
          "AvailableUntilUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Calendar is unavailable from this UTC moment onwards. Null means no upper bound."
          },
          "ClaimCooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Used only with ClaimMode = SlidingWindow: minimum seconds between consecutive claims."
          },
          "MissThresholdMultiplier": {
            "type": "number",
            "format": "double",
            "description": "Allowed-miss multiplier. Default 2.0 means more than 2 claim units missed in a row triggers MissBehavior."
          }
        },
        "description": "Config of one daily-reward calendar: an ordered sequence of days with per-day rewards. Miss-behavior and claim-mode are calendar-level settings."
      },
      "IdleAccrualRequirements": {
        "type": "object",
        "properties": {
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardAvailability"
              }
            ],
            "description": "Premium/audience gate — unified SegmentGate. null/empty = not checked. (Gameplay requirements MinCharacterLevel/RequiredEquippedItemIDs stay separate.) Lives in the Availability block so it can be shared via presets."
          },
          "RequiredItemIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "ItemIDs each of which must be present in the player's inventory (TotalAmount > 0). Null/empty means the condition is not checked."
          },
          "MinCharacterLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum level of RequirementsCharacterID. 0 means the condition is not checked."
          },
          "RequiredEquippedItemIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "ItemIDs each of which must be equipped on RequirementsCharacterID. Null/empty means the condition is not checked."
          },
          "RequirementsCharacterID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Character against which MinCharacterLevel and RequiredEquippedItemIDs are checked. Null/empty falls back to DefaultData.Main."
          }
        },
        "description": "Accrual activation conditions. Each field is optional; all set conditions must hold simultaneously (AND)."
      },
      "ComebackRewardDefinition": {
        "type": "object",
        "properties": {
          "Tiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ComebackTier"
            },
            "description": "Reward tiers by absence duration. The tier with the largest matching MinAbsenceSeconds is locked when pending is fixed."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardPresetBindings"
              }
            ],
            "description": "Preset wiring (the Availability block). null = presets unused."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary UI assets. Designer-defined keys.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "ComebackID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique comeback config identifier. Used as the key in UserRewardState.Comebacks. Must not contain '.' or '$'."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description for UI/admin panel."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardAvailability"
              }
            ],
            "description": "Who can access the comeback — unified SegmentGate. null/empty = everyone. Lives in the Availability block so it can be shared via presets."
          },
          "AvailableFromUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Comeback is unavailable before this UTC moment."
          },
          "AvailableUntilUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Comeback is unavailable from this UTC moment onwards."
          },
          "ClaimWindowSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Seconds the pending reward stays available for claim after return. Beyond it the pending is cleared. 0 means infinite."
          },
          "TrackPresenceOnRead": {
            "type": "boolean",
            "description": "Whether to update LastSeenAt and fix pending in read-only methods. True tracks presence on any call; false confines updates to claim methods."
          },
          "ClaimCooldownSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum seconds between consecutive comeback claims of this config. 0 means no limit."
          }
        },
        "description": "Config of a single comeback reward (for return after long absence). Tier is locked at the moment of return, not at claim time."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "RewardProgressionMultiplierSpec": {
        "type": "object",
        "properties": {
          "Curve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Multiplier curve: how the multiplier grows with progress. Evaluated over a base of 1.0, so an unset curve means a multiplier of 1 and an unchanged reward. Shape/PerStep/Points/Interpolation/MinResult/MaxResult are documented on ScalarCurveSpec."
          },
          "Anchor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Progress value from which the curve starts counting. Empty = from zero."
          },
          "Source": {
            "oneOf": [
              {
                "$ref": "#/definitions/ProgressionSource"
              }
            ],
            "description": "Which player progression metric to read (see ProgressionSource)."
          },
          "SourceKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Extra key for sources that need a parameter: VirtualCurrencyBalance -> CurrencyID; SeasonTier -> SeasonChainID; EventTokenTotalEarned -> \"{bucket}:{entityID}\" (bucket: TimedEvent/Leaderboard/Season/CoopEvent/Quest/DealOffer); CharacterLevel -> CharacterID (empty = \"Main\"). Ignored for other sources."
          },
          "ExcludeRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Rewards to exclude (same ResourceBundle shape as IncludeRewards). Takes precedence: a reward matched by Type + ID is never scaled. null/empty = no exclusions."
          },
          "IncludeRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Rewards to scale — a strictly typed set (ResourceBundle): currencies/items in Entries (matched by Type + ID: ItemID for items, else CurrencyID), event tokens in EventTokens (matched by Address.EntityID). Entry Amount is ignored — this is a selector, not a grant. null/empty (no Entries and no EventTokens) = apply to ALL milestone rewards."
          }
        },
        "description": "Milestone overlay: progression-based reward multiplier (cash multiplier). Scales targeted milestone rewards of ANY type — currencies, items and event tokens — by a multiplier derived from a configurable player progression metric (Source) via a shared platform curve (ScalarCurveSpec). What gets scaled is a strictly typed set IncludeRewards/ExcludeRewards (ResourceBundle, matched by Type + ID); empty Include = ALL. Applied in RewardProgressionResolver inside MilestoneRewardResolver, after bonus-window and season-tier. null on a milestone = disabled."
      }
    },
    "additionalProperties": false
  }

  arguments 1703 lines copy
• get_user_custom_data unknown never probed

  GET ONLY the 'UserCustomData' field of TitlePublicConfigurationModel. Schema for per-player custom data fields — name, type, default value, visibility, whether the client can write it. This is the SCHEMA only; actual per-user values live on the User document. Use this to declare new player-specific stats, flags, or progress counters.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_user_custom_data unknown never probed

  PARTIAL SAVE: writes ONLY the 'UserCustomData' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Schema for per-player custom data fields — name, type, default value, visibility, whether the client can write it. This is the SCHEMA only; actual per-user values live on the User document. Use this to declare new player-specific stats, flags, or progress counters.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "UserCustomDataDefinitions",
        "properties": {
          "Keys": {
            "type": [
              "null",
              "object"
            ],
            "description": "Schema-managed keys. Dictionary key is UserCustomDataKeyDefinition.KeyID. Writes to these keys are validated against the schema (Bucket / ValueType / MaxValueLengthBytes / TtlSeconds). Unregistered keys are either treated as free-form or rejected based on RejectUnregisteredKeys.",
            "additionalProperties": {
              "$ref": "#/definitions/UserCustomDataKeyDefinition"
            }
          },
          "MaxKeysPerBucket": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of keys allowed per bucket (applied uniformly to Private/Public/ReadOnly/Internal). Protects against unbounded dictionary growth in the bson document. Recommended: 128."
          },
          "DefaultTtlSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Default TTL for unregistered keys, in seconds. null means no TTL (permanent). When set, free-form writes get ExpiresAt = now + DefaultTtlSeconds. Registered keys use their own TtlSeconds."
          },
          "MaxTotalSizeBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Total size limit of all Custom User Data V2 per player across all four buckets, in bytes. Protects against MongoDB's 16 MB bson document limit. Recommended: 1,500,000 (~1.5 MB)."
          },
          "RejectUnregisteredKeys": {
            "type": "boolean",
            "description": "If true, writes to unregistered keys are rejected (strict schema mode). If false, unregistered keys are accepted as free-form with default limits. Default: false."
          },
          "DefaultMaxValueLengthBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Default size limit of UserCustomDataRecord.Value in bytes (UTF-8). Applied to unregistered keys when RejectUnregisteredKeys = false. Registered keys use their own MaxValueLengthBytes. Recommended: 8192 (8 KB)."
          }
        },
        "description": "Configuration of the Custom User Data V2 system (arbitrary user records). Hybrid architecture combining bucket-based privacy separation (Private/Public/ReadOnly/Internal) with optional typed key schema."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "CustomDataBucket": {
        "enum": [
          "Private",
          "Public",
          "ReadOnly",
          "Internal"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Private",
          "Public",
          "ReadOnly",
          "Internal"
        ],
        "x-enum-descriptions": [
          "Visible only to the owner. Client can read and write. Examples: personal UI settings, tutorial progress, local preferences.",
          "Visible to the owner and to any other player via cross-user endpoints. Client can read and write its own. Examples: custom title, bio string, avatar frame color, badges.",
          "Visible only to the owner. Client can read but cannot write; only the server writes into this bucket. Examples: tutorial progress, server-side feature flags, A/B variants.",
          "Never returned to the client. Server jobs / admin / analytics only. Cross-user endpoints do not see this bucket. Examples: anti-cheat marks, risk score, segmentation metadata."
        ]
      },
      "CustomDataValueType": {
        "enum": [
          "String",
          "Int",
          "Bool",
          "Json"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "String",
          "Int",
          "Bool",
          "Json"
        ],
        "x-enum-descriptions": [
          "Arbitrary string. Validated by length only.",
          "Integer. Must parse as long via long.TryParse. Returned to the client as a string.",
          "Boolean. Must be \"true\" or \"false\" (case-insensitive, via bool.TryParse).",
          "Valid JSON document. Any structure parseable via JToken.Parse. Size limited by MaxValueLengthBytes."
        ]
      },
      "UserCustomDataKeyDefinition": {
        "type": "object",
        "properties": {
          "KeyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique identifier of the key across all buckets. Matches the key in UserCustomDataDefinitions.Keys and in the corresponding bucket dictionary. Must not contain '.' or '$'."
          },
          "Bucket": {
            "oneOf": [
              {
                "$ref": "#/definitions/CustomDataBucket"
              }
            ],
            "description": "Bucket where the record will physically reside. Defines both privacy (who reads) and writability (who writes). Fixed at config level; client cannot move the key between buckets."
          },
          "ValueType": {
            "oneOf": [
              {
                "$ref": "#/definitions/CustomDataValueType"
              }
            ],
            "description": "Expected format of UserCustomDataRecord.Value: String (arbitrary), Int (long.TryParse), Bool (\"true\"/\"false\"), or Json (valid JSON document). Validated by server before the DB patch."
          },
          "TtlSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Key TTL in seconds. null means no TTL (permanent record). When set, every write computes ExpiresAt = now + TtlSeconds. Expired records are filtered on read and atomically purged on next write to the same bucket."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Developer-facing description of the key's purpose for documentation. Not returned to the client in Get* operations and does not affect validation."
          },
          "DefaultValue": {
            "type": [
              "null",
              "string"
            ],
            "description": "Default value returned by the API when no record with this KeyID exists or it has expired. null means absent keys are returned as absent. Default is used on read only; not materialized in the DB until an explicit write."
          },
          "MaxValueLengthBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Hard size limit of UserCustomDataRecord.Value in bytes (UTF-8) for this key. Overrides UserCustomDataDefinitions.DefaultMaxValueLengthBytes. Writes exceeding the limit are rejected before the DB patch."
          }
        },
        "description": "Description of a single registered (schema-managed) Custom User Data V2 key. Defines a fixed Bucket and validation rules (ValueType / MaxValueLengthBytes / TtlSeconds) applied on every write."
      }
    },
    "additionalProperties": false
  }

  arguments 160 lines copy
• get_usage unknown never probed

  GET ONLY the 'Usage' field of TitlePublicConfigurationModel. Retention policy for the player's activity history (Usage). The engine keeps a rolling window of per-day records and folds everything older into monthly totals, then months of finished years into yearly totals — otherwise the per-day map grows forever inside the hottest document on the platform. WARNING: the fold is IRREVERSIBLE, per-day detail outside the window is gone for good. Do not lower DailyWindowDays below 400 without also lowering the analytics range cap: publisher analytics (DAU/WAU/MAU, retention cohorts, funnels) is computed lazily from those very per-day records, accepts ranges of up to 366 days, and needs 30 extra preceding days per requested day for MAU. Also holds SessionIdleTimeoutMinutes: how many minutes of silence end a session (default 30, the same rule Firebase/GA4 use, so the two reports stay comparable). The session boundary is decided by the SERVER from the player's last activity — the client's IsNewSession flag is not trusted for counting. Leave every field null unless you have a specific reason — the defaults (enabled, 400-day window, 30-minute session gap) are what the analytics horizon was sized against.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_usage unknown never probed

  PARTIAL SAVE: writes ONLY the 'Usage' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Retention policy for the player's activity history (Usage). The engine keeps a rolling window of per-day records and folds everything older into monthly totals, then months of finished years into yearly totals — otherwise the per-day map grows forever inside the hottest document on the platform. WARNING: the fold is IRREVERSIBLE, per-day detail outside the window is gone for good. Do not lower DailyWindowDays below 400 without also lowering the analytics range cap: publisher analytics (DAU/WAU/MAU, retention cohorts, funnels) is computed lazily from those very per-day records, accepts ranges of up to 366 days, and needs 30 extra preceding days per requested day for MAU. Also holds SessionIdleTimeoutMinutes: how many minutes of silence end a session (default 30, the same rule Firebase/GA4 use, so the two reports stay comparable). The session boundary is decided by the SERVER from the player's last activity — the client's IsNewSession flag is not trusted for counting. Leave every field null unless you have a specific reason — the defaults (enabled, 400-day window, 30-minute session gap) are what the analytics horizon was sized against.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "UsageDefinitions",
        "properties": {
          "RollupEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Master switch for usage history rollup (days -> months -> years). Null = enabled. Turn off temporarily when you need full per-day history retained; the rollup is irreversible."
          },
          "DailyWindowDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many recent days are kept per-day before being folded into monthly totals. Null = 400. Do not set below 400 unless you also lower the analytics range cap: publisher analytics reads these per-day records lazily, accepts a range of up to 366 days, and each requested day additionally needs the 30 preceding days for MAU."
          },
          "MaxDaysFoldedPerPass": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max per-day records folded in a single login. Null = 400. Not a gameplay limit — just batch size; the remainder is folded on the next login."
          },
          "SessionIdleTimeoutMinutes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Minutes of inactivity that end a session. Null = 30 (same rule as Firebase/GA4, so the two reports stay comparable). The boundary is decided by the server from the player's last activity — the client's IsNewSession flag is not trusted for counting."
          }
        },
        "description": "New value for the Usage field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 52 lines copy
• get_timed_event unknown never probed

  GET ONLY the 'TimedEvent' field of TitlePublicConfigurationModel. Solo time-limited events — daily challenges, weekly missions, holiday events, login streaks. Defines event IDs, schedules (start/end/recurrence), objectives, progress tracking, milestone rewards. For multi-player team events use CoopEvent; for long-form battle-pass-style progression use Season.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_timed_event unknown never probed

  PARTIAL SAVE: writes ONLY the 'TimedEvent' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Solo time-limited events — daily challenges, weekly missions, holiday events, login streaks. Defines event IDs, schedules (start/end/recurrence), objectives, progress tracking, milestone rewards. For multi-player team events use CoopEvent; for long-form battle-pass-style progression use Season.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "TimedEventDefinitions",
        "properties": {
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedEventPresetRegistry"
              }
            ],
            "description": "Registry of reusable event presets (milestones / token sources). Phases/events reference them via EventContent.Presets. null = unused."
          },
          "Settings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitedTimeEventsGlobalSettings"
              }
            ],
            "description": "Global settings shared across all events."
          },
          "Definitions": {
            "type": [
              "null",
              "object"
            ],
            "description": "All title events (both Scheduled and Chained) in one dictionary keyed by TimedEventID. The mode (single window vs chain) is determined by Schedule.Mode.",
            "additionalProperties": {
              "$ref": "#/definitions/TimedEventDefinition"
            }
          }
        },
        "description": "Root configuration of the limited-time events system. Lives at the top level of TitlePublicConfiguration, separate from GameLoops/Quests/Store. Supports both Scheduled (fixed-date) and Chain (cyclic) events."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "EventContent": {
        "type": "object",
        "properties": {
          "Token": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenDefinition"
              }
            ],
            "description": "Event token definition. The token is a separate entity, NOT a VirtualCurrency. Stored in UserEventProgress rather than the VirtualCurrency dictionary."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedEventPresetBindings"
              }
            ],
            "description": "Container of content preset wiring (milestones / token sources). null = presets unused. Resolved by PresetResolver."
          },
          "Category": {
            "type": [
              "null",
              "string"
            ],
            "description": "Category/tag for UI grouping. Examples: \"seasonal\", \"special\", \"mini\", \"collab\"."
          },
          "ClaimMode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MilestoneClaimMode"
              }
            ],
            "description": "null = unset, platform default applies (see TimedEventDefinitionDefaults.EffectiveClaimMode). Read only via that accessor. When set: Instant = as soon as the threshold is reached, AfterEventEnd = only after the event ends, FeaturedAfterEnd = regular ones instantly, IsFeatured ones after the end."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Event images (icon, banner, background, etc.). Developer chooses keys and meaning.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone rewards earned after accumulating a certain amount of tokens. Checked against TokensEarnedTotal (not the current balance). When Presets.Milestones is set, this is the override/add layer on top of the preset (merge).",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          },
          "BonusWindow": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BonusWindowConfig"
              }
            ],
            "description": "Cyclic window of boosted rewards (Coin Master-style). Global schedule across all players. When the bonus phase is active, BonusRewards are added to the base Rewards. null = window disabled for this event."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event description shown in the UI. Example: \"Collect Pumpkin Coins and earn spooky rewards!\""
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event display name shown in the UI. Example: \"Halloween Havoc\", \"Raid Rush\", \"Golden Hour\"."
          },
          "TokenSources": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Whitelist of token sources. Developer explicitly enumerates which systems may grant tokens for this event. Sources not on the list are blocked. Uses the unified TriggerSource (BaseWeight = tokens per trigger; Limits = anti-farm caps). Sources not on the list are blocked."
          }
        },
        "description": "Event content: display, token, sources, rewards, shop. Unified structure used by both ScheduledEvent and ChainedEvent."
      },
      "MilestoneSet": {
        "type": "object",
        "properties": {
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone set keyed by MilestoneID (same shape as the inline Milestones dictionary).",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          }
        },
        "description": "Thin wrapper for a reusable milestone set. Its single field mirrors the inline shape (EventContent.Milestones / LeaderboardDefinition.Milestones / DealOfferDefinition.Milestones) so the resolver returns a compatible dictionary. Cross-module type (used by TimedEvent, Leaderboard, DealOffer) -- lives in Core next to MilestoneDefinition. Resolved by PresetResolver.MergeDictionary."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "BonusWindowPhase": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/BonusWindowPhaseType"
              }
            ],
            "description": "Phase type: bonus or cooldown."
          },
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Phase index within Schedule (0-based). Defines sequence independent of list position so reordering does not break phase identity in analytics/logs. Unique within a Schedule."
          },
          "DurationSec": {
            "type": "integer",
            "format": "int64",
            "description": "Phase duration (seconds). Must be > 0."
          },
          "BonusMultiplier": {
            "type": "number",
            "format": "float",
            "description": "Multiplier applied to BonusRewards. Used only when Type = MultipliedBonus. 1.5 = bonus part x1.5, 0.5 = x0.5. Ignored for Bonus (always 1.0) and Cooldown (always 0)."
          }
        },
        "description": "A single phase in the window schedule."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "BonusWindowConfig": {
        "type": "object",
        "properties": {
          "Schedule": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/BonusWindowPhase"
            },
            "description": "Sequence of phases from the start of the event. Each entry is one phase with a type (bonus/cooldown) and duration. Empty list = window effectively disabled."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full passes through Schedule (relevant only when RepeatCycle = true). 0 = infinite (while the event is active). After the limit, no more windows open."
          },
          "RepeatCycle": {
            "type": "boolean",
            "description": "true: after the last phase the cycle restarts from the first until the event ends. false: after all phases pass, no more windows open."
          }
        },
        "description": "Bonus window config for a single event. Lives in EventContent.BonusWindow and works the same for Scheduled events and chain phases (ChainedEventDefinition). null = window disabled."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "MilestoneClaimMode": {
        "enum": [
          "Instant",
          "AfterEventEnd",
          "FeaturedAfterEnd"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Instant",
          "AfterEventEnd",
          "FeaturedAfterEnd"
        ],
        "x-enum-descriptions": [
          "Claim instantly when the threshold is reached (accumulated progress >= RequiredProgress). Simplest, most predictable mode.",
          "Claim only after the instance ends (within the system's grace window, if any). All milestones accumulate and are claimed in one batch. Motivates playing to the end.",
          "Hybrid: regular milestones (IsFeatured = false) claim instantly; featured ones (IsFeatured = true) only after the instance ends."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "MilestoneDefinition": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base rewards. Always granted on a successful claim."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order in the UI (lower = higher/earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone images (icon, badge). null = unset.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsFeatured": {
            "type": "boolean",
            "description": "Featured milestone: special UI styling. With MilestoneClaimMode.FeaturedAfterEnd these can only be claimed after the instance ends."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI/CMS. null = unset."
          },
          "MilestoneID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique milestone ID within its owning entity (Mongo-safe, claim idempotency key)."
          },
          "BonusRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Bonus-window overlay: extra rewards on top of Rewards when the bonus phase is active at claim time (MilestoneRewardContext.BonusActive). Applied via MilestoneRewardResolver. null = no bonus part."
          },
          "RequiredProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Threshold over ACCUMULATED progress to unlock. EventToken systems: EventTokenBalanceData.TotalEarned (not current balance). CommunityChest: shared group progress."
          },
          "SeasonTierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SeasonTierRewardSet"
              }
            ],
            "description": "Season-tier overlay: reward scaling by the player's season tier. Applied via MilestoneRewardResolver (SeasonTierRewardResolver.Resolve) only when MilestoneRewardContext.SeasonChainID is set. null = disabled."
          }
        },
        "description": "Unified milestone primitive for all platform systems (TimedEvent, Leaderboard, Quest, CommunityChest, DealOffer). Replaces the per-module milestone definitions. Threshold is checked against accumulated progress (RequiredProgress): EventToken systems use EventTokenBalanceData.TotalEarned; CommunityChest uses shared group progress. Reward overlays BonusRewards (bonus-window) and SeasonTierRewards (season-tier) are platform-wide optional fields applied via MilestoneRewardResolver; leave null if unused."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "SeasonTierRewardSet": {
        "type": "object",
        "properties": {
          "Bundles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardBundle"
            },
            "description": "Structurally different rewards for specific tiers. On match, replaces the base ResourceGrant entirely (Replace)."
          },
          "Multipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardMultiplier"
            },
            "description": "Multipliers applied to Amount of the base ResourceGrant. Used ONLY if no Bundles entry matched."
          }
        },
        "description": "Generic container of season-tier reward scaling. Used by any platform system (leaderboards, lootboxes, shop, daily) that wants to scale a ResourceGrant by the player's current tier in a season chain. Empty/null lists = neutral."
      },
      "BonusWindowPhaseType": {
        "enum": [
          "Cooldown",
          "Bonus",
          "MultipliedBonus"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Cooldown",
          "Bonus",
          "MultipliedBonus"
        ],
        "x-enum-descriptions": [
          "Cooldown phase: only base Rewards are granted.",
          "Bonus phase: milestone BonusRewards are granted.",
          "Boosted-bonus phase: BonusRewards scaled by BonusMultiplier. Can amplify (1.5, 2.0) or weaken (0.5) the bonus part."
        ]
      },
      "EventTokenConversion": {
        "type": "object",
        "properties": {
          "Rate": {
            "type": "number",
            "format": "double",
            "description": "Conversion rate: 1 event token = Rate units of the target currency. Example: 0.1 means 10 tokens = 1 unit of currency."
          },
          "MaxConvertAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Max number of tokens eligible for conversion. Inflation guard — if the player has 100000 tokens, only up to MaxConvertAmount is converted."
          },
          "TargetCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "What to convert to (VirtualCurrency ID). Example: \"IG\" (in-game gold), \"DICE\"."
          }
        },
        "description": "Conversion rules for event tokens at burn. Lets the platform compensate the player for unused tokens."
      },
      "EventTokenDefinition": {
        "type": "object",
        "properties": {
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Token images: icon and similar assets.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "MaxBalance": {
            "type": "integer",
            "format": "int64",
            "description": "Max token balance the player can accumulate. 0 = unlimited. Protects against unbounded accrual."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Token name shown in UI. Example: \"Pumpkin Coins\", \"Raid Points\"."
          },
          "MaxPerGrant": {
            "type": "integer",
            "format": "int64",
            "description": "Max tokens per single grant (anti-abuse). Caps the maximum portion of a single grant."
          },
          "DailyEarnCap": {
            "type": "integer",
            "format": "int64",
            "description": "Max tokens per day across all sources. 0 = unlimited. Global daily cap."
          },
          "BurnConversion": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenConversion"
              }
            ],
            "description": "Conversion rules for the leftover balance at burn. If set, the remainder is converted to the specified VirtualCurrency. null = balance is zeroed without compensation."
          },
          "BurnOnEventEnd": {
            "type": "boolean",
            "description": "Whether tokens burn at event end. true = balance is zeroed (or converted via BurnConversion). false = tokens persist (collectible)."
          }
        },
        "description": "Event-token definition. An event token is a separate entity, not a VirtualCurrency. Balance lives in UserEventProgress.TokenBalance, ensuring isolation between events and automatic burn-on-end behavior."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "TimedEventDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate for the event — standard SegmentGate (Core/Segment), like Store/Reward/TimedBoost/Quest/Experiment. null = available to all. Players failing the gate do not see the event among active ones and cannot grant/spend its tokens."
          },
          "Events": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ChainedEventDefinition"
            },
            "description": "Chain phases for Mode = Chained (each with its own DurationSec and Content). After the last phase the cycle restarts. Empty for Scheduled."
          },
          "Content": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventContent"
              }
            ],
            "description": "Event content for Mode = Scheduled (token, sources, rewards, milestones, bonus window). For Chained the content lives on the phases (ChainedEventDefinition.Content)."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Unified schedule container. Mode = Scheduled (single window Schedule.Scheduled) or Chained (chain Schedule.Chain + Events). On/off via Schedule.IsActive."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Images (icon, banner, background). Keys chosen by the developer.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description for UI."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI (chain name for Chained; Scheduled may use Content.DisplayName)."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary developer-defined key/value parameters.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "TimedEventID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique event/chain ID (e.g. \"halloween_2026\", \"main_rotation\"). Key in TimedEventDefinitions.Definitions and in the player state."
          }
        },
        "description": "Definition of a single event. The mode lives in Schedule (Mode = Scheduled | Chained): Scheduled = single window (Schedule.Scheduled) + the single Content; Chained = chain of phases (Schedule.Chain) + Events (each phase has its own Content). One dictionary TimedEventDefinitions.Definitions keyed by TimedEventID."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "ChainedEventDefinition": {
        "type": "object",
        "properties": {
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Position in the chain (0, 1, 2...). Defines the event sequence."
          },
          "Content": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventContent"
              }
            ],
            "description": "Event content: display, token, sources, rewards, etc."
          },
          "DurationSec": {
            "type": "integer",
            "format": "int64",
            "description": "Event duration in seconds. Examples: 1800 = 30 min, 7200 = 2 h, 86400 = 1 day, 259200 = 3 days."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary developer-defined parameters for this event.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "ChainedEventID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event ID within the chain (e.g. \"chain_event_1\", \"mini_raid_rush\"). Unique within the chain."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace period (in hours) for claiming rewards after this event ends. 0 = no post-event claim, only while the event is active."
          }
        },
        "description": "A single event inside a cyclic chain. Dates are not set manually — computed from AnchorUtc plus the DurationSec of preceding events."
      },
      "SeasonTierRewardBundle": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this tier. Passed unmodified into ResourceService via a regular ResourceOperation.Grant."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this bundle to apply. Matches SeasonTierDefinition.Tier / UserSeasonState.CurrentTier."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to. Selection matches only tiers with the same SeasonChainID."
          }
        },
        "description": "Structurally different rewards for a season-chain tier. Analogous to PremiumTierBundle but the trigger is the player's season tier. Selection picks the single best match (MinSeasonTier <= playerTier); not stacked."
      },
      "TimedEventPresetBindings": {
        "type": "object",
        "properties": {
          "Milestones": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Milestones preset binding (merge by MilestoneID; Remove drops keys)."
          }
        },
        "description": "Container of preset wiring for event content — one PresetBinding per block. Inline data (Milestones) lives on EventContent. null = presets unused."
      },
      "TimedEventPresetRegistry": {
        "type": "object",
        "properties": {
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable milestone sets (shared MilestoneSet) keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneSet"
            }
          }
        },
        "description": "Container of event preset registries. Each field is a dictionary keyed by PresetID. Resolved at read-time via PresetResolver (milestones merge by MilestoneID)."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "SeasonTierRewardMultiplier": {
        "type": "object",
        "properties": {
          "Multiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier. 1.0 = neutral (resolver returns the base reward without copying). Rounding: (long)Math.Round(Amount * Multiplier). Entries with final Amount <= 0 are dropped."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this multiplier to apply."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to."
          }
        },
        "description": "Multiplier applied to Amount of the base ResourceGrant for a season-chain tier. Applied to every ResourceEntry.Amount and EventTokenOperation.Amount in Standard and in PremiumTiers.Resources."
      },
      "LimitedTimeEventsGlobalSettings": {
        "type": "object",
        "properties": {
          "MaxConcurrentEvents": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of simultaneously active events. Guards against config mistakes such as 20 overlapping events."
          }
        },
        "description": "Global settings of the events system. Apply to all events unless overridden at the event level."
      }
    },
    "additionalProperties": false
  }

  arguments 1632 lines copy
• get_coop_event unknown never probed

  GET ONLY the 'CoopEvent' field of TitlePublicConfigurationModel. Cooperative multi-player events — guild raids, server-wide goals, leaderboard tournaments where players contribute together. Distinct from TimedEvent (solo) and Leaderboard (pure ranking). Defines participation rules, shared progress, contribution tracking, and tiered rewards based on collective performance.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_coop_event unknown never probed

  PARTIAL SAVE: writes ONLY the 'CoopEvent' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Cooperative multi-player events — guild raids, server-wide goals, leaderboard tournaments where players contribute together. Distinct from TimedEvent (solo) and Leaderboard (pure ranking). Defines participation rules, shared progress, contribution tracking, and tiered rewards based on collective performance.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "CoopEventDefinitions",
        "properties": {
          "Chains": {
            "type": [
              "null",
              "object"
            ],
            "description": "All coop event chains of the title. Dictionary key is CoopChainID.",
            "additionalProperties": {
              "$ref": "#/definitions/CoopEventChainDefinition"
            }
          }
        },
        "description": "Root configuration of the title's cooperative events system. Plugs into TitlePublicConfigurationModel as CoopEvent."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "CoopEventType": {
        "enum": [
          "BuildObjects",
          "BossAttack"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BuildObjects",
          "BossAttack"
        ]
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "CoopSpinnerSector": {
        "type": "object",
        "properties": {
          "Weight": {
            "type": "integer",
            "format": "int32",
            "description": "Sector weight (arbitrary scale, does not need to sum to 100). Probability = Weight / sum(all Weights). Example: [40, 35, 20, 5] = 40%, 35%, 20%, 5%."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset paths for the sector (icon, color).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Sector display name. Example: \"Small\", \"Medium\", \"Big\", \"Jackpot\"."
          },
          "MaxProgress": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of progress points awarded by this sector. Actual value is picked uniformly at random in [MinProgress; MaxProgress]."
          },
          "MinProgress": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum number of progress points awarded by this sector."
          }
        },
        "description": "A single sector on the coop event spinner. Defines its drop probability and the range of progress points awarded."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "CoopEventDefinition": {
        "type": "object",
        "properties": {
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Position in the chain (0, 1, 2...)."
          },
          "EventType": {
            "oneOf": [
              {
                "$ref": "#/definitions/CoopEventType"
              }
            ],
            "description": "Event mechanic type. Determines which config blocks are used."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset paths for the event (icon, banner).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "GrandPrize": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Grand Prize — granted to every group member when all 4 objects are completed before the event timer expires. Grant-only via ResourceGrant (Standard + optional PremiumTiers)."
          },
          "CoopEventID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique event ID within the chain (e.g. \"coop_fairytale_partners_1\")."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event description for the UI."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event display name."
          },
          "DurationSec": {
            "type": "integer",
            "format": "int64",
            "description": "Event duration in seconds. Typical: 5–7 days = 432,000 – 604,800 sec."
          },
          "BuildObjects": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CoopBuildObjectsDefinition"
              }
            ],
            "description": "BuildObjects mechanic data. Populated only when EventType = BuildObjects."
          },
          "PartnerCount": {
            "type": "integer",
            "format": "int32",
            "description": "Number of partners (excluding the initiator). Fixed at 4 — group size is 1 + PartnerCount = 5 members."
          },
          "MemberGracePeriodMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "Grace period when a member leaves (minutes). The slot remains reserved during this window; afterwards it opens for a new player."
          },
          "MatchmakingTimeoutMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "Partner matchmaking timeout (minutes). Unfilled slots are taken by bots after the timeout."
          }
        },
        "description": "A single coop event inside a chain. Defines duration, group parameters, spinner and rewards."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "CoopObjectDefinition": {
        "type": "object",
        "properties": {
          "Index": {
            "type": "integer",
            "format": "int32",
            "description": "Object index (0..3). Matches CoopGroupMember.ObjectIndex."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset paths for the object (images of build stages).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Object display name."
          },
          "MaxProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum progress points. The object is considered complete on reaching it."
          },
          "CompletionReward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Interim reward granted to the member when their object is completed. Granted regardless of the other objects' state. Grant-only via ResourceGrant (Standard + optional PremiumTiers)."
          }
        },
        "description": "Configuration of a single build object in a coop event. Each group member is responsible for one object — their spins contribute to that object's progress."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "CoopEventChainDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate for the chain — standard SegmentGate (Core/Segment), like Store/Reward/TimedBoost/Quest/Experiment. null = available to all. Players failing the gate do not see the active coop event and cannot join groups."
          },
          "Events": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CoopEventDefinition"
            },
            "description": "Ordered list of events in the chain. Sort by CoopEventDefinition.Order ASC."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Unified schedule container (Mode = Chained). Holds anchor, pauses, MaxCycles, global on/off (Schedule.IsActive) and advancement style in Schedule.Chain. Phase geometry lives in Events."
          },
          "CoopChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique chain ID within the title."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Chain display name."
          }
        },
        "description": "Coop event chain. Analogous to TimedEventDefinition (Chained) and SeasonChainDefinition — same cyclic-schedule mechanic."
      },
      "CoopBuildObjectsDefinition": {
        "type": "object",
        "properties": {
          "Objects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CoopObjectDefinition"
            },
            "description": "Build object configurations (one per partner)."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay. Dictionary key = PriceOption.OptionID; the player picks one. Empty/null = free.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "SpinnerTable": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CoopSpinnerSector"
            },
            "description": "Spinner probability table."
          },
          "MaxSpinsPerCall": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max spins per single Spin call. null = platform default (CoopEventDefinitionDefaults.DefaultMaxSpinsPerCall). <= 0 = spinning disabled. Only spins that actually happen are charged: if the object completes before the requested count is exhausted, the remainder is neither rolled nor charged. Read only via CoopEventDefinitionDefaults.EffectiveMaxSpinsPerCall."
          }
        },
        "description": "BuildObjects mechanic config. Holds everything specific to the build mechanic: objects, spinner, spin cost."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      }
    },
    "additionalProperties": false
  }

  arguments 1360 lines copy
• get_leaderboard unknown never probed

  GET ONLY the 'Leaderboard' field of TitlePublicConfigurationModel. Leaderboard definitions — name, ranking metric (score type), reset cadence (daily/weekly/seasonal/perpetual), tier-based rewards, eligibility rules. Use for pure player-vs-player ranking. For collaborative team goals use CoopEvent.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_leaderboard unknown never probed

  PARTIAL SAVE: writes ONLY the 'Leaderboard' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Leaderboard definitions — name, ranking metric (score type), reset cadence (daily/weekly/seasonal/perpetual), tier-based rewards, eligibility rules. Use for pure player-vs-player ranking. For collaborative team goals use CoopEvent.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "LeaderboardDefinitions",
        "properties": {
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LeaderboardPresetRegistry"
              }
            ],
            "description": "Registry of reusable leaderboard presets (milestones / rank ladders / score sources). Leaderboards reference them via LeaderboardDefinition.Presets. null = unused."
          },
          "Definitions": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/definitions/LeaderboardDefinition"
            }
          }
        },
        "description": "New value for the Leaderboard field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "MilestoneSet": {
        "type": "object",
        "properties": {
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone set keyed by MilestoneID (same shape as the inline Milestones dictionary).",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          }
        },
        "description": "Thin wrapper for a reusable milestone set. Its single field mirrors the inline shape (EventContent.Milestones / LeaderboardDefinition.Milestones / DealOfferDefinition.Milestones) so the resolver returns a compatible dictionary. Cross-module type (used by TimedEvent, Leaderboard, DealOffer) -- lives in Core next to MilestoneDefinition. Resolved by PresetResolver.MergeDictionary."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "RankRewardSet": {
        "type": "object",
        "properties": {
          "RankRewards": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LeaderboardRankReward"
            }
          }
        },
        "description": "Thin wrapper for a reusable rank-reward ladder. Its field mirrors the inline LeaderboardDefinition.RankRewards shape."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "MilestoneClaimMode": {
        "enum": [
          "Instant",
          "AfterEventEnd",
          "FeaturedAfterEnd"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Instant",
          "AfterEventEnd",
          "FeaturedAfterEnd"
        ],
        "x-enum-descriptions": [
          "Claim instantly when the threshold is reached (accumulated progress >= RequiredProgress). Simplest, most predictable mode.",
          "Claim only after the instance ends (within the system's grace window, if any). All milestones accumulate and are claimed in one batch. Motivates playing to the end.",
          "Hybrid: regular milestones (IsFeatured = false) claim instantly; featured ones (IsFeatured = true) only after the instance ends."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "MilestoneDefinition": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base rewards. Always granted on a successful claim."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order in the UI (lower = higher/earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone images (icon, badge). null = unset.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsFeatured": {
            "type": "boolean",
            "description": "Featured milestone: special UI styling. With MilestoneClaimMode.FeaturedAfterEnd these can only be claimed after the instance ends."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI/CMS. null = unset."
          },
          "MilestoneID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique milestone ID within its owning entity (Mongo-safe, claim idempotency key)."
          },
          "BonusRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Bonus-window overlay: extra rewards on top of Rewards when the bonus phase is active at claim time (MilestoneRewardContext.BonusActive). Applied via MilestoneRewardResolver. null = no bonus part."
          },
          "RequiredProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Threshold over ACCUMULATED progress to unlock. EventToken systems: EventTokenBalanceData.TotalEarned (not current balance). CommunityChest: shared group progress."
          },
          "SeasonTierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SeasonTierRewardSet"
              }
            ],
            "description": "Season-tier overlay: reward scaling by the player's season tier. Applied via MilestoneRewardResolver (SeasonTierRewardResolver.Resolve) only when MilestoneRewardContext.SeasonChainID is set. null = disabled."
          }
        },
        "description": "Unified milestone primitive for all platform systems (TimedEvent, Leaderboard, Quest, CommunityChest, DealOffer). Replaces the per-module milestone definitions. Threshold is checked against accumulated progress (RequiredProgress): EventToken systems use EventTokenBalanceData.TotalEarned; CommunityChest uses shared group progress. Reward overlays BonusRewards (bonus-window) and SeasonTierRewards (season-tier) are platform-wide optional fields applied via MilestoneRewardResolver; leave null if unused."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "SeasonTierRewardSet": {
        "type": "object",
        "properties": {
          "Bundles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardBundle"
            },
            "description": "Structurally different rewards for specific tiers. On match, replaces the base ResourceGrant entirely (Replace)."
          },
          "Multipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardMultiplier"
            },
            "description": "Multipliers applied to Amount of the base ResourceGrant. Used ONLY if no Bundles entry matched."
          }
        },
        "description": "Generic container of season-tier reward scaling. Used by any platform system (leaderboards, lootboxes, shop, daily) that wants to scale a ResourceGrant by the player's current tier in a season chain. Empty/null lists = neutral."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "LeaderboardDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate for the leaderboard — standard SegmentGate (Core/Segment), like Store/Reward/TimedBoost/Quest/Experiment. null = available to all. Players failing the gate neither see the leaderboard nor submit scores to it."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LeaderboardPresetBindings"
              }
            ],
            "description": "Container of leaderboard preset wiring (milestones / rank ladder / score sources). null = presets unused. Resolved by PresetResolver."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Unified leaderboard schedule container (shared ScheduleSpec): Mode (Cyclic = calendar cycles by Schedule.Cyclic.Reset; Scheduled = single window Schedule.Scheduled; Chained = chain Schedule.Chain + ChainEvents) and global on/off Schedule.IsActive. For Scheduled/Chained each instance is an independent leaderboard (own top, brackets, RankRewards, Milestones, token, season scaling)."
          },
          "IsEnabled": {
            "type": "boolean",
            "description": "Whether the leaderboard is enabled. false = SubmitScore is rejected."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            }
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone rewards for accumulating ScoreEarnedThisCycle within one cycle. Independent of the final rank — a parallel progress track. When Presets.Milestones is set, this is the override/add layer on top of the preset (merge).",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          },
          "BracketSize": {
            "type": "integer",
            "format": "int32",
            "description": "Size of one bracket (number of players). 0 = brackets disabled, global top is used. Default 50."
          },
          "ChainEvents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LeaderboardChainedEvent"
            },
            "description": "Ordered list of chain events. Used only when Schedule.Mode = Chained. Each (cycleIndex, ChainedEventID) is an independent leaderboard instance."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for the UI."
          },
          "RankRewards": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LeaderboardRankReward"
            },
            "description": "Rewards for the final ranks at the end of the cycle. When Presets.RankRewards is set, merged with the preset by Rank key (preset base + inline override/add), Remove drops keys."
          },
          "ScoreSources": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Server-side score sources. A leaderboard accrues score automatically from game events (board landings/attacks/raids/builds/stages, plus Quest/Store/CustomAction, etc.) matching these sources, instead of relying solely on client SubmitScore. Empty = client-submit only. Uses the unified TriggerSource (BaseWeight = score per trigger; Limits left null — leaderboards apply no anti-farm caps). Empty = client-submit only."
          },
          "LeaderboardID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique leaderboard ID. Mongo-safe (no '.' or '$'). Examples: \"weekly_pvp\", \"all_time_coins\", \"monthly_raids\"."
          },
          "TopUsersLimit": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of users stored in TopUsers (LeaderboardCycleDocument). Entries beyond this limit are not stored."
          },
          "ScoreAggregation": {
            "oneOf": [
              {
                "$ref": "#/definitions/LeaderboardScoreAggregation"
              }
            ],
            "description": "Aggregation method combining a new submitted score with the user's current value within one cycle."
          },
          "ScoreDisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the score unit for the UI. Examples: \"Points\", \"Coins\", \"Wins\"."
          },
          "MilestoneClaimMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/MilestoneClaimMode"
              }
            ],
            "description": "Milestone claim mode. Instant: as soon as the threshold is reached. AfterCycleEnd: only after the cycle ends."
          },
          "MinScoreToEnterTop": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum score required to enter TopUsers."
          },
          "LinkedSeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Linked SeasonChainID for season-tier reward scaling (rank and milestone rewards). null/empty = season scaling disabled and SeasonTierRewards on rewards/milestones are ignored."
          },
          "MilestoneClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end during which previous-cycle milestones can still be claimed. 0 = current cycle only. Required for MilestoneClaimMode AfterEventEnd/FeaturedAfterEnd to work. Client claims a past cycle by sending its CycleKey from GetMyProgressResponse.ClaimableGraceCycles. Also gates token-bucket pruning (removed only after CycleEnd + grace)."
          }
        }
      },
      "LeaderboardRankReward": {
        "type": "object",
        "properties": {
          "Rank": {
            "type": [
              "null",
              "string"
            ],
            "description": "Rank range. Formats: \"1\", \"2-5\", \"6-10\", \"11-50\"."
          },
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this rank (grant-only) — base + optional premium tiers. Resolved and applied via ResourceService.ApplyResourceOperationAtomicAsync."
          },
          "SeasonTierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SeasonTierRewardSet"
              }
            ],
            "description": "Optional season-tier reward scaling. Applied via SeasonTierRewardResolver.Resolve before ResourceService. null = scaling disabled and base Rewards is used. Only active when the leaderboard has LinkedSeasonChainID."
          }
        }
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "SeasonTierRewardBundle": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this tier. Passed unmodified into ResourceService via a regular ResourceOperation.Grant."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this bundle to apply. Matches SeasonTierDefinition.Tier / UserSeasonState.CurrentTier."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to. Selection matches only tiers with the same SeasonChainID."
          }
        },
        "description": "Structurally different rewards for a season-chain tier. Analogous to PremiumTierBundle but the trigger is the player's season tier. Selection picks the single best match (MinSeasonTier <= playerTier); not stacked."
      },
      "LeaderboardChainedEvent": {
        "type": "object",
        "properties": {
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Event order within the cycle (0, 1, 2...)."
          },
          "DurationSec": {
            "type": "integer",
            "format": "int64",
            "description": "Event duration (seconds)."
          },
          "ChainedEventID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event ID inside the chain. Mongo-safe."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the instance ends for claiming rank rewards and milestones."
          }
        },
        "description": "A single event inside a leaderboard chain. Mirror of TimedEvent's ChainedEventDefinition (without Content). Each (cycleIndex, ChainedEventID) is an independent leaderboard instance."
      },
      "LeaderboardPresetBindings": {
        "type": "object",
        "properties": {
          "Milestones": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Milestones preset binding (merge by MilestoneID; Remove drops keys)."
          },
          "RankRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Rank-reward ladder preset binding (merge by Rank-range key)."
          }
        },
        "description": "Container of preset wiring for a leaderboard — one PresetBinding per block. Inline data (RankRewards/Milestones/ScoreSources) lives on LeaderboardDefinition. null = presets unused."
      },
      "LeaderboardPresetRegistry": {
        "type": "object",
        "properties": {
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable milestone sets (shared MilestoneSet) keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneSet"
            }
          },
          "RankRewards": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable rank-reward ladders keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/RankRewardSet"
            }
          }
        },
        "description": "Container of leaderboard preset registries. Each field is a dictionary keyed by PresetID. Resolved at read-time via PresetResolver (preset + inline -> merge by key)."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "SeasonTierRewardMultiplier": {
        "type": "object",
        "properties": {
          "Multiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier. 1.0 = neutral (resolver returns the base reward without copying). Rounding: (long)Math.Round(Amount * Multiplier). Entries with final Amount <= 0 are dropped."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this multiplier to apply."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to."
          }
        },
        "description": "Multiplier applied to Amount of the base ResourceGrant for a season-chain tier. Applied to every ResourceEntry.Amount and EventTokenOperation.Amount in Standard and in PremiumTiers.Resources."
      },
      "LeaderboardScoreAggregation": {
        "enum": [
          "Sum",
          "BestScore",
          "BestTime",
          "LastValue"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Sum",
          "BestScore",
          "BestTime",
          "LastValue"
        ],
        "x-enum-descriptions": [
          "Each submit is added to the current score.",
          "Keep only the best (maximum) result.",
          "Keep only the best (minimum) result. Useful e.g. for completion time.",
          "Always replace with the latest value."
        ]
      }
    },
    "additionalProperties": false
  }

  arguments 1495 lines copy
• get_season unknown never probed

  GET ONLY the 'Season' field of TitlePublicConfigurationModel. Long-form seasonal progression — battle passes, chapters, ladders. Defines a season's start/end window, XP/progress curve, tier rewards (free + premium tracks), and the Premium pass that unlocks paid rewards. For short events use TimedEvent.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_season unknown never probed

  PARTIAL SAVE: writes ONLY the 'Season' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Long-form seasonal progression — battle passes, chapters, ladders. Defines a season's start/end window, XP/progress curve, tier rewards (free + premium tracks), and the Premium pass that unlocks paid rewards. For short events use TimedEvent.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "SeasonDefinitions",
        "properties": {
          "Chains": {
            "type": [
              "null",
              "object"
            ],
            "description": "All season chains of the title. Dictionary key is SeasonChainID. A single title may contain multiple independent chains (e.g. main season and special-mode season).",
            "additionalProperties": {
              "$ref": "#/definitions/SeasonChainDefinition"
            }
          }
        },
        "description": "Root configuration of the title's season system."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "SeasonDefinition": {
        "type": "object",
        "properties": {
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Position in the chain (0, 1, 2...). Defines season order."
          },
          "Tiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierDefinition"
            },
            "description": "Season meta progression tiers (Class System / Fairytale Express). Status tokens come from tournament prize ranks only. Empty list = season meta disabled. Sort by SeasonTierDefinition.RequiredTokens ASC."
          },
          "SeasonID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique season ID within the chain. Used as a reference from other systems. Examples: \"s1\", \"spring_2026\", \"halloween\"."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset paths for the season (icon, banner, background). Order and meaning are defined by the client.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Season description for the UI."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Season display name."
          },
          "DurationSec": {
            "type": "integer",
            "format": "int64",
            "description": "Season duration in seconds. Per-season. Typical: ~50 days = 4,320,000 sec."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary parameters for extending the config without changing the schema. Used by the client or server scripts.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "LinkedCollectionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the Collection from CollectionDefinitions.Collections active in this season. null = no collection."
          }
        },
        "description": "A single season inside a chain. Defines duration, meta progression and optional links to other systems (Collection, Tournament, Coop). Start/end dates are not stored — computed by the server from SeasonChainDefinition.AnchorUtc."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "SeasonTierDefinition": {
        "type": "object",
        "properties": {
          "Tier": {
            "type": "integer",
            "format": "int32",
            "description": "Tier number. 1 = base level (no tokens). Used for sorting and progress display in the UI."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset paths for the tier (tier icon, badge, background effect).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tier display name. Example: \"Bronze\", \"Silver\", \"Gold\"."
          },
          "RequiredTokens": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum total number of status tokens required to reach this tier."
          },
          "TierReachedReward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "One-time reward granted on first reaching the tier in the season. Re-grant is protected via UserSeasonState.ClaimedTierRewards."
          }
        },
        "description": "A single tier of season meta progression (Class System). Unlocked when enough status tokens are accumulated and stays active until the season ends."
      },
      "SeasonChainDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate for the chain — standard SegmentGate (Core/Segment), like Store/Reward/TimedBoost/Quest/Experiment. null = available to all. Players failing the gate do not see the active season and do not receive its status tokens."
          },
          "Seasons": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonDefinition"
            },
            "description": "Ordered list of seasons in the chain. Read order is sorted by SeasonDefinition.Order ASC."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Unified chain schedule container (Mode = Chained). Holds anchor, pauses, MaxCycles, global on/off (Schedule.IsActive) and advancement style in Schedule.Chain. Season dates are computed from Schedule.Chain.AnchorUtc plus the durations of preceding seasons."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Chain display name for the UI and internal tools."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique chain ID within the title. Used as key in SeasonDefinitions.Chains. Examples: \"main\", \"special_mode\", \"region_eu\"."
          },
          "GrantTokensAccessMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/SeasonGrantAccessMode"
              }
            ],
            "description": "Who may call GrantStatusTokens for this chain. ServerOnly: server code only (recommended for production). ClientOnly: client only. Both: either."
          }
        },
        "description": "Season chain. Seasons run one after another; after the last one a new cycle starts. Analogous to TimedEventDefinition (Chained)."
      },
      "SeasonGrantAccessMode": {
        "enum": [
          "ServerOnly",
          "ClientOnly",
          "Both"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ServerOnly",
          "ClientOnly",
          "Both"
        ],
        "x-enum-descriptions": [
          "Server code only (tournament, quest). Recommended for production.",
          "Client only.",
          "Both client and server."
        ]
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      }
    },
    "additionalProperties": false
  }

  arguments 1161 lines copy
• update_kanban_project unknown never probed

  Rename a board, change its description/icon/colour, or archive it. Archiving hides it from search and from my-tasks without deleting anything.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233

  {
    "type": "object",
    "required": [
      "project_id"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "New name (optional)."
      },
      "color": {
        "type": "string",
        "description": "New accent colour (optional)."
      },
      "emoji": {
        "type": "string",
        "description": "New icon (optional)."
      },
      "archived": {
        "type": "boolean",
        "description": "Archive or unarchive it (optional)."
      },
      "project_id": {
        "type": "string",
        "description": "Board to change."
      },
      "description": {
        "type": "string",
        "description": "New description (optional)."
      }
    },
    "additionalProperties": false
  }

  arguments 33 lines copy
• delete_kanban_project unknown never probed

  Delete a whole board with every card, comment and attachment on it. IRREVERSIBLE and there is no undo — ask the publisher first, and prefer archiving via update_kanban_project(archived=true), which is reversible.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "project_id"
    ],
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Board to delete."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_game_loop unknown never probed

  GET ONLY the 'GameLoop' field of TitlePublicConfigurationModel. Core gameplay loop configuration — match settings, level pacing, difficulty curves, energy/cooldown gates, retry/continue economy. Use for tuning the moment-to-moment gameplay; not for content (use Item, Character, Collection) and not for meta-progression (use Season).

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_game_loop unknown never probed

  PARTIAL SAVE: writes ONLY the 'GameLoop' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Core gameplay loop configuration — match settings, level pacing, difficulty curves, energy/cooldown gates, retry/continue economy. Use for tuning the moment-to-moment gameplay; not for content (use Item, Character, Collection) and not for meta-progression (use Season).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "GameLoopDefinitions",
        "properties": {
          "Board": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BoardLoopDefinition"
              }
            ],
            "description": "Base game board config (dice rolls, tiles, buildings, attacks, raids)."
          },
          "CommunityChest": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityChestDefinition"
              }
            ],
            "description": "Cooperative Community Chest config (board-game-style). A group of players fills one shared progress meter; contribution comes from landing on the BoardTileType.CommunityChest tile. null / IsActive=false disables the feature."
          }
        },
        "description": "Root config of the Core Loop system in TitlePublicConfigurationModel.GameLoop. Holds the nested board configuration."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "RaidMode": {
        "enum": [
          "Fast",
          "Sequential"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Fast",
          "Sequential"
        ],
        "x-enum-descriptions": [
          "New mode. Client receives the full RaidLayout and submits all opened indices in a single request (BoardLoopRaidFast). Reduces latency and round-trips.",
          "Classic mode. Layout is not exposed; each cell is opened via a separate request (BoardLoopRaid). Server validates every step."
        ]
      },
      "ChanceTable": {
        "type": "object",
        "properties": {
          "Outcomes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ChanceOutcome"
            },
            "description": "Weighted list of outcomes. Entries with Weight <= 0 are skipped. If all weights are zero or the list is empty, the Chance landing is treated as neutral (no effect)."
          }
        },
        "description": "Weighted outcome table for BoardTileType.Chance/Chance1/Chance2/Chance3 tiles. On landing, the server performs one weighted roll over Outcomes and applies the selected ChanceOutcome (reward grant, forced Attack/Raid, auto-routed event tokens)."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "AttackOutcome": {
        "enum": [
          "Hit",
          "Blocked"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hit",
          "Blocked"
        ],
        "x-enum-descriptions": [
          "Attack succeeded: target building is damaged (level -1, IsDamaged = true); attacker receives the full BaseAttackReward.",
          "Attack blocked by a shield: one victim shield is consumed; the attacker's reward (BaseAttackReward) is multiplied by ProceduralEconomyConfig.AttackBlockedRewardFactor."
        ]
      },
      "BoardTileType": {
        "enum": [
          "Empty",
          "Reward",
          "Reward1",
          "Reward2",
          "Reward3",
          "Chance",
          "Chance1",
          "Chance2",
          "Chance3",
          "RandomAction",
          "Attack",
          "Raid",
          "Shield",
          "EventToken",
          "Custom",
          "Special",
          "CommunityChest"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Empty",
          "Reward",
          "Reward1",
          "Reward2",
          "Reward3",
          "Chance",
          "Chance1",
          "Chance2",
          "Chance3",
          "RandomAction",
          "Attack",
          "Raid",
          "Shield",
          "EventToken",
          "Custom",
          "Special",
          "CommunityChest"
        ],
        "x-enum-descriptions": [
          "Neutral tile — triggers no mechanic.",
          "Reward tile (base variant) — grants resources per StageOperations.OnTileLanding[\"Reward\"]. Behaviour identical to Reward1/Reward2/Reward3, only the config key differs.",
          "Reward tile variant 1 — grants resources per StageOperations.OnTileLanding[\"Reward1\"]. Behaviour identical to Reward/Reward2/Reward3, only the config key differs.",
          "Reward tile variant 2 — grants resources per StageOperations.OnTileLanding[\"Reward2\"]. Behaviour identical to Reward/Reward1/Reward3, only the config key differs.",
          "Reward tile variant 3 — grants resources per StageOperations.OnTileLanding[\"Reward3\"]. Behaviour identical to Reward/Reward1/Reward2, only the config key differs.",
          "Chance tile (base variant) — resolves via BoardTileDefinition.ChanceTableID, falling back to StageOperations.OnTileLanding[\"Chance\"]. Behaviour identical to Chance1/Chance2/Chance3, only the config key differs.",
          "Chance tile variant 1 — resolves via BoardTileDefinition.ChanceTableID, falling back to StageOperations.OnTileLanding[\"Chance1\"]. Behaviour identical to Chance/Chance2/Chance3, only the config key differs.",
          "Chance tile variant 2 — resolves via BoardTileDefinition.ChanceTableID, falling back to StageOperations.OnTileLanding[\"Chance2\"]. Behaviour identical to Chance/Chance1/Chance3, only the config key differs.",
          "Chance tile variant 3 — resolves via BoardTileDefinition.ChanceTableID, falling back to StageOperations.OnTileLanding[\"Chance3\"]. Behaviour identical to Chance/Chance1/Chance2, only the config key differs.",
          "Railroad tile with random action. Weights are RandomActionAttackWeight and RandomActionRaidWeight.",
          "Railroad tile with a forced attack on an opponent building.",
          "Railroad tile with a forced raid on an opponent bank.",
          "Shield pickup tile. Grants ShieldCurrencyID; overflow converts to RollCurrencyID.",
          "Generic event tile. On landing, grants resources from StageOperations.OnTileLanding[EventToken]. Deprecated for new content — any Custom tile can grant event tokens via TriggerSource.TileTypeFilter + TileIndexFilter in TimedEventDefinitions. Kept for compatibility with existing configs.",
          "Custom reward tile extensible via CMS without SDK rebuild. The OnTileLanding key, LandedTileType in the response, and BoardTileLanding event-token filter all use BoardTileDefinition.CustomTypeID instead of the enum name. No system side-effects (behaves like Reward/Reward1/Reward2/Reward3/Chance/Chance1/Chance2/Chance3).",
          "Universal Special tile with flexible config via SpecialModeDefinition. On landing, the player receives an offer with one or more choices (SpecialChoiceMode.Instant grants a small immediate reward; SpecialChoiceMode.Timed starts a duration-based mode with optional ad/RewardedVideoCredit-driven multipliers). The concrete config is resolved by BoardTileDefinition.SpecialModeID from StageOperations.SpecialModesByID.",
          "Cooperative Community Chest tile (board-game-style). On landing, the server makes a free auto-contribution to the player's group shared meter (see CommunityChestDefinition); no pending interaction is created. If StageOperations.OnTileLanding[\"CommunityChest\"] defines a personal reward, it is granted in addition to the contribution. If the player is not in an active group, the contribution is skipped (the tile behaves like a neutral/reward tile)."
        ]
      },
      "ChanceOutcome": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Outcome reward (currencies, shields, items, explicit event tokens). Applied via the standard ApplyScaledOperation pipeline + BoardStageTemplate.TileLandingMultiplier. null = no explicit reward (used for pure ForceAction outcomes)."
          },
          "Weight": {
            "type": "integer",
            "format": "int32",
            "description": "Weight for weighted selection. Must be > 0; otherwise the outcome is skipped."
          },
          "OutcomeID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Semantic outcome identifier (e.g. \"small_coins\", \"medium_coins\", \"big_coins\", \"force_attack\"). Used for targeted event-token grants: when this outcome fires, auto-route passes OutcomeID into TriggerSource.ChanceOutcomeFilter. null/empty = outcome is opaque to the filter (tokens follow the general TileTypeFilter rule)."
          },
          "ForceAction": {
            "oneOf": [
              {
                "$ref": "#/definitions/ChanceForceAction"
              }
            ],
            "description": "Forced action after applying Reward. None = regular landing. Attack/Raid/Special = create the corresponding pending interaction (as if the tile was Attack/Raid/Special)."
          },
          "SpecialModeID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Special-mode ID from StageOperations.SpecialModesByID when ForceAction = Special. null/empty falls back to BoardTileDefinition.SpecialModeID of the current tile, then to the \"default\" key. Ignored for other ForceAction values."
          }
        },
        "description": "A single weighted ChanceTable outcome. May combine Reward (resource grant) and ForceAction (trigger Attack/Raid pending) — both apply: reward is granted atomically with the roll op, pending is created after it."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "BoardBotConfig": {
        "type": "object",
        "properties": {
          "ShieldChance": {
            "type": "number",
            "format": "double",
            "description": "Probability (0..1) that a generated bot already holds a shield."
          },
          "RankOffsetMax": {
            "type": "integer",
            "format": "int64",
            "description": "Upper bound (inclusive) of the random flat rank offset (>= RankOffsetMin)."
          },
          "RankOffsetMin": {
            "type": "integer",
            "format": "int64",
            "description": "Lower bound of the random flat rank offset added on top of the multiplied rank."
          },
          "StageLevelSpread": {
            "type": "integer",
            "format": "int32",
            "description": "Half-width of the window the bot's stage level is drawn from: a random level in [attackerStage - spread, attackerStage + spread], clamped at board 1. Spread 2 for a player on board 3 yields targets from board 1 to 5. 0 = the bot always sits on the attacker's board. Visual only (target buildings + background); attack rewards always use the attacker's stage."
          },
          "RankMultiplierMax": {
            "type": "number",
            "format": "double",
            "description": "Upper bound of the random rank multiplier (>= RankMultiplierMin). Required — must be set (> 0), no default."
          },
          "RankMultiplierMin": {
            "type": "number",
            "format": "double",
            "description": "Lower bound of the random rank multiplier applied to the attacker's BoardRank. Required — must be set (> 0), no default."
          },
          "DamagedBuildingChance": {
            "type": "number",
            "format": "double",
            "description": "Probability (0..1) that a generated bot building starts damaged."
          }
        },
        "description": "Bot opponent simulation config (used when no real attack/raid target is available)."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "AttackBonusDrop": {
        "type": "object",
        "properties": {
          "Tag": {
            "type": [
              "null",
              "string"
            ],
            "description": "Trace/analytics tag (\"lte_milestone_drop\", \"season_token_drop\")."
          },
          "Chance": {
            "type": "number",
            "format": "double",
            "description": "Trigger probability (0.0..1.0). 0.05 = 5%. Drops are rolled independently and not normalized; the sum of Chance across the list may exceed 1.0."
          },
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Drop payload (typically Grant.Standard.EventTokens). ScaleWithRollMultiplier controls roll-multiplier scaling."
          },
          "RequiredOutcome": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AttackOutcome"
              }
            ],
            "description": "Filter by attack outcome. null = triggers on any outcome. Typically restricted to AttackOutcome.Hit so Blocked does not grant the bonus."
          }
        },
        "description": "A single independent probabilistic drop on attack."
      },
      "BoardDiceConfig": {
        "type": "object",
        "properties": {
          "Count": {
            "type": "integer",
            "format": "int32",
            "description": "Number of dice rolled per step. Required — must be set (> 0), no default."
          },
          "Sides": {
            "type": "integer",
            "format": "int32",
            "description": "Number of faces per die (each die rolls 1..Sides). Required — must be set (> 0), no default."
          }
        },
        "description": "Dice roll config. Step = sum of Count dice each rolling 1..Sides."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "SpecialStatTier": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Reward for reaching this tier. Snapshotted (scaled) at Choose. Supports ScaledResourceOperation.ScaleWithRollMultiplier."
          },
          "RequiredValue": {
            "type": "number",
            "format": "double",
            "description": "Metric threshold. Must be > 0 and finite, otherwise the tier is dropped at Choose. Fractional ON PURPOSE: run metrics are inherently fractional (time in seconds, experience), and \"survive 90.5 seconds\" cannot be expressed on an integer type. The server compares with a relative epsilon, so 90.49999999997 does satisfy a 90.5 threshold - otherwise float noise would cost the player the tier. The REWARD itself stays integral: it is rounded by the platform's single rounding point, AmountMath."
          }
        },
        "description": "One tier of a metric ladder: the reward unlocks once the run's metric value reaches RequiredValue."
      },
      "SpecialTierMode": {
        "enum": [
          "Highest",
          "Cumulative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Highest",
          "Cumulative"
        ],
        "x-enum-descriptions": [
          "Only the HIGHEST reached tier pays - same as the time ladder.",
          "ALL reached tiers pay (rewards are summed)."
        ]
      },
      "StageOperations": {
        "type": "object",
        "properties": {
          "OnRaid": {
            "type": [
              "null",
              "object"
            ],
            "description": "Operations per raid outcome. Keys are RaidOutcome names as string (\"Small\", \"Medium\", \"Big\", \"Jackpot\"). Granted to the attacker in addition to the stolen portion of BoardStageTemplate.BaseRaidReward.",
            "additionalProperties": {
              "$ref": "#/definitions/ScaledResourceOperation"
            }
          },
          "OnBuild": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Operation for any building upgrade or repair (Board_Build). ScaleWithRollMultiplier is typically false (build cost does not scale with rolls)."
          },
          "OnAttack": {
            "type": [
              "null",
              "object"
            ],
            "description": "Operations per attack outcome. Keys are AttackOutcome names as string (\"Hit\", \"Blocked\"). Granted to the attacker in addition to BoardStageTemplate.BaseAttackReward. Typically used to award tournament event tokens.",
            "additionalProperties": {
              "$ref": "#/definitions/ScaledResourceOperation"
            }
          },
          "OnPassStart": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Operation on passing the start tile (GO). Applied per completed lap (lapsDelta times). ScaleWithRollMultiplier is typically true."
          },
          "OnTileLanding": {
            "type": [
              "null",
              "object"
            ],
            "description": "Operations on landing on a specific tile type. For system types the key is BoardTileType name as string (\"Reward\"/\"Reward1\"/\"Reward2\"/\"Reward3\", \"Chance\"/\"Chance1\"/\"Chance2\"/\"Chance3\", \"EventToken\", ...). For tiles with Type == Custom the key is BoardTileDefinition.CustomTypeID (e.g. \"Halloween_Pumpkin\"). Missing key = no resources for that tile. ScaleWithRollMultiplier is typically true.",
            "additionalProperties": {
              "$ref": "#/definitions/ScaledResourceOperation"
            }
          },
          "OnStageComplete": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Operation on stage completion (all buildings at max level, none damaged). Granted once at the moment of the final successful build that closes the stage."
          },
          "ChanceTablesByID": {
            "type": [
              "null",
              "object"
            ],
            "description": "Outcome tables for BoardTileType.Chance/Chance1/Chance2/Chance3 tiles. Key = arbitrary table ID (e.g. \"default\", \"big_chance\"). A tile picks one via BoardTileDefinition.ChanceTableID; missing/unknown ID falls back to \"default\", then to OnTileLanding[\"Chance\"]/[\"Chance1\"]/[\"Chance2\"]/[\"Chance3\"] for the specific variant (backward compat). Each outcome is a weighted ChanceOutcome: can grant a Reward, force Attack/Raid (ForceAction), and/or scale auto-routed event-token amount (EventTokenMultiplier).",
            "additionalProperties": {
              "$ref": "#/definitions/ChanceTable"
            }
          },
          "SpecialModesByID": {
            "type": [
              "null",
              "object"
            ],
            "description": "Special-mode configurations for BoardTileType.Special tiles. Key = arbitrary mode ID (e.g. \"default\", \"boss_arena\"). A tile picks one via BoardTileDefinition.SpecialModeID; missing/unknown ID falls back to \"default\". If neither exists, the Special landing is a no-op (no offer is created).",
            "additionalProperties": {
              "$ref": "#/definitions/SpecialModeDefinition"
            }
          },
          "OnAttackBonusDrops": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/AttackBonusDrop"
            },
            "description": "Pool of independent probabilistic bonus drops on attack. Each element is rolled separately. Applied ON TOP of BaseAttackReward and OnAttack. Typical: 5% chance to grant +N milestone-event tokens on Hit."
          }
        },
        "description": "Server-configured resource operations for all in-stage game events. Each field is a ScaledResourceOperation containing a ResourceOperation (grant/consume) plus the roll-multiplier scaling flag."
      },
      "HeistRaidVariant": {
        "type": "object",
        "properties": {
          "Tag": {
            "type": [
              "null",
              "string"
            ],
            "description": "Variant tag for analytics, UI banners and logging (\"classic\", \"small_bonus\", \"big_bonus\", \"jackpot\"). Propagated to BoardPendingInteraction.HeistVariantTag when the raid is created."
          },
          "Weight": {
            "type": "integer",
            "format": "int32",
            "description": "Weight for weighted selection from HeistGridBonusConfig.Variants. Must be > 0; otherwise the variant is skipped."
          },
          "BonusPool": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/WeightedHeistCellBonus"
            },
            "description": "Weighted bonus pool. One bonus is independently selected for each bonus cell. An empty pool with Min/Max > 0 is a config error (cells stay plain)."
          },
          "IsJackpot": {
            "type": "boolean",
            "description": "true = jackpot raid variant (board-game-style). Final RaidOutcome is forced to Jackpot regardless of symbols; JackpotFinalMultiplier is applied on top of the heist multiplier; layout follows JackpotSymbolDistribution if set, else 4/4/4. false = regular variant."
          },
          "MaxBonusCells": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of bonus cells (0..12). Must be >= MinBonusCells. Actual count is uniform in [Min, Max]."
          },
          "MinBonusCells": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum number of bonus cells in this variant (0..12). 0 for the classic variant."
          },
          "GuaranteedBonus": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Guaranteed reward granted to the attacker ONCE at the raid final (any RaidOutcome), independent of which cells the player opened. null = no guaranteed reward (standard for the classic variant). Scales by ScaledResourceOperation.ScaleWithRollMultiplier."
          },
          "JackpotFinalMultiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier applied to the ENTIRE stolen bank in jackpot mode, ON TOP of the regular heist multiplier (x1/x2/x5). final = baseRaidReward * rollMultiplier * heistMultiplier * JackpotFinalMultiplier. Ignored when IsJackpot = false. 0 or negative is treated as 1.0."
          },
          "JackpotSymbolDistribution": {
            "type": [
              "null",
              "object"
            ],
            "description": "Override of the symbol distribution for a jackpot variant's layout. Key = HeistSymbol name as string (\"Small\", \"Medium\", \"Big\"), value = number of cells of that symbol. The sum must be 12, else generation falls back to default 4/4/4. Example: {\"Big\":6, \"Medium\":3, \"Small\":3}. null = default. Only used when IsJackpot = true.",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          }
        },
        "description": "A single raid variant. Describes bonus density, bonus pool, guaranteed reward and jackpot parameters."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "ChanceForceAction": {
        "enum": [
          "None",
          "Attack",
          "Raid",
          "Special"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "None",
          "Attack",
          "Raid",
          "Special"
        ],
        "x-enum-descriptions": [
          "Nothing — regular landing with ChanceOutcome.Reward grant.",
          "Creates an Attack pending interaction (equivalent to landing on BoardTileType.Attack).",
          "Creates a Raid pending interaction (equivalent to landing on BoardTileType.Raid).",
          "Creates a Special-mode pending interaction (equivalent to landing on BoardTileType.Special). The mode is resolved by priority: ChanceOutcome.SpecialModeID -> BoardTileDefinition.SpecialModeID -> \"default\" key in StageOperations.SpecialModesByID."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "ResourceOperation": {
        "type": "object",
        "properties": {
          "Grant": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Grant direction. null if the operation only consumes."
          },
          "Consume": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "Consume direction. null if the operation only grants."
          }
        },
        "description": "Container for all platform operations: what to grant and what to consume."
      },
      "SpecialChoiceMode": {
        "enum": [
          "Instant",
          "Timed"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Instant",
          "Timed"
        ],
        "x-enum-descriptions": [
          "Instant reward — granted at Choose, pending is cleared.",
          "Timer of SpecialModeChoice.DurationSeconds with a final Claim."
        ]
      },
      "SpecialModeChoice": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/SpecialChoiceMode"
              }
            ],
            "description": "Choice type. Instant grants the reward immediately on Choose. Timed starts a DurationSeconds timer; the player can apply multipliers and claims the final reward via Board_SpecialClaim."
          },
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Choice reward for Instant — granted directly at Choose. Ignored for Timed: the Timed reward is fully defined by the Gradation ladder. Supports ScaledResourceOperation.ScaleWithRollMultiplier."
          },
          "ChoiceID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Identifier of the choice, unique within the SpecialModeDefinition (e.g. \"instant_small\", \"play_5min\"). Sent by the client to Board_SpecialChoose to commit the selection."
          },
          "RunStats": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SpecialRunStatsConfig"
              }
            ],
            "description": "Rewards for the run's gameplay statistics (coins, experience, enemies killed...) - a SECOND reward axis on top of Gradation, not a replacement. The client reports measured values in GameLoopRequest.RunStats together with Board_SpecialClaim. null = feature off, Claim pays by time only. Ignored for Instant."
          },
          "Gradation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SpecialGradationConfig"
              }
            ],
            "description": "Time-based reward ladder for the Timed flow. The reward at Claim is picked from the tiers whose ElapsedSeconds have passed since entering the mode. Ignored for Instant. Optional, like RunStats - what IS required is that a Timed choice has AT LEAST ONE reward axis; a choice with neither is rejected at Choose."
          },
          "Multipliers": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SpecialClaimMultipliers"
              }
            ],
            "description": "Multiplier config for the Timed flow (random range, view cap, formula). null = Timed without multipliers (player just waits Duration and claims the base). Ignored for Instant."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Optional ways to pay for entering, charged atomically at Choose (e.g., a monetisation gate). Dictionary key = PriceOption.OptionID. null/empty = free.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "DurationSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Timed-flow duration in seconds. Ignored for Instant."
          }
        },
        "description": "A single choice in SpecialModeDefinition.Choices."
      },
      "BoardBotRaidConfig": {
        "type": "object",
        "properties": {
          "Chance": {
            "type": "number",
            "format": "double",
            "description": "Probability (0..1) that a bot actually attacked during an elapsed interval. 0 = platform default (0.5); 1 = always."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Master switch. Default false: the mechanic takes resources away from the player, so it is enabled deliberately."
          },
          "RaidWeight": {
            "type": "integer",
            "format": "int32",
            "description": "Weight of the RAID outcome (steals resources)."
          },
          "AttackWeight": {
            "type": "integer",
            "format": "int32",
            "description": "Weight of the ATTACK outcome (knocks a building level down). If both weights are 0, ATTACK is used."
          },
          "MaxPerCatchUp": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on attacks applied within a single player visit. It also clamps how far back the anchor is rewound (now - IntervalSeconds * MaxPerCatchUp), so a long absence cannot wipe the player out on return. 0 = platform default (3)."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Real time in seconds that must pass to give bots ONE attempt to attack. <= 0 disables the mechanic (a typo here would otherwise mean an unbounded number of attempts)."
          },
          "MinBoardStageLevel": {
            "type": "integer",
            "format": "int32",
            "description": "The board level from which the player becomes attackable by bots (newbie protection). 0 = platform default (2)."
          },
          "RaidLossMultiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier applied to the player's loss relative to BaseRaidReward of their own stage (the same quantity a real raid uses for the victim's loss). <= 0 = platform default 1.0."
          }
        },
        "description": "Incoming bot attacks: bots attack the player while they are offline, costing real resources. Materialized lazily when the player opens the board, never in a background job."
      },
      "BoardStageTemplate": {
        "type": "object",
        "properties": {
          "Buildings": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/BuildingDefinition"
            },
            "description": "Stage buildings (SlotIndex 0..N, per-building MaxLevel). Lets a shared building layout be authored once in the template and reused across stages, with optional per-stage override. Resolve priority (first non-empty wins): BoardStageDefinition.Override.Buildings -> BoardStageDefinition.Buildings (inline) -> this template list. null/empty = not set here, fall through to the next layer."
          },
          "MaxShields": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum number of shields on the stage. Shields above the cap convert into RollCurrencyID (dice refund). Required — taken strictly from config; config error if missing (no hardcoded default). 0 is allowed = no shields."
          },
          "BaseRaidReward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base victim bank for a raid (pre-multipliers). Two decoupled amounts. Attacker gain (systemic, all branches): BaseRaidReward * RollMultiplier * heistMultiplier * EconomyScale(attacker's board) * Jackpot * tuning, NOT capped by the victim's balance. Victim loss (independent): BaseRaidReward * EconomyScale(victim's board) * (heistMultiplier if ScaleVictimLossWithTier), then clipped to the victim's balance. Stolen != lost. null = no bank."
          },
          "EconomyOverride": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StageEconomyOverride"
              }
            ],
            "description": "Per-stage override of procedural-economy parameters: cost-matrix shape, tail growth, manual EconomyScale, scaled-resource allow-list. Any non-null field overrides the corresponding global default from ProceduralEconomyConfig. null = inherit the global values wholesale."
          },
          "StageOperations": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StageOperations"
              }
            ],
            "description": "Full set of resource operations tied to stage events. Resolver merges dictionaries OnTileLanding/OnAttack/OnRaid by key (override wins per-key); scalars OnPassStart/OnBuild/OnStageComplete — override wins whole; list OnAttackBonusDrops — override wins whole."
          },
          "BaseAttackReward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base resource bundle for a successful attack (pre-multipliers). Scaled by RollMultiplier, EconomyTuning, EconomyScale (attacker's board) and the value weight of the building being hit (CostMatrix[slot][hitLevel-1]). On AttackOutcome.Blocked it is multiplied by ProceduralEconomyConfig.AttackBlockedRewardFactor (not a hardcoded 0.5). null = no reward."
          },
          "MaxRollMultiplier": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum allowed roll multiplier on this stage. Required — taken strictly from config; the resolver returns a config error if missing (no hardcoded default)."
          },
          "HeistGridBonusConfig": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/HeistGridBonusConfig"
              }
            ],
            "description": "Distribution of bonuses and modes in the Bank Heist raid grid. null = all raids on this stage are classic (no bonuses or jackpot)."
          },
          "TileLandingMultiplier": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardMultiplierRange"
              }
            ],
            "description": "Random multiplier applied to Amount values in OnTileLanding rewards. One roll mul in [Min, Max] per landing multiplies every ResourceEntry.Amount and EventTokenOperation.Amount inside the selected operation. Applied BEFORE RollMultiplier and ModifierService. Scope: OnTileLanding only — does NOT affect OnAttack/OnRaid/OnBuild/OnStageComplete/OnPassStart. null = neutral (x 1.0)."
          }
        },
        "description": "Stage economy template. Same class is reused both as the canonical entry in BoardLoopDefinition.StageTemplatesByID and as the override container on BoardStageDefinition.Override. All fields are nullable: null means \"not set here — look at the template or the hardcoded fallback in the resolver\"."
      },
      "BuildingDefinition": {
        "type": "object",
        "properties": {
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Building display name (for CMS and UI)."
          },
          "MaxLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum building level (inclusive). Required — must be > 0, no default; the resolver/build fail when <= 0. Each level cost is ceil(Unit(N) * CostMatrix[SlotIndex][level])."
          },
          "SlotIndex": {
            "type": "integer",
            "format": "int32",
            "description": "Slot index in the stage's building array (0..4). Matches BuildingState.SlotIndex on the player."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset paths for the building (key = asset type, value = path). Optional; used by the client to load visual resources.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "MaxLevelReward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "One-time reward on first reaching MaxLevel. Granted atomically with the final upgrade; not re-granted (BuildingState.MaxLevelRewardClaimed)."
          }
        },
        "description": "Config of a single building within a stage. Buildings are upgraded from 0 to MaxLevel for soft currency; per-level cost is ceil(Unit(N) * CostMatrix[SlotIndex][level]) (see ProceduralEconomyConfig.CostMatrixTemplatesByID)."
      },
      "BoardLoopDefinition": {
        "type": "object",
        "properties": {
          "Bots": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BoardBotConfig"
              }
            ],
            "description": "Bot opponent simulation config (shield/damage chances, rank range). Required — configured per title (no default)."
          },
          "Dice": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BoardDiceConfig"
              }
            ],
            "description": "Dice roll configuration (number of dice and faces). Required — configured per title (no default)."
          },
          "BotRaids": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BoardBotRaidConfig"
              }
            ],
            "description": "Incoming bot attacks simulated while the player was away. null = disabled."
          },
          "RaidMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/RaidMode"
              }
            ],
            "description": "Raid mini-game mode. Fast: client receives the full RaidLayout and plays locally. Sequential: cells are revealed one-by-one via the server."
          },
          "Targeting": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BoardTargetingConfig"
              }
            ],
            "description": "Target selection rules for attack and raid. null = previous behaviour: a target is picked from friends with no repeat limit."
          },
          "StagesByLevel": {
            "type": [
              "null",
              "object"
            ],
            "description": "Dictionary of stages (locations) by level. Key is the level number as a string (\"1\", \"2\", ...). Lookup falls back to the nearest lower level, or to the minimum available if no lower entry exists.",
            "additionalProperties": {
              "$ref": "#/definitions/BoardStageDefinition"
            }
          },
          "RollCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the virtual currency used as energy (dice). Each roll consumes usedMultiplier units. Required — must be configured per title (no default)."
          },
          "SoftCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the soft currency used for building upgrades. Build cost (Unit(N) * CostMatrix[slot][level]) is charged in this currency. Required — must be configured per title (no default)."
          },
          "ShieldCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the shield virtual currency. Shields block attacks and are consumed from the victim. Overflow (above BoardStageTemplate.MaxShields) is converted into RollCurrencyID (dice refund). Required when the board uses shields (no default)."
          },
          "ProceduralEconomy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ProceduralEconomyConfig"
              }
            ],
            "description": "Procedural-economy container: normalized cost matrix, tail growth of the unit price Unit(N), visual-template cycle for endless boards, the scaled-resource allow-list, and attack/raid reward tuning flags."
          },
          "BoardTemplatesByID": {
            "type": [
              "null",
              "object"
            ],
            "description": "Dictionary of tile-ring templates. Key is an arbitrary template ID. A stage references one via BoardStageDefinition.BoardTemplateID; different stages may share templates.",
            "additionalProperties": {
              "$ref": "#/definitions/BoardTemplateDefinition"
            }
          },
          "StageTemplatesByID": {
            "type": [
              "null",
              "object"
            ],
            "description": "Dictionary of stage-economy templates (BaseAttackReward/BaseRaidReward, MaxRollMultiplier, MaxShields, HeistGridBonusConfig, StageOperations, TileLandingMultiplier, EconomyOverride). Key is an arbitrary template ID. Stages must reference one via BoardStageDefinition.StageTemplateID and may optionally override fields via BoardStageDefinition.Override.",
            "additionalProperties": {
              "$ref": "#/definitions/BoardStageTemplate"
            }
          },
          "AllowedRollMultipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Ordered list of allowed roll-multiplier values (e.g. [1, 5, 10, 20, 50, 100]). The server normalizes any requested multiplier down to the nearest value in this list that does not exceed the player's dice balance. Required — must be configured per title (no default)."
          }
        },
        "description": "Global game board config. Defines energy and shield currencies, allowed roll multipliers, tile templates and stages. Read by clients via GetBoardDefinition / GetBoardDefinitionForLevel."
      },
      "BoardTileDefinition": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/BoardTileType"
              }
            ],
            "description": "Tile type that defines the landing mechanic."
          },
          "Index": {
            "type": "integer",
            "format": "int32",
            "description": "Tile index in the board ring (0..N-1)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary string parameters for A/B tests and event extensions (e.g. probability overrides or link to a specific event).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "CustomTypeID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Custom tile ID used ONLY when Type == Custom. Acts as the key for StageOperations.OnTileLanding, LandedTileType in the response, and BoardTileLanding event-token source filter. Ignored for non-Custom types. Conventionally PascalCase or snake_case; avoid collisions with BoardTileType enum names to keep CMS unambiguous."
          },
          "ChanceTableID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the ChanceTable from StageOperations.ChanceTablesByID. Used ONLY when Type = Chance/Chance1/Chance2/Chance3. null/empty falls back to the \"default\" key, then (for compatibility) to a single-shot reward from StageOperations.OnTileLanding[\"Chance\"]/[\"Chance1\"]/[\"Chance2\"]/[\"Chance3\"] for the specific variant. Ignored for non-Chance tiles."
          },
          "SpecialModeID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the SpecialModeDefinition from StageOperations.SpecialModesByID. Used ONLY when Type = Special. null/empty falls back to the \"default\" key; if missing, the Special landing is a no-op (no offer is created). Ignored for non-Special tiles."
          },
          "RandomActionRaidWeight": {
            "type": "integer",
            "format": "int32",
            "description": "Weight of the Raid option in random-action selection for BoardTileType.RandomAction tiles."
          },
          "RandomActionAttackWeight": {
            "type": "integer",
            "format": "int32",
            "description": "Weight of the Attack option in random-action selection for BoardTileType.RandomAction tiles. Used together with RandomActionRaidWeight."
          }
        },
        "description": "Config of a single board tile."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "MilestoneDefinition": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base rewards. Always granted on a successful claim."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order in the UI (lower = higher/earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone images (icon, badge). null = unset.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsFeatured": {
            "type": "boolean",
            "description": "Featured milestone: special UI styling. With MilestoneClaimMode.FeaturedAfterEnd these can only be claimed after the instance ends."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI/CMS. null = unset."
          },
          "MilestoneID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique milestone ID within its owning entity (Mongo-safe, claim idempotency key)."
          },
          "BonusRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Bonus-window overlay: extra rewards on top of Rewards when the bonus phase is active at claim time (MilestoneRewardContext.BonusActive). Applied via MilestoneRewardResolver. null = no bonus part."
          },
          "RequiredProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Threshold over ACCUMULATED progress to unlock. EventToken systems: EventTokenBalanceData.TotalEarned (not current balance). CommunityChest: shared group progress."
          },
          "SeasonTierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SeasonTierRewardSet"
              }
            ],
            "description": "Season-tier overlay: reward scaling by the player's season tier. Applied via MilestoneRewardResolver (SeasonTierRewardResolver.Resolve) only when MilestoneRewardContext.SeasonChainID is set. null = disabled."
          }
        },
        "description": "Unified milestone primitive for all platform systems (TimedEvent, Leaderboard, Quest, CommunityChest, DealOffer). Replaces the per-module milestone definitions. Threshold is checked against accumulated progress (RequiredProgress): EventToken systems use EventTokenBalanceData.TotalEarned; CommunityChest uses shared group progress. Reward overlays BonusRewards (bonus-window) and SeasonTierRewards (season-tier) are platform-wide optional fields applied via MilestoneRewardResolver; leave null if unused."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "SeasonTierRewardSet": {
        "type": "object",
        "properties": {
          "Bundles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardBundle"
            },
            "description": "Structurally different rewards for specific tiers. On match, replaces the base ResourceGrant entirely (Replace)."
          },
          "Multipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardMultiplier"
            },
            "description": "Multipliers applied to Amount of the base ResourceGrant. Used ONLY if no Bundles entry matched."
          }
        },
        "description": "Generic container of season-tier reward scaling. Used by any platform system (leaderboards, lootboxes, shop, daily) that wants to scale a ResourceGrant by the player's current tier in a season chain. Empty/null lists = neutral."
      },
      "BoardStageDefinition": {
        "type": "object",
        "properties": {
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stage display name (for CMS and debugging)."
          },
          "Override": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BoardStageTemplate"
              }
            ],
            "description": "Per-field economy override for this stage. Any non-null field in this container overrides the corresponding template field. Dictionaries StageOperations.OnTileLanding/OnAttack/OnRaid are key-merged (override values win per-key); other fields and OnAttackBonusDrops are replaced whole. null = no overrides, stage uses the template 1:1."
          },
          "Buildings": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/BuildingDefinition"
            },
            "description": "Inline buildings on the stage (typically 5, SlotIndex 0..4). Each is upgraded independently; level cost = ceil(Unit(N) * CostMatrix[SlotIndex][level]). Middle layer of building resolution: Override.Buildings -> this inline list -> BoardStageTemplate.Buildings (shared template). Empty = inherit from the template."
          },
          "UnitValue": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Authored anchor for this board's unit price — the B1-L1 upgrade cost in soft currency. Between anchors Unit(N) is geometrically interpolated; past the last it is extrapolated by tail growth. Bound to this level instance (not the shared template). null = computed from neighbouring anchors."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset paths for the stage (key = asset type, value = path). Optional; used by the client to load visual resources.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BoardTemplateID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the tile template from BoardLoopDefinition.BoardTemplatesByID that defines this stage's tile ring."
          },
          "StageTemplateID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the economy template from BoardLoopDefinition.StageTemplatesByID. Required. If not found, the server fails with a config error rather than silently substituting defaults."
          },
          "CostMatrixTemplateID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the cost-matrix template from ProceduralEconomyConfig.CostMatrixTemplatesByID. null/empty -> \"Universal\". Special boards (e.g. 9) point to their own template (\"WideSpread\")."
          }
        },
        "description": "Config for a single stage (location/board). Holds only structural stage fields; all economy is taken from BoardLoopDefinition.StageTemplatesByID via StageTemplateID, with optional per-field override via Override."
      },
      "BoardTargetingConfig": {
        "type": "object",
        "properties": {
          "MaxRecentTargets": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on BoardLoopState.RecentTargets entries. Required because the keys are other players' ids. 0 = platform default. Setting it below what actually accumulates within the cooldown lets evicted targets become selectable early - the list is trimmed by recency."
          },
          "RaidCooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Same for RAID, as a separate number. Stamps are stored per (player, action) pair, so a raid on a target just picked for an attack is not blocked, and vice versa. 0 or negative = disabled."
          },
          "LiveOpponentPoolSize": {
            "type": "integer",
            "format": "int32",
            "description": "How many recently active players of the title to keep in the candidate pool. 0 = platform default (200). This is a page size, not a game rule: one target is needed and the pool order is reshuffled per roll."
          },
          "AttackCooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Seconds before the same player can be picked as an ATTACK target again. The stamp is written when the target is SELECTED, not when the hit lands, so abandoning a pending interaction cannot re-roll for the same friend. Bots are never subject to it. 0 or negative = disabled."
          },
          "MaxLiveCandidateReads": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on how many live-candidate documents may be read within a single roll. 0 = platform default (5). The scan stops at the first suitable candidate and costs one read each; exhausting the budget falls through to a bot."
          },
          "VictimImmunitySeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Seconds a player cannot be picked as a target by STRANGERS after being attacked (victim-side, BoardLoopState.LastAttackedAtUtc). 0 = platform default (3600); negative = disabled. Different from AttackCooldownSeconds, which lives on the attacker and only prevents repeats by the same player. Friends are exempt."
          },
          "LiveOpponentActiveDays": {
            "type": "integer",
            "format": "int32",
            "description": "Activity window in days for a random live opponent (the candidate must have entered the game within this many days). 0 = platform default (30). NEGATIVE disables the live-opponent tier entirely, leaving friends and bots. Activity is measured by LastRequestHeaders.RequestTime (last login/session refresh), which is the indexed field."
          },
          "LiveOpponentPoolCacheSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Seconds the live-candidate pool is reused across rolls (shared by all players of the title). 0 = platform default (60). Without it the pool would be read on every attack/raid roll; it does not make targets repeat, since the order is reshuffled per roll."
          }
        },
        "description": "Target selection rules for attack and raid."
      },
      "HeistGridBonusConfig": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/HeistRaidVariant"
            },
            "description": "Weighted variants. One is picked at random per raid. Empty list equals null on the config (all raids are classic). Negative/zero weights are ignored."
          }
        },
        "description": "Raid grid generation config for a stage (Bank Heist). Two-level random: per-raid variant selection by weight, then per-cell bonus selection from BonusPool. Variants may also have GuaranteedBonus, independent of opened cells."
      },
      "SpecialGradationTier": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Reward for reaching this tier. Snapshotted (scaled) at Choose. Supports ScaledResourceOperation.ScaleWithRollMultiplier."
          },
          "ElapsedSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Elapsed seconds since StartedAtUtc at which this tier's reward becomes the active claimable reward. Must be > 0. Tiers ranked ascending at Choose."
          }
        },
        "description": "One gradation tier of a Timed Special choice: reward unlocked once ElapsedSeconds have passed since StartedAtUtc."
      },
      "StageEconomyOverride": {
        "type": "object",
        "properties": {
          "CostMatrix": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "array",
              "items": {
                "type": "number",
                "format": "double"
              }
            },
            "description": "Last-resort inline cost-matrix override for this stage. Normal path is a named template via BoardStageDefinition.CostMatrixTemplateID; set this only for a fully unique board. Resolve priority: inline override -> template by ID -> \"Universal\". null = use the template."
          },
          "EconomyScale": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Manual override of the resolved EconomyScale(N) for the stage. null = computed from anchors (Unit(N) / Unit(1))."
          },
          "PerBoardGrowth": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Override of the Unit(N) tail growth (used when this stage is the last authored anchor that extrapolation runs from). null = global ProceduralEconomyConfig.PerBoardGrowth."
          },
          "ScaledResources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Scaled-resource set for the stage (ResourceBundle). Replaces ProceduralEconomyConfig.EconomyScaledResources. null = global set."
          }
        },
        "description": "Container of per-stage procedural-economy overrides. Symmetric to the global ProceduralEconomyConfig. All fields nullable: null = \"not set here, use the global value\". Matrix and lists are replaced wholesale (no element-wise merge)."
      },
      "RewardMultiplierRange": {
        "type": "object",
        "properties": {
          "Max": {
            "type": "number",
            "format": "double",
            "description": "Upper bound (inclusive). Must be >= Min. Default 1.0. Recommended soft-cap <= 3.0 to avoid runaway stacking with RollMultiplier and ModifierService."
          },
          "Min": {
            "type": "number",
            "format": "double",
            "description": "Lower bound (inclusive). Default 1.0."
          }
        },
        "description": "Real-valued multiplier range for reward randomization. On roll, mul is sampled uniformly in [Min, Max]. 1.0..1.0 = neutral (no-op)."
      },
      "SpecialModeDefinition": {
        "type": "object",
        "properties": {
          "Choices": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SpecialModeChoice"
            },
            "description": "Choices shown to the player on landing. Typically 1–3 variants; empty list = no-op landing."
          },
          "ClaimExpireSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Seconds from StartedAtUtc to auto-expiry for the Timed flow. Must be >= max SpecialModeChoice.DurationSeconds + grace, otherwise the claim window closes before the player can claim. Required when the mode is used — must be set (> 0), no default."
          },
          "OfferExpireSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "How many seconds the offer remains awaitable for Choose. If the player doesn't choose, the pending expires. Required when the mode is used — must be set (> 0), no default."
          }
        },
        "description": "Special-mode configuration. Bound to a tile via BoardTileDefinition.SpecialModeID. Holds a set of Choices the player picks from after landing."
      },
      "SpecialRunStatsConfig": {
        "type": "object",
        "properties": {
          "MetricsByID": {
            "type": [
              "null",
              "object"
            ],
            "description": "Whitelist of metrics. Key = MetricID (e.g. \"enemies_killed\", \"survived_seconds\"). A metric absent from this dictionary is ignored by the server - the client cannot introduce a new metric.",
            "additionalProperties": {
              "$ref": "#/definitions/SpecialStatMetricConfig"
            }
          }
        },
        "description": "Run-statistics reward ladders for a Timed Special choice - a second, independent reward axis on top of the time-based Gradation ladder. The client reports measured run values in GameLoopRequest.RunStats ({MetricID: value}) together with Board_SpecialClaim; the server validates them against this whitelist and adds the reached tiers' rewards to the time-tier reward. null/empty = feature off, Claim behaves as before."
      },
      "SpecialStatRateConfig": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Reward for ONE unit of the metric. Usually \"1 coin\": the player then gets 1347 for 1347 collected. Supports ScaledResourceOperation.ScaleWithRollMultiplier."
          },
          "MaxRewardUnits": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Cap on the number of reward units - the most we are willing to pay for this metric. Default 0 = no cap. At a one-to-one rate this reads directly as \"no more than N units of currency\"."
          },
          "MetricPerReward": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "How many metric units make up one reward unit. Default 1 - one-to-one payout. 10 means \"one reward per 10 units\"; the remainder is dropped (units are floored). Zero and negative are treated as 1."
          }
        },
        "description": "Linear payout for a metric: units = value / MetricPerReward (floored), clamped by MaxRewardUnits, and Reward is multiplied by that count. Note there are TWO caps doing different jobs: MaxValuePerClaim is anti-cheat (what we will believe from the client), MaxRewardUnits is budget (what we are willing to pay). At a 1:1 rate they coincide."
      },
      "SeasonTierRewardBundle": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this tier. Passed unmodified into ResourceService via a regular ResourceOperation.Grant."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this bundle to apply. Matches SeasonTierDefinition.Tier / UserSeasonState.CurrentTier."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to. Selection matches only tiers with the same SeasonChainID."
          }
        },
        "description": "Structurally different rewards for a season-chain tier. Analogous to PremiumTierBundle but the trigger is the player's season tier. Selection picks the single best match (MinSeasonTier <= playerTier); not stacked."
      },
      "SpecialGradationConfig": {
        "type": "object",
        "properties": {
          "Tiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SpecialGradationTier"
            },
            "description": "Time-ranked reward tiers (sorted ascending by ElapsedSeconds at Choose). Which of the reached tiers pay out is decided by TierMode."
          },
          "TierMode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SpecialTierMode"
              }
            ],
            "description": "How reached time tiers pay out. Default Highest - only the highest reached tier pays (the behaviour before this field existed). Cumulative - every reached tier pays and the rewards are summed."
          },
          "BelowFirstTierReward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Optional reward when claiming BEFORE the first tier (elapsed < Tiers[0].ElapsedSeconds). null = reject the early claim (Fail \"Play window not closed yet\")."
          }
        },
        "description": "Time-based reward ladder for a Timed Special choice: the longer the player waits before claiming, the higher the tier. Independent from SpecialRunStatsConfig - the two axes are summed."
      },
      "WeightedHeistCellBonus": {
        "type": "object",
        "properties": {
          "Tag": {
            "type": [
              "null",
              "string"
            ],
            "description": "Analytics/UI tag (\"small_token_bag\", \"big_token_bag\", \"shield_drop\"). Propagated to HeistCell.BonusTag at generation time."
          },
          "Bonus": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScaledResourceOperation"
              }
            ],
            "description": "Bonus payload. Only Bonus.Operation.Grant is used — Consume is ignored here (a cell bonus cannot be a cost). ScaleWithRollMultiplier: true scales Amount by RollMultiplier at cell generation; false = fixed reward."
          },
          "Weight": {
            "type": "integer",
            "format": "int32",
            "description": "Weight for weighted selection. Must be > 0."
          }
        },
        "description": "A single weighted bonus variant for HeistRaidVariant.BonusPool. The bonus is stored as a ScaledResourceOperation to share the multiplier-scaling pipeline and support premium fields inside Bonus.Operation.Grant."
      },
      "BoardTemplateDefinition": {
        "type": "object",
        "properties": {
          "Tiles": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ordered set of tiles forming the board ring. The element index matches BoardTileDefinition.Index.",
            "additionalProperties": {
              "$ref": "#/definitions/BoardTileDefinition"
            }
          }
        },
        "description": "Board template — a fixed tile ring shared across stages. Defines tile layout and types independently of stage economy."
      },
      "ProceduralEconomyConfig": {
        "type": "object",
        "properties": {
          "PerBoardGrowth": {
            "type": "number",
            "format": "double",
            "description": "Tail geometric growth of the unit price Unit(N) past the last authored anchor (extrapolation), e.g. 1.0035 (~ +0.35% per board). Required — must be set (> 0), no default."
          },
          "VisualTemplateCycle": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Visual-template cycle (BoardStageDefinition.BoardTemplateID) for synthesized endless boards: board N uses cycle[(N-1) % cycle.Count]. Empty - synthesis falls back to the first available template."
          },
          "EconomyScaledResources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Set of resources (currencies and/or items) scaled by EconomyScale(N) — a unified ResourceBundle (currencies/items in Entries, matched by category Item/currency + ID, case-insensitive). Amount is ignored — this is a selector, not a grant. null/empty = nothing is scaled."
          },
          "CostMatrixTemplatesByID": {
            "type": [
              "null",
              "object"
            ],
            "description": "Named normalized cost matrices (B1-L1 = 1.0). Key = PascalCase template ID (\"Universal\" = MGO default; \"WideSpread\" = e.g. board 9). A stage picks one via BoardStageDefinition.CostMatrixTemplateID. Level cost = ceil(Unit(N) * matrix[slot][level]). Non-separable -> stored whole. Required key \"Universal\" (matched case-insensitively).",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "array",
                "items": {
                  "type": "number",
                  "format": "double"
                }
              }
            }
          },
          "ScaleVictimLossWithTier": {
            "type": "boolean",
            "description": "Whether to apply the heist tier (x1/x2/x5) to the victim's loss."
          },
          "DifficultyGrowthPerBoard": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Geometric growth of board DIFFICULTY: how many times longer each next board takes on the same price curve. Divides EconomyScale(N) by G^(N-1), so income grows SLOWER than cost and rolls-per-board follow rolls(1) * G^(N-1) regardless of how irregular the UnitValue anchors are. Unlike the per-stage EconomyScale override this also covers synthesized endless boards, which have no Override at all. null or 1.0 = previous behaviour (constant pace); non-positive/NaN/Infinity are ignored."
          },
          "SynthesizedBuildingSlots": {
            "type": "integer",
            "format": "int32",
            "description": "Number of building slots for synthesized endless boards (beyond authored content). Required for endless boards — must be set (> 0), no default."
          },
          "AttackBlockedRewardFactor": {
            "type": "number",
            "format": "double",
            "description": "Attack reward multiplier when blocked by a shield (0 = no reward on block). Configured per title (no default)."
          },
          "AttackValueFromCostMatrix": {
            "type": "boolean",
            "description": "Whether to weight the attack payout by the value of the building hit (CostMatrix[slot][hitLevel-1]). When false, the attack pays a flat base."
          },
          "ScaleRaidStealWithEconomy": {
            "type": "boolean",
            "description": "Whether to scale the attacker's systemic raid gain by EconomyScale of their board."
          },
          "ScaleVictimLossWithEconomy": {
            "type": "boolean",
            "description": "Whether to scale the victim's intended loss by EconomyScale of the victim's board (before balance clipping)."
          },
          "SynthesizedBuildingMaxLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Building MaxLevel for synthesized endless boards. Required for endless boards — must be set (> 0), no default."
          },
          "ScaleAttackRewardWithEconomy": {
            "type": "boolean",
            "description": "Whether to scale the attack reward by EconomyScale of the attacker's board."
          }
        },
        "description": "Global procedural-economy parameters for the board. Any value may be overridden per-stage via BoardStageTemplate.EconomyOverride; these are the defaults."
      },
      "ScaledResourceOperation": {
        "type": "object",
        "properties": {
          "Operation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceOperation"
              }
            ],
            "description": "Resource operation (grant/consume) prior to scaling."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "true: all Amount values in the operation are multiplied by the current RollMultiplier before application (P_total = P_base * M_roll). false: Amount is passed to ResourceService unchanged. Typically true for rewards and false for costs."
          }
        },
        "description": "Wrapper over ResourceOperation that adds a roll-multiplier scaling flag. Used in all StageOperations hooks for the uniform P_total = P_base * M_roll formula."
      },
      "SpecialClaimMultipliers": {
        "type": "object",
        "properties": {
          "MaxAdViews": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum Apply calls (ad views / credit spends) per Timed flow. The server additionally clamps with an absolute ceiling of 10 — defence against malformed config."
          },
          "FormulaKind": {
            "oneOf": [
              {
                "$ref": "#/definitions/SpecialMultiplierFormulaKind"
              }
            ],
            "description": "How rolled values accumulate. Additive: rolled is added to AccumulatedMultiplier (start 0.0), final = Reward × (1 + AccumulatedMultiplier). Multiplicative: rolled is multiplied (start 1.0), final = Reward × AccumulatedMultiplier."
          },
          "AdCreditCost": {
            "type": "integer",
            "format": "int32",
            "description": "How many RewardedVideoCredit units are spent per Apply. Default 1."
          },
          "PerAdMultiplierRange": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardMultiplierRange"
              }
            ],
            "description": "Random multiplier range per single Apply (reuses RewardMultiplierRange). Min == Max = deterministic. For Additive, values 0..N represent the increment (neutral 0 = x1.0). For Multiplicative, values 1..N represent the multiplier itself."
          },
          "ApplyMultiplierOnEarlyClaim": {
            "type": "boolean",
            "description": "Whether to apply the AccumulatedMultiplier to the EarlyClaim reward — claiming BEFORE the first gradation tier (BelowFirstTierReward). On any REACHED tier the multiplier is always applied regardless of this flag. false (default) = no multiplier when claiming before the first tier; the ad views already spent are forfeited (board-game-style retention incentive). true = the multiplier is also applied to the EarlyClaim reward (fairer to the player, lower retention pressure)."
          }
        },
        "description": "Claim-multiplier rules for the Timed flow. One Board_SpecialApplyMultiplier rolls rolled in [PerAdMultiplierRange.Min, .Max], spends AdCreditCost RewardedVideoCredits and accumulates into pending state per FormulaKind."
      },
      "SpecialStatMetricConfig": {
        "type": "object",
        "properties": {
          "Rate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SpecialStatRateConfig"
              }
            ],
            "description": "LINEAR payout: the reward is proportional to the metric value itself, with no tiers. This is how \"you collected N coins in the run, you get N\" is expressed. Independent from Tiers and summed with it. Both unset = the metric pays nothing."
          },
          "Tiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SpecialStatTier"
            },
            "description": "Threshold ladder for the metric. Sorted and deduplicated by RequiredValue at Choose. An empty ladder means the metric pays nothing by tiers - unlike the time ladder this is NOT an error - but it may still pay linearly via Rate."
          },
          "MetricID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Metric ID. Normally equals the key in SpecialRunStatsConfig.MetricsByID; when unset the server substitutes the dictionary key."
          },
          "TierMode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SpecialTierMode"
              }
            ],
            "description": "How reached tiers pay out. Default Highest - same as the time ladder: only the highest reached tier pays."
          },
          "MaxValuePerClaim": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Cap on the accepted value per Claim. Anything above is CLAMPED (not rejected, not a ban): the reward is computed as if at the cap, and the fact is recorded in SpecialModeStats.StatReportsClampedCount and SpecialClaimResponse.RunStatsClamped. Default 0 = no cap. Set it from what is actually achievable within DurationSeconds, not from a round number."
          },
          "ApplyClaimMultiplier": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether this metric's reward is multiplied by the Claim's accumulated ad multiplier (SpecialClaimResponse.FinalMultiplier). Default false, deliberately: the multiplier is the price of ads applied to the TIME axis, while run statistics is a second, independent axis. Turning it on yields tier x statistics x ads on a single claim - three multipliers at once. Enable only if the economy budget can absorb it."
          }
        },
        "description": "A single run metric: its cap, tier payout mode and the threshold ladder itself. Nullable fields have no initializers (preset-merge rule: unset = from preset, set = final, including zero) - read them via SpecialDefinitionDefaults.Effective*."
      },
      "CommunityChestDefinition": {
        "type": "object",
        "properties": {
          "IsActive": {
            "type": "boolean",
            "description": "Whether the feature is active. false = no new groups are created and tile contribution is skipped."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor point (UTC). The first round starts here; all later dates are computed automatically. null = no anchor -> no rounds run."
          },
          "MaxRounds": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of rounds. 0 = infinite."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset paths (icon, banner).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "GrandPrize": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Grand Prize — granted to every member when the meter is filled to 100% (Status=Completed)."
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestones on the shared meter (unified MilestoneDefinition, Core/Milestone). Key = MilestoneID. When the threshold is reached, each member may claim the reward. Threshold is checked against shared group progress (not EventToken).",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name (for UI/CMS)."
          },
          "MaxProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum of the shared meter (100%). If <= 0, the largest Milestones[].RequiredProgress is used."
          },
          "PartnerCount": {
            "type": "integer",
            "format": "int32",
            "description": "Number of partners (excluding the initiator). Group size = 1 + PartnerCount."
          },
          "ContributionMax": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum contribution per landing. Actual value is uniform in [Min; Max]."
          },
          "ContributionMin": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum contribution per landing on the chest tile."
          },
          "RoundDurationSec": {
            "type": "integer",
            "format": "int64",
            "description": "Duration of a single chest round in seconds."
          },
          "PauseBetweenRoundsSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between rounds (seconds). No new groups are created during the pause."
          },
          "MemberGracePeriodMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "Grace period when a member leaves (minutes)."
          },
          "MatchmakingTimeoutMinutes": {
            "type": "integer",
            "format": "int32",
            "description": "Partner matchmaking timeout (minutes). Unfilled slots are taken by bots afterwards."
          },
          "ScaleContributionWithRollMultiplier": {
            "type": "boolean",
            "description": "If true, the contribution is multiplied by the used roll multiplier (usedMultiplier)."
          }
        },
        "description": "Cooperative Community Chest config. One shared meter per group, milestone rewards plus a final Grand Prize. Self-contained round schedule (anchor + duration + pause), independent of chains."
      },
      "SeasonTierRewardMultiplier": {
        "type": "object",
        "properties": {
          "Multiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier. 1.0 = neutral (resolver returns the base reward without copying). Rounding: (long)Math.Round(Amount * Multiplier). Entries with final Amount <= 0 are dropped."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this multiplier to apply."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to."
          }
        },
        "description": "Multiplier applied to Amount of the base ResourceGrant for a season-chain tier. Applied to every ResourceEntry.Amount and EventTokenOperation.Amount in Standard and in PremiumTiers.Resources."
      },
      "SpecialMultiplierFormulaKind": {
        "enum": [
          "Additive",
          "Multiplicative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Additive",
          "Multiplicative"
        ],
        "x-enum-descriptions": [
          "Sum: AccumulatedMultiplier += rolled (neutral 0.0).",
          "Product: AccumulatedMultiplier *= rolled (neutral 1.0)."
        ]
      }
    },
    "additionalProperties": false
  }

  arguments 2304 lines copy
• get_character unknown never probed

  GET ONLY the 'Character' field of TitlePublicConfigurationModel. Character/hero catalogue — playable units, NPCs, summons. Defines stats, abilities, evolution/level-up paths, art/asset references. Distinct from Item (generic inventory) — characters typically have progression and abilities. Skins (alternative looks) live per character in Skins.Definitions, and each skin IS a non-stackable, non-expiring Item from the Item section (Skins.Definitions.<id>.Item) — create that item first; any system that grants items (Store offers, lootboxes, season, quests, rewards) then grants the skin, and Item.Stats, if set, count toward Power like gear.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_character unknown never probed

  PARTIAL SAVE: writes ONLY the 'Character' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Character/hero catalogue — playable units, NPCs, summons. Defines stats, abilities, evolution/level-up paths, art/asset references. Distinct from Item (generic inventory) — characters typically have progression and abilities. Skins (alternative looks) live per character in Skins.Definitions, and each skin IS a non-stackable, non-expiring Item from the Item section (Skins.Definitions.<id>.Item) — create that item first; any system that grants items (Store offers, lootboxes, season, quests, rewards) then grants the skin, and Item.Stats, if set, count toward Power like gear.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "CharacterDefinitions",
        "properties": {
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterPresetRegistry"
              }
            ],
            "description": "Registry of shared (reusable) character setting sets (stats / levels / equipment). Characters reference them via CharacterDefinition.Presets. All blocks merge with inline by key: Stats by StatID, Levels by level key, Equipment by SlotID inside Slots. null = unused."
          },
          "Definitions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Character catalog. Key is CharacterID. The reserved \"Main\" character must also have an entry here. A character is allowed iff it has an entry in this dictionary.",
            "additionalProperties": {
              "$ref": "#/definitions/CharacterDefinition"
            }
          }
        },
        "description": "Configuration of the title's character system: the character catalog. Each entry in Definitions is self-contained (own stats, levels, equipment rules)."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "CurvePoint": {
        "type": "object",
        "properties": {
          "Value": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Value at this point. Empty = the point is ignored."
          },
          "AtStep": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Step (level / rank / stage) at which this point takes effect. Empty = the point is ignored."
          }
        },
        "description": "One breakpoint of a table curve."
      },
      "CurveShape": {
        "enum": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "x-enum-descriptions": [
          "Value does not change with the step. Same behaviour as an unset curve.",
          "Additive in the value's own units: base + PerStep * (step - firstStep).",
          "Additive share of the base: base * (1 + PerStepRate * (step - firstStep)). 0.1 = +10% of base per step.",
          "Compounding: base * (1 + GrowthRate)^(step - firstStep).",
          "Table of multipliers over the base: base * interpolate(Points, step).",
          "Table of absolute values: interpolate(Points, step). The base is ignored."
        ]
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "StatsPreset": {
        "type": "object",
        "properties": {
          "Stats": {
            "type": [
              "null",
              "object"
            ],
            "description": "Preset stat directory. Key is StatID. Same shape as CharacterDefinition.Stats.",
            "additionalProperties": {
              "$ref": "#/definitions/StatDefinition"
            }
          }
        },
        "description": "Shared, reusable upgradable-stat set. Stored in CharacterDefinitions.Presets.Stats by PresetID. Structurally identical to inline CharacterDefinition.Stats."
      },
      "LevelsPreset": {
        "type": "object",
        "properties": {
          "RankLadder": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterRankLadder"
              }
            ],
            "description": "Rank-ladder shape of the preset. Overridden by the character's inline RankLadder."
          }
        },
        "description": "Shared, reusable rank ladder. Stored in CharacterDefinitions.Presets.Levels by PresetID. There is no per-rank dictionary: ranks are described by one ladder."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "CharacterSkins": {
        "type": "object",
        "properties": {
          "Definitions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Skin catalog of this character. Key is SkinID; an empty SkinID field is taken from the key. Must not contain '.' or '$'.",
            "additionalProperties": {
              "$ref": "#/definitions/CharacterSkinDefinition"
            }
          },
          "DefaultSkinID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SkinID of the base look: an entry of Definitions WITHOUT Item. UI-only — equipping it is the same as removing the worn skin. null = the base look is the character's own Identity.AssetPaths."
          }
        },
        "description": "Skins block of a character: the catalog of alternative looks plus the base look."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "StatDefinition": {
        "type": "object",
        "properties": {
          "StatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique stat ID within the character (e.g. \"AttackSpeed\"). Used as the key in CharacterModel.StatLevels. Must not contain '.' or '$'."
          },
          "TypeID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stat category — free-form string ID referencing an external title-level catalog of stat types. Defines gameplay role and UI grouping. Same pattern as ItemMetadata.RarityID / CharacterClassification.ClassID: platform does not validate concrete values — this is an extension point for title developers. Recommended (non-binding) values: \"Generic\", \"PrimaryAttribute\", \"Vital\", \"Combat\", \"Resistance\", \"AttackType\", \"ArmorType\", \"Resource\". Must not contain '.' or '$' if used in query paths. null = category not specified (legacy-config fallback)."
          },
          "Weight": {
            "type": "integer",
            "format": "int32",
            "description": "Stat weight when computing the character's overall combat Power. Higher weight = bigger contribution from this stat."
          },
          "MaxLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Base maximum stat level. This is the BASE of CharacterDefinition.StatMaxLevelCurve — the character's rank may raise the cap. The effective value is produced by CharacterConfigResolver.EffectiveStatMaxLevel, the single place where the cap is derived."
          },
          "CostCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Cost curve over the level. The base is the price configured in PriceOptions; the step is the target level (numbered from 1). Empty = the same price at every level. Leave Base empty — the base is the configured price."
          },
          "RankCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Growth curve of this stat over the character's RANK. The base is the stat value at its own level (the result of ValueCurve), the step is the character rank (numbered from 1). Empty = rank does not affect this stat. The former CharacterLevelScalingFactor = 0.05 is Shape=PerStepRate with the same number. This per-stat curve is multiplied by CharacterDefinition.RankStatCurve, which applies to every stat at once. Leave Base empty."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Named asset references for the stat (e.g. \"icon\"). This is the only place stat asset paths live.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "ValueCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Growth curve of the stat value over the stat's OWN level. The base is BaseStatValue, the step is the stat level (numbered from 0). Empty = the stat does not grow when upgraded. The former StatScalingFactor added units per level — that is Shape=PerStep with the same number; the multiplicative base*(1+f*step) form is Shape=PerStepRate. Leave Base empty."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Text description of the stat and its in-game effect, for UI."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stat display name for the UI (localized or base)."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay per upgrade level. Dictionary key = PriceOption.OptionID; each option's Amount is the base cost for level 1, scaled by CostCurve. A store-paid option is not allowed here: a store SKU is a fixed price tier and cannot follow a per-level formula.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "Requirements": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/StatRequirement"
            },
            "description": "Prerequisite list. Before upgrading this stat to any level, each listed stat must have reached its required level. Checked in CharacterV2.UpgradeStatLevel before any cost is charged."
          },
          "BaseStatValue": {
            "type": "number",
            "format": "double",
            "description": "Base stat effect value — the value at level 0, i.e. for an unupgraded stat. This is the base of ValueCurve. Stat levels are numbered from 0 (a missing key in CharacterModel.StatLevels means level 0), unlike prices, item levels and ranks which are numbered from 1."
          }
        },
        "description": "Definition of one upgradable character stat (boost). Specifies upgrade rules: max level, cost, value scaling, requirements. Used in CharacterDefinition.Stats."
      },
      "CharacterUnlock": {
        "type": "object",
        "properties": {
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay for unlocking this character. Dictionary key = PriceOption.OptionID. null/empty = cannot be unlocked through a cost (must be granted by other systems).",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "UnlockedByDefault": {
            "type": "boolean",
            "description": "If true, the character is available without any unlock action. \"Main\" must have this set to true. Other characters typically default to false and rely on Cost or external grants (lootbox/quest reward)."
          }
        },
        "description": "Unlock rules for the character."
      },
      "EquipmentPreset": {
        "type": "object",
        "properties": {
          "Equipment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterEquipment"
              }
            ],
            "description": "Preset equipment rules (per-slot). Same shape as CharacterDefinition.Equipment."
          }
        },
        "description": "Shared, reusable equipment-rule set. Stored in CharacterDefinitions.Presets.Equipment by PresetID. Wraps the same CharacterEquipment used inline."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScalarCurveSpec": {
        "type": "object",
        "properties": {
          "Base": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Base the curve is computed from. Empty = use the base supplied by the caller. Fill it only where the base is a publisher setting (a multiplier starting at 1.5, a table's value before its first point) — where the base comes from data (a stat value, a level price, an item bonus) leaving it empty is required, otherwise it overrides the real base."
          },
          "Shape": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveShape"
              }
            ],
            "description": "Curve shape. Empty = Flat, i.e. no growth."
          },
          "Points": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CurvePoint"
            },
            "description": "Table breakpoints (Shape=Table or TableAbsolute). Empty = no growth."
          },
          "PerStep": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Units added per step (Shape=PerStep). Empty or 0 = no growth."
          },
          "MaxResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Upper bound of the result. Empty = there is NO upper bound (not 0)."
          },
          "MinResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Lower bound of the result. Empty = there is NO lower bound (not 0)."
          },
          "GrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Compounding rate per step (Shape=Geometric): 0.1 = x1.1 per step. Empty or 0 = no growth."
          },
          "PerStepRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Share of the base added per step (Shape=PerStepRate): 0.1 = +10% of base per step. Empty or 0 = no growth."
          },
          "Interpolation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveInterpolation"
              }
            ],
            "description": "How to interpolate between points. Empty = Step."
          },
          "TailGrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Growth beyond the last table point (share per step). Empty = hold the last point's value."
          }
        },
        "description": "Scalar curve f(base, step): how a value grows with a level, rank, stage or count. THE MODULE'S RULE: an empty field does nothing — an unset curve is the identity f(base,n)=base, an unset bound means there is no bound. All rates are shares (0.1 = +10%), never multipliers, so 0 and empty always mean the same thing."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "StatRequirement": {
        "type": "object",
        "properties": {
          "RequiredLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum level of RequiredStatID needed to unlock the dependent action."
          },
          "RequiredStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Dependency stat ID (StatDefinition.StatID) that must be upgraded to RequiredLevel. Must not contain '.' or '$'."
          }
        },
        "description": "Prerequisite that the referenced stat must reach the given level. Used in StatDefinition.Requirements and CharacterEquipmentSlot.StatRequirements."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "CharacterIdentity": {
        "type": "object",
        "properties": {
          "Lore": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional long-form lore / backstory for character detail screens."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Display order in roster UI. Lower values are listed first."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Named asset references (e.g. \"icon\", \"portrait\", \"fullArt\", \"sprite\", \"voiceIntro\"). This is the only place asset paths live.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Short description for UI tooltips."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name shown in UI (localized or base)."
          }
        },
        "description": "Identity / display metadata of a character. All assets live in AssetPaths only — there are no separate IconPath fields."
      },
      "CharacterSkinItem": {
        "type": "object",
        "properties": {
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item ID. Must not contain '.' or '$'."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Catalog of the item. Empty = resolved by ItemID when the item lives in exactly one catalog."
          }
        },
        "description": "Reference to the item that is the skin."
      },
      "CharacterSkinSale": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience allowed to buy. null = everyone."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Sale window. null = always on sale."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay. Dictionary key = PriceOption.OptionID. null/empty = not sold directly (granted by other systems only). An explicit option with an empty Cost is a free claim, limited by ownership.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          }
        },
        "description": "Direct sale of a skin from the character screen. Schedule and Gate restrict BUYING only — a skin the player already owns can always be worn."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "CharacterEquipment": {
        "type": "object",
        "properties": {
          "Slots": {
            "type": [
              "null",
              "object"
            ],
            "description": "Per-slot equipment rules. Key is SlotID. A character can equip into a slot iff it has an entry here — absence = slot forbidden.",
            "additionalProperties": {
              "$ref": "#/definitions/CharacterEquipmentSlot"
            }
          }
        },
        "description": "Equipment rules for the character. Per-slot configuration with character-level gates, stat prerequisites and item filters. Validated in addition to the item-side ItemEquipment rules."
      },
      "CurveInterpolation": {
        "enum": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "x-enum-descriptions": [
          "Step: hold the previous point's value until the next one. Behaviour of an unset field.",
          "Linear between adjacent points.",
          "Geometric between adjacent points: lo * (hi/lo)^t."
        ]
      },
      "CharacterDefinition": {
        "type": "object",
        "properties": {
          "Skins": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterSkins"
              }
            ],
            "description": "Character skins (alternative looks). A skin is an ITEM from Item.Catalogs: owning a skin means owning a copy of that item, wearing it binds that copy to the reserved equipment slot \"@skin\". Any system that grants items (Store, Lootbox, Season, Quest, Reward, manual grants) therefore grants skins too. If the item has Stats they count toward Power like gear; without Stats the skin is purely cosmetic. null = the character has no skins."
          },
          "Stats": {
            "type": [
              "null",
              "object"
            ],
            "description": "Per-character upgradable stat directory. Key is StatID. null/empty = no upgradable stats. Fully self-contained — no global fallback.",
            "additionalProperties": {
              "$ref": "#/definitions/StatDefinition"
            }
          },
          "Unlock": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterUnlock"
              }
            ]
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterPresetBindings"
              }
            ],
            "description": "Container of character preset wiring (stats / levels / equipment). All blocks merge with inline by key (preset base + inline override/add + Remove): Stats by StatID, Levels by level key, Equipment by SlotID inside Slots. Missing/invalid PresetID = no preset. null = presets unused. Resolved by CharacterConfigResolver."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterIdentity"
              }
            ]
          },
          "Equipment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterEquipment"
              }
            ]
          },
          "RankLadder": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterRankLadder"
              }
            ],
            "description": "Shape of the rank ladder: how many ranks and how the upgrade price grows. Empty = taken from the levels preset; empty there too = the previous path, where every rank is described by the Levels dictionary."
          },
          "CharacterID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique character ID. Reserved value \"Main\" denotes the always-available primary character. Must not contain '.' or '$' (MongoDB path restriction)."
          },
          "RankStatCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Curve of the GLOBAL stat multiplier over the character's rank: it applies to every stat at once, on top of the per-stat StatDefinition.RankCurve. The step is the rank (numbered from 1); leave Base empty, the curve is read as a multiplier. Empty = rank alone does not change stats. Replaces the former per-rank multiplier, whose neutral value was 1 rather than empty. Arbitrary per-rank values are written as Shape=Table (one point per rank); even growth as Shape=PerStepRate — multipliers 1.0/1.2/1.4 at ranks 1..3 are PerStepRate = 0.2."
          },
          "Classification": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterClassification"
              }
            ]
          },
          "StatMaxLevelCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Curve of the stat-upgrade CAP over the character's rank. The base is each stat's StatDefinition.MaxLevel, the step is the rank (numbered from 1). Empty = rank does not raise the cap. Replaces the former per-rank cap multiplier. Read in exactly one place — CharacterConfigResolver.EffectiveStatMaxLevel."
          }
        },
        "description": "One character template (hero) in the title catalog. Self-contained: identity, classification, unlock, equipment rules, stats, levels."
      },
      "CharacterRankLadder": {
        "type": "object",
        "properties": {
          "MaxRank": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many ranks the character has in total. Empty = the ceiling stays the highest rank present in the Levels dictionary (the previous behaviour)."
          },
          "CostCurve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Price growth over the rank. The base is the price in PriceOptions and the step is the rank, with FirstPaidRank counting as the first step. Empty = the same price at every rank. Leave Base empty."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Base upgrade price — the price of the first PAID rank (see FirstPaidRank). Higher ranks are scaled by CostCurve. A store-paid option is not allowed: the upgrade spans a range of ranks and is merged into one total, while a receipt pays for exactly one SKU.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "FirstPaidRank": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "First PAID rank. Ranks below it are free. Empty = 1, i.e. the first rank is already paid. This exists for activation: rank 0 means an inactive character, and the 0 -> 1 step is free in most titles because the character itself is paid for in CharacterUnlock.PriceOptions."
          }
        },
        "description": "The rank ladder: how many ranks there are and how the upgrade price grows. This is the ONLY source of rank prices — there is no per-rank dictionary. A non-uniform ladder is expressed by the curve shape (Table / TableAbsolute place a multiplier per rank). What the ladder cannot express is a different price COMPOSITION per rank: the composition is fixed by PriceOptions and the curve only scales the amount."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "CharacterEquipmentSlot": {
        "type": "object",
        "properties": {
          "SlotID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Slot identifier (e.g. \"Head\", \"Weapon\", \"Armor\"). Mirrors ItemEquipment.AllowedSlotIDs values."
          },
          "MaxItemLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum allowed item-instance level in this slot. 0 = no upper bound. Compared against UnstackableItemInstanceState.Level (per-instance)."
          },
          "MinItemLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum allowed item-instance level in this slot. 0 = no lower bound. Compared against UnstackableItemInstanceState.Level (per-instance, upgraded via ItemV2.UpgradeLevel)."
          },
          "AllowedItemTags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Item must have at least one of these tags (matches ItemDefinition.Tags). null/empty = no tag filter."
          },
          "AllowedRarityIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed item rarity IDs (matches ItemMetadata.RarityID). null/empty = any rarity."
          },
          "StatRequirements": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/StatRequirement"
            },
            "description": "Stat-level prerequisites the character must meet to use the slot. Reuses StatRequirement."
          },
          "MinCharacterLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum character Level required to use this slot. 0 = always available."
          }
        },
        "description": "Equip rules for one slot on one character. All gates must pass: character must satisfy unlock/stat gates, and the item must satisfy rarity/tag/level filters. Validated in addition to ItemEquipment rules on the item side."
      },
      "CharacterClassification": {
        "type": "object",
        "properties": {
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Free-form gameplay tags (e.g. \"ranged\", \"flying\", \"event-2026\"). Useful for UI filters and quest/lootbox targeting."
          },
          "ClassID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Character class identifier (e.g. \"Mage\", \"Warrior\")."
          },
          "RarityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Rarity identifier (e.g. \"Common\", \"Rare\", \"Epic\", \"Legendary\"). Same pattern as ItemMetadata.RarityID."
          }
        },
        "description": "Classification / categorical metadata. All fields are string IDs referencing external catalogs (no inline catalogs). Each field is optional — leave empty for systems the title does not use."
      },
      "CharacterPresetBindings": {
        "type": "object",
        "properties": {
          "Stats": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Stats preset binding (merge by StatID)."
          },
          "Levels": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Levels preset binding (merge by level key)."
          },
          "Equipment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Equipment preset binding (merge by SlotID inside Slots)."
          }
        },
        "description": "Container of character preset wiring — one PresetBinding per block. Inline data (Stats/Levels/Equipment) lives on CharacterDefinition. All blocks merge by key (Stats=StatID, Levels=level, Equipment=SlotID). null = presets unused."
      },
      "CharacterPresetRegistry": {
        "type": "object",
        "properties": {
          "Stats": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable stat sets keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/StatsPreset"
            }
          },
          "Levels": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable level/rank sets keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/LevelsPreset"
            }
          },
          "Equipment": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable equipment-rule sets keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/EquipmentPreset"
            }
          }
        },
        "description": "Container of character preset registries. Each field is a dictionary keyed by PresetID. Resolved at read-time via CharacterConfigResolver over PresetResolver."
      },
      "CharacterSkinDefinition": {
        "type": "object",
        "properties": {
          "Item": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterSkinItem"
              }
            ],
            "description": "The item that IS this skin. Must be a non-stackable item without an expiration: a worn copy is bound to the character and protected from sale, NFT withdrawal and expiry. null is allowed only for the entry named by DefaultSkinID."
          },
          "Sale": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterSkinSale"
              }
            ],
            "description": "Direct sale from the character screen (Character/UnlockSkin). null = not sold directly — the skin comes only from other systems (Store offer, lootbox, season, quest, reward, manual grant)."
          },
          "SkinID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique skin ID within the character. Empty = the dictionary key. Not stored in player state: the worn skin is identified by its item."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterIdentity"
              }
            ],
            "description": "Display name, description, sort order and look of the skin. AssetPaths here is the look ON the character (model, portrait); the item's own AssetPaths is its inventory icon."
          },
          "Requirements": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CharacterSkinRequirements"
              }
            ],
            "description": "Requirements to WEAR the skin. They gate wearing only; owning is never gated."
          }
        },
        "description": "One skin of a character."
      },
      "CharacterSkinRequirements": {
        "type": "object",
        "properties": {
          "StatRequirements": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/StatRequirement"
            },
            "description": "Stat-level prerequisites to wear the skin. Reuses StatRequirement."
          },
          "MinCharacterLevel": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum character Level (rank) to wear the skin. 0 = none."
          }
        },
        "description": "Requirements to wear a skin — the same axes as an equipment slot."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      }
    },
    "additionalProperties": false
  }

  arguments 1953 lines copy
• get_match unknown never probed

  GET ONLY the 'Match' field of TitlePublicConfigurationModel. PvP / match system configuration, grouped by battle mode under InstantBattle. Holds the instant-battle rule catalogue (keyed by RuleID) plus title-wide defaults. Each rule defines wager economy (prize-pool burn) and battle settings: a combat-role → StatID mapping (which Character stat drives HP/Damage/Armor/AttackSpeed/CritChance/CritDamage/Dodge/AllMight), combat params (max rounds, block effect, crit/dodge clamps) and optional per-stat custom formulas. Stat/formula fields reference Character.Stats StatIDs; equipment bonuses (Item) key off the same StatIDs.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_match unknown never probed

  PARTIAL SAVE: writes ONLY the 'Match' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. PvP / match system configuration, grouped by battle mode under InstantBattle. Holds the instant-battle rule catalogue (keyed by RuleID) plus title-wide defaults. Each rule defines wager economy (prize-pool burn) and battle settings: a combat-role → StatID mapping (which Character stat drives HP/Damage/Armor/AttackSpeed/CritChance/CritDamage/Dodge/AllMight), combat params (max rounds, block effect, crit/dodge clamps) and optional per-stat custom formulas. Stat/formula fields reference Character.Stats StatIDs; equipment bonuses (Item) key off the same StatIDs.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "MatchDefinitions",
        "properties": {
          "InstantBattle": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/InstantBattleDefinitions"
              }
            ],
            "description": "Instant-battle mode container: the rule catalog and title-wide defaults for immediate PvP. Future match modes (tournament, async turn-based) are added to MatchDefinitions as sibling containers. See InstantBattleDefinitions."
          }
        },
        "description": "Configuration of the title's PvP (Match) system. Grouped by battle mode: InstantBattle is the instant-battle container (rule catalog + title-wide defaults). Future match modes (tournament, async turn-based) are added here as sibling containers. Fully optional — absent config falls back to engine defaults (InstantBattle1v1 rule + DefaultData stat mapping), preserving legacy behavior."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "ArmorMode": {
        "enum": [
          "Flat",
          "PercentReduction"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Flat",
          "PercentReduction"
        ]
      },
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "CurvePoint": {
        "type": "object",
        "properties": {
          "Value": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Value at this point. Empty = the point is ignored."
          },
          "AtStep": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Step (level / rank / stage) at which this point takes effect. Empty = the point is ignored."
          }
        },
        "description": "One breakpoint of a table curve."
      },
      "CurveShape": {
        "enum": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "x-enum-descriptions": [
          "Value does not change with the step. Same behaviour as an unset curve.",
          "Additive in the value's own units: base + PerStep * (step - firstStep).",
          "Additive share of the base: base * (1 + PerStepRate * (step - firstStep)). 0.1 = +10% of base per step.",
          "Compounding: base * (1 + GrowthRate)^(step - firstStep).",
          "Table of multipliers over the base: base * interpolate(Points, step).",
          "Table of absolute values: interpolate(Points, step). The base is ignored."
        ]
      },
      "FormulaSpec": {
        "type": "object",
        "properties": {
          "Terms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/FormulaTerm"
            },
            "description": "Terms. Empty = the expression is not configured."
          }
        },
        "description": "Expression: a sum of terms, each term = coefficient x product(factors). A factor references variables and curves, never another expression, so the graph is acyclic by construction. An unset expression evaluates to null, NOT to zero — the caller substitutes its own default."
      },
      "FormulaTerm": {
        "type": "object",
        "properties": {
          "Factors": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/FormulaFactor"
            },
            "description": "Factors, multiplied together. Empty = the term equals the coefficient."
          },
          "Coefficient": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Coefficient of the term. Empty = 1."
          }
        },
        "description": "One term: Coefficient x product(Factors)."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "FormulaFactor": {
        "type": "object",
        "properties": {
          "Kind": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/FormulaFactorKind"
              }
            ],
            "description": "Factor kind. Empty = Constant."
          },
          "Curve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "The curve when Kind=Curve, evaluated at the context's step."
          },
          "OnePlus": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Wrap the value as (1 + value) — for '+50%'-style multipliers. Empty = use the raw value."
          },
          "Argument": {
            "type": [
              "null",
              "string"
            ],
            "description": "Argument of the variable (StatID, CurrencyID, ...). Its meaning is defined by the module."
          },
          "Constant": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "The number when Kind=Constant. Empty = 1 (does not change the product)."
          },
          "VariableID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Variable name when Kind=Variable. The vocabulary is owned by the consuming module and listed in that field's description; the platform does not validate it."
          }
        },
        "description": "One multiplicative factor of a term. An empty factor equals 1 — for a product that IS the neutral element, so the publisher never types 1."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScalarCurveSpec": {
        "type": "object",
        "properties": {
          "Base": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Base the curve is computed from. Empty = use the base supplied by the caller. Fill it only where the base is a publisher setting (a multiplier starting at 1.5, a table's value before its first point) — where the base comes from data (a stat value, a level price, an item bonus) leaving it empty is required, otherwise it overrides the real base."
          },
          "Shape": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveShape"
              }
            ],
            "description": "Curve shape. Empty = Flat, i.e. no growth."
          },
          "Points": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CurvePoint"
            },
            "description": "Table breakpoints (Shape=Table or TableAbsolute). Empty = no growth."
          },
          "PerStep": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Units added per step (Shape=PerStep). Empty or 0 = no growth."
          },
          "MaxResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Upper bound of the result. Empty = there is NO upper bound (not 0)."
          },
          "MinResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Lower bound of the result. Empty = there is NO lower bound (not 0)."
          },
          "GrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Compounding rate per step (Shape=Geometric): 0.1 = x1.1 per step. Empty or 0 = no growth."
          },
          "PerStepRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Share of the base added per step (Shape=PerStepRate): 0.1 = +10% of base per step. Empty or 0 = no growth."
          },
          "Interpolation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveInterpolation"
              }
            ],
            "description": "How to interpolate between points. Empty = Step."
          },
          "TailGrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Growth beyond the last table point (share per step). Empty = hold the last point's value."
          }
        },
        "description": "Scalar curve f(base, step): how a value grows with a level, rank, stage or count. THE MODULE'S RULE: an empty field does nothing — an unset curve is the identity f(base,n)=base, an unset bound means there is no bound. All rates are shares (0.1 = +10%), never multipliers, so 0 and empty always mean the same thing."
      },
      "MatchStatFormula": {
        "type": "object",
        "properties": {
          "Armor": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/FormulaSpec"
              }
            ],
            "description": "Formula for armor. null = default."
          },
          "Dodge": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/FormulaSpec"
              }
            ],
            "description": "Formula for dodge chance (before MaxDodgeChance clamp). null = default."
          },
          "Damage": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/FormulaSpec"
              }
            ],
            "description": "Formula for damage. null = default."
          },
          "Health": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/FormulaSpec"
              }
            ],
            "description": "Formula for max HP. null = default."
          },
          "CritChance": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/FormulaSpec"
              }
            ],
            "description": "Formula for crit chance (before MaxCritChance clamp). null = default."
          },
          "CritDamage": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/FormulaSpec"
              }
            ],
            "description": "Formula for crit-damage multiplier. null = default."
          },
          "AttackSpeed": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/FormulaSpec"
              }
            ],
            "description": "Formula for attack speed (initiative). null = default."
          }
        },
        "description": "Set of custom formulas for the engine's combat roles. Each role is optional: null = use the default formula (legacy or InstantBattleDefinitions.Defaults). Replace semantics (not merge). Role value = sum of terms; term = Coefficient * product(Factors). VOCABULARY for FormulaFactor.VariableID in this module: Stat (Argument = StatID, empty = this role's own mapped stat), RankMultiplier, AllMight, GearFlat (Argument = StatID), GearPercent (Argument = StatID). An unknown VariableID means NOT COMPUTED, not 0 — a typo shows up as 'my formula did not apply', never as a fighter with 1 HP. Factors reference Layer-1 stat values and multipliers, NOT other roles' final values (no cycles). Settings clamps/floors apply after the formula."
      },
      "CombatStatMapping": {
        "type": "object",
        "properties": {
          "ArmorStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "StatID driving armor. Whether it reduces damage as a flat subtraction or as a fraction is decided by MatchCombatSettings.ArmorMode, which also decides the meaningful scale of the stat's values. Default: \"Armor\"."
          },
          "DodgeStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "StatID driving dodge chance (0..1). Default: \"Speed\"."
          },
          "DamageStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "StatID driving damage. Default: \"Damage\"."
          },
          "HealthStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "StatID driving the fighter's max HP. Default: \"Health\"."
          },
          "AllMightStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "StatID of the global percent multiplier for HP/Damage (AllMight). Default: \"AllMight\"."
          },
          "CritChanceStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "StatID driving crit chance (0..1). Default: \"CritChance\"."
          },
          "CritDamageStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "StatID driving crit-damage multiplier. Default: \"CritDamage\"."
          },
          "AttackSpeedStatID": {
            "type": [
              "null",
              "string"
            ],
            "description": "StatID driving attack speed (initiative). Default: \"AttackSpeed\"."
          }
        },
        "description": "Maps the engine's combat roles to concrete character StatIDs (StatDefinition.StatID in CharacterDefinition.Stats). Lets a title decide which upgradable stat drives HP, damage, armor, etc. The same StatIDs key equipment flat/percent bonuses, so a remap automatically covers gear too. Any null/empty field inherits the built-in DefaultData default."
      },
      "EntryResourceKind": {
        "enum": [
          "VirtualCurrency",
          "Item",
          "EventToken",
          "CryptoCurrency"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "VirtualCurrency",
          "Item",
          "EventToken",
          "CryptoCurrency"
        ]
      },
      "EntryResourceRule": {
        "type": "object",
        "properties": {
          "Kind": {
            "oneOf": [
              {
                "$ref": "#/definitions/EntryResourceKind"
              }
            ],
            "description": "Resource kind this rule applies to."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item ID within the catalog (for Kind = Item). Key in cfg.Item.Catalogs[CatalogID].Items."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event ID within the system (for Kind = EventToken). null/empty = any event of that system."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog ID (for Kind = Item). Key in cfg.Item.Catalogs."
          },
          "MaxAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum amount of the entry position. 0 = no upper bound."
          },
          "MinAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum amount of the entry position. 0 = no lower bound."
          },
          "TokenType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "Event-token system (for Kind = EventToken)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency ID: a virtual currency (for Kind = VirtualCurrency, key in cfg.Currency.VirtualCurrencies) or a crypto currency (for Kind = CryptoCurrency, key in cfg.Currency.CryptoCurrencies)."
          }
        },
        "description": "One entry-whitelist rule: a concrete resource (or resource family) with amount bounds. An entry position matches by Kind and identifiers; 0 in Min/Max = unbounded on that side."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "FormulaFactorKind": {
        "enum": [
          "Constant",
          "Variable",
          "Curve"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Constant",
          "Variable",
          "Curve"
        ],
        "x-enum-descriptions": [
          "A number from the Constant field. Behaviour of an unset kind.",
          "A named module variable (VariableID plus an optional Argument).",
          "The value of the Curve field at the context's current step."
        ]
      },
      "InstantBattleRule": {
        "type": "object",
        "properties": {
          "Entry": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MatchEntrySettings"
              }
            ],
            "description": "Entry policy for the rule: which resources a player may commit to participate and within what bounds. Match-level (not battle). null = inherit InstantBattleDefinitions.EntryDefaults, then engine default (any virtual currency). See MatchEntrySettings."
          },
          "RuleID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique rule identifier (mirrors the Rules dictionary key). Passed by the client in CreateMatch/InstantBattle requests."
          },
          "Economy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MatchEconomySettings"
              }
            ],
            "description": "Economy settings for the rule (reward burn share). Match-level: about the entry and reward. null = defaults (see MatchEconomySettings)."
          },
          "Creation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MatchCreationSettings"
              }
            ],
            "description": "Offer-creation settings for the rule: creation cost, limits and anti-abuse controls. Match-level (not battle). null = inherit InstantBattleDefinitions.CreationDefaults, then engine default (free, no limits). See MatchCreationSettings."
          },
          "Settings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/InstantBattleSettings"
              }
            ],
            "description": "Battle settings for the rule: role → StatID mapping, combat params (rounds/block/clamps) and stat formulas. Each nested block is optional and inherits from InstantBattleDefinitions.Defaults, then engine built-in defaults. See InstantBattleSettings."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Text description of the rule, for UI."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name shown in UI (localized or base)."
          }
        },
        "description": "One instant-battle rule. Stored in InstantBattleDefinitions.Rules by RuleID. Split into match-level economy (Economy, about the entry and reward) and battle settings (Settings). Any unset block inherits title/engine defaults."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "CurveInterpolation": {
        "enum": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "x-enum-descriptions": [
          "Step: hold the previous point's value until the next one. Behaviour of an unset field.",
          "Linear between adjacent points.",
          "Geometric between adjacent points: lo * (hi/lo)^t."
        ]
      },
      "MatchEntrySettings": {
        "type": "object",
        "properties": {
          "Allowed": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EntryResourceRule"
            },
            "description": "Whitelist of allowed entry resources with Min/Max bounds. When NON-empty it is authoritative: every entry position must match one of the rules and the type flags are ignored. Empty/null = type flags decide (amounts just > 0)."
          },
          "AllowItems": {
            "type": "boolean",
            "description": "Allow any stackable catalog items as an entry position. Unstackable items are always rejected. Default: false. Ignored when Allowed is non-empty."
          },
          "MaxPositions": {
            "type": "integer",
            "format": "int32",
            "description": "Max number of positions in the entry bundle (Entries + EventTokens). Sanity cap against match-doc / dual-op bloat. Default: 10. 0 = no limit."
          },
          "AllowEventTokens": {
            "type": "boolean",
            "description": "Allow event tokens as an entry position. Default: false. Ignored when Allowed is non-empty."
          },
          "AllowCryptoCurrency": {
            "type": "boolean",
            "description": "Allow the title's crypto currencies as an entry position (whole tokens, no USD amount). Default: false — a crypto match is money between players and must be enabled explicitly. The winner receives double the entry minus the developer's trade fee (CryptoCurrencyDefinition.PlayerTradeFeePercent); BurnRate does not apply to crypto. Ignored when Allowed is non-empty."
          },
          "AllowVirtualCurrency": {
            "type": "boolean",
            "description": "Allow any of the title's virtual currencies as an entry position (no amount bounds). Default: true. Ignored when Allowed is non-empty."
          }
        },
        "description": "Instant-battle entry policy: which resources a player may commit to participate and within what bounds. The entry is a ResourceBundle (currencies, stackable items, event tokens); both sides commit the same set and the winner receives double of each position (burn applies to virtual currencies only). Two control levels: type flags (AllowVirtualCurrency/AllowItems/AllowEventTokens = 'any resource of this type', no amount bounds) and the Allowed whitelist — when NON-empty it is authoritative: every entry position must match one of its rules (incl. Min/Max) and the type flags are ignored. Unstackable items are always rejected (refund/payout would recreate the instance and lose upgrade state). Event tokens: refunds/rewards credited to an ended event may become unclaimable after grace — whitelist long-lived systems (e.g. Season) only."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "MatchCombatSettings": {
        "type": "object",
        "properties": {
          "ArmorMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ArmorMode"
              }
            ],
            "description": "How armor reduces damage. Default: Flat (the engine's historical behavior), so a title that does not set this field is unaffected."
          },
          "MaxRounds": {
            "type": "integer",
            "format": "int32",
            "description": "Max number of battle rounds. On timeout the fighter with more HP wins (tie = draw). Default: 50."
          },
          "MinHitDamage": {
            "type": "number",
            "format": "double",
            "description": "Minimum damage of a hit after armor reduction, in both ArmorModes. Last line of defence: armor above 100% (or above the raw damage) can never push damage negative, i.e. heal the defender. Default: 1. Size it against the title's damage scale - if early-level damage is comparable to the floor, the floor eats the whole reduction and armor stops reading until damage outgrows it."
          },
          "MaxCritChance": {
            "type": "number",
            "format": "double",
            "description": "Upper clamp on the final crit chance (after stats and gear). Default: 0.6. Set to 1.0 to effectively disable."
          },
          "MaxDodgeChance": {
            "type": "number",
            "format": "double",
            "description": "Upper clamp on the final dodge chance (after stats and gear). Default: 0.4. Set to 1.0 to effectively disable."
          },
          "MaxArmorReduction": {
            "type": "number",
            "format": "double",
            "description": "Upper bound on armor in PercentReduction mode (the lower bound is 0). Default: 0.9, i.e. at most 90% reduction. Not applied at all in Flat mode, where armor lives in damage units and 12 or 500 are both meaningful."
          },
          "BlockDamageMultiplier": {
            "type": "number",
            "format": "double",
            "description": "Fraction of potential damage that still lands on a block (attack zone == defense zone). Default: 0.01 (1%)."
          },
          "DefaultCritMultiplier": {
            "type": "number",
            "format": "double",
            "description": "Default crit-damage multiplier used when the crit-damage stat is absent/zero. Default: 1.5."
          }
        },
        "description": "Combat parameters of a PvP rule. All values have sensible defaults identical to the engine's historical behavior."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "MatchEconomySettings": {
        "type": "object",
        "properties": {
          "BurnRate": {
            "type": "number",
            "format": "double",
            "description": "Fraction of the reward burned when granting it to the winner. burn = floor(reward * BurnRate); the winner gets the remainder. Default: 0.05 (5%). 0 = no burn."
          }
        },
        "description": "Economy parameters of a PvP rule."
      },
      "InstantBattleSettings": {
        "type": "object",
        "properties": {
          "Combat": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MatchCombatSettings"
              }
            ],
            "description": "Combat params (round count, block effect, chance clamps, etc.). null = inherit InstantBattleDefinitions.Defaults block, then engine defaults (see MatchCombatSettings)."
          },
          "Formula": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MatchStatFormula"
              }
            ],
            "description": "Custom combat-role formulas. Per-role: a role with a formula uses it; a role without falls back to InstantBattleDefinitions.Defaults, then the engine's built-in default formula. See MatchStatFormula."
          },
          "StatMapping": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CombatStatMapping"
              }
            ],
            "description": "Combat-role → StatID mapping. Overlay per-role: set roles override the title default, unset roles inherit built-in defaults. See CombatStatMapping."
          }
        },
        "description": "Instant-battle settings block. Used both as InstantBattleRule.Settings (per-rule) and InstantBattleDefinitions.Defaults (title-wide). All three blocks are optional and inherit: rule → InstantBattleDefinitions.Defaults → engine built-in defaults."
      },
      "MatchCreationSettings": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Offer-creation limits. Only the CooldownSeconds (between creations) and DailyCap (per UTC calendar day) axes are enforced; other axes are ignored. null = no limits."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay for creating an offer. Dictionary key = PriceOption.OptionID. null/empty = free. Only the option's Cost.Standard is honored (premium fields ignored — the amount refundable on cancel must be deterministic and is snapshotted into the match doc). A store-paid option is not allowed: the fee may have to be refunded, and a store refund is not ours to issue.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "MaxOpenMatches": {
            "type": "integer",
            "format": "int32",
            "description": "Max simultaneously open offers per player (checked at CreateMatch). 0 = no limit."
          },
          "RefundCostOnCancel": {
            "type": "boolean",
            "description": "Whether to refund the creation cost when the creator cancels the offer (CancelMatch). Default: false — the cost is sunk (deters create/cancel spam). On a played match the cost is always sunk regardless of this flag."
          },
          "AllowPrivateMatches": {
            "type": "boolean",
            "description": "Whether private offers (with TargetUserID) are allowed. Default: true."
          },
          "OfferLifetimeSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Offer lifetime in seconds since creation. An expired offer is hidden from listings, cannot be joined and does not count toward MaxOpenMatches; a timer refunds the creator's entry (status Expired), the creation cost per RefundCostOnCancel. Snapshotted into the match at creation (PvPMatch.ExpiresAt): editing the config does not affect already-open offers. 0 = never expires."
          },
          "MaxMatchesPerOpponentPerDay": {
            "type": "integer",
            "format": "int32",
            "description": "Max completed matches between the same pair of players per UTC calendar day (both directions). Anti-win-trading: limits resource funneling between alts. Authoritative check runs at InstantBattle. 0 = no limit."
          }
        },
        "description": "PvP offer-creation settings: creation cost and anti-abuse controls. The creation cost is charged to the creator at CreateMatch SEPARATELY from the entry; it never enters the reward, is always sunk on a played match, and is refunded on cancel only when RefundCostOnCancel = true."
      },
      "InstantBattleDefinitions": {
        "type": "object",
        "properties": {
          "Rules": {
            "type": [
              "null",
              "object"
            ],
            "description": "Instant-battle rule catalog. Key is RuleID (e.g. \"InstantBattle1v1\"). The client passes RuleID into CreateMatch/InstantBattle; a rule is allowed iff it has an entry here (or is the built-in InstantBattle1v1 when no config exists).",
            "additionalProperties": {
              "$ref": "#/definitions/InstantBattleRule"
            }
          },
          "Defaults": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/InstantBattleSettings"
              }
            ],
            "description": "Title-wide instant-battle defaults: role → StatID mapping, combat params and formulas. Applied per-block/per-role when a rule's Settings omits the same block. Anything unset here inherits engine built-in defaults. See InstantBattleSettings."
          },
          "EntryDefaults": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MatchEntrySettings"
              }
            ],
            "description": "Title-wide instant-battle entry policy: which resources a player may commit to participate and within what bounds. Applied block-level when a rule omits its own Entry. Unset here too = engine default (any virtual currency). See MatchEntrySettings."
          },
          "CreationDefaults": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MatchCreationSettings"
              }
            ],
            "description": "Title-wide offer-creation settings: creation cost, limits and anti-abuse controls. Applied block-level when a rule omits its own Creation. Unset here too = engine default (free, no limits). See MatchCreationSettings."
          }
        },
        "description": "Configuration of the instant-battle mode (immediate PvP simulation in PvPBattleEngine). Holds the rule catalog (Rules, keyed by RuleID) and title-wide defaults (Defaults) applied when a rule omits its own."
      }
    },
    "additionalProperties": false
  }

  arguments 1240 lines copy
• get_collection unknown never probed

  GET ONLY the 'Collection' field of TitlePublicConfigurationModel. Collection / album / codex definitions — sets of items, cards, characters or achievements players collect. Defines what counts as the collection, completion rewards, and tier/rarity grouping. Use for compendium-style meta content.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_collection unknown never probed

  PARTIAL SAVE: writes ONLY the 'Collection' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Collection / album / codex definitions — sets of items, cards, characters or achievements players collect. Defines what counts as the collection, completion rewards, and tier/rarity grouping. Use for compendium-style meta content.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "CollectionDefinitions",
        "properties": {
          "Settings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CollectionGlobalSettings"
              }
            ],
            "description": "Module-wide settings shared by every collection and pack type of the title. null = platform defaults apply (see CollectionDefinitionDefaults)."
          },
          "PackTypes": {
            "type": [
              "null",
              "object"
            ],
            "description": "Collection pack types (lootboxes). Key is PackTypeID. Recommended keys by descending rarity: \"green\", \"blue\", \"orange\", \"purple\".",
            "additionalProperties": {
              "$ref": "#/definitions/CollectionPackTypeDefinition"
            }
          },
          "Collections": {
            "type": [
              "null",
              "object"
            ],
            "description": "All collections in the title. Key is CollectionID. The active collection is determined via SeasonDefinition.LinkedCollectionID (or directly when the season system is not used).",
            "additionalProperties": {
              "$ref": "#/definitions/CollectionDefinition"
            }
          },
          "RewardPools": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardPoolLibrary"
              }
            ],
            "description": "Reusable reward-pool library scoped to THIS module (not title-wide — Lootbox has its own, separate one). PackType and CollectionChest entries reference it via their Presets container. null = presets unused."
          },
          "DailyTradeLimit": {
            "type": "integer",
            "format": "int32",
            "description": "Daily limit of outgoing P2P trades per player. Controls collection completion speed via trading."
          },
          "CollectionChests": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CollectionChestDefinition"
            },
            "description": "CollectionChest configurations (Pity System mechanic). Chests spend CollectionCurrency accrued from duplicates and return guaranteed Collectibles."
          },
          "SpecialTradeEvents": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SpecialTradeEventDefinition"
            },
            "description": "SpecialTradeEvent configurations — limited time windows in which Special-version Collectibles can be exchanged. Prevents whales from completing the collection too quickly."
          },
          "DuplicateConversions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DuplicateCollectionCurrencyConversion"
            },
            "description": "Table that converts duplicates into CollectionCurrency by Collectible rarity. Conversion happens automatically when a duplicate is received."
          },
          "CollectibleJokerItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ItemID of the item used as CollectibleJoker (Wild Card). Stored in InventoryV2.Items, does not burn on season change. Granted via BonusRewardSlots, milestone rewards, streaks, event shops."
          },
          "CollectibleJokerCatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "CatalogID of the catalog containing the joker ItemDefinition. Must reference an existing ItemCatalog in cfg.Item.Catalogs."
          }
        },
        "description": "Root collection-system config for the title. Add to TitlePublicConfigurationModel as: public CollectionDefinitions Collection { get; set; }"
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "PityRuleSet": {
        "type": "object",
        "properties": {
          "PityRules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxPityRule"
            }
          }
        },
        "description": "Thin wrapper for a reusable pity-rule set."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "RewardSlotSet": {
        "type": "object",
        "properties": {
          "RewardSlots": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardSlot"
            }
          }
        },
        "description": "Thin wrapper for a reusable reward-slot set."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "LootboxPityRule": {
        "type": "object",
        "properties": {
          "Pool": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardRoll"
            },
            "description": "Weighted pool of possible pity rewards. Each rule fire performs one roll over Pool (by Weight, like LootboxRewardSlot.Pool). If an entry has AmountRange, it is applied to the rolled reward."
          },
          "RuleID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Rule identifier within the lootbox (e.g. \"guaranteed_5star\", \"guaranteed_legendary\"). Used as part of the counter storage key. Must be stable — renaming resets player counters."
          },
          "Threshold": {
            "type": "integer",
            "format": "int32",
            "description": "How many openings without a hit before the reward is guaranteed. Threshold=10 means on the 10th, 20th, 30th opening the player receives a roll from Pool. Must be >= 1."
          }
        },
        "description": "Pity guarantee rule. Fires every Threshold openings of the specific lootbox. When fired, one random reward from Pool is rolled by weights, just like normal RewardSlots. Lets pity be configured as a weighted pool rather than a single fixed award."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "LootboxRewardRoll": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Resource reward of this roll. Grant-only: Standard.Items, Standard.EventTokens, PremiumTiers. For random amount use AmountRange. Use separate entries for distinct items so AmountRange doesn't apply to all simultaneously."
          },
          "Weight": {
            "type": "integer",
            "format": "int32"
          },
          "AmountRange": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LootboxAmountRange"
              }
            ],
            "description": "Optional range that randomly picks final Amount. On each roll N is chosen in [Min, Max] inclusive and REPLACES Amount on every Item/EventToken in Reward. Best used with single-resource Reward entries. null = use Amount from Reward as-is."
          }
        }
      },
      "LootboxRewardSlot": {
        "type": "object",
        "properties": {
          "Pool": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardRoll"
            },
            "description": "Weighted reward pool of this slot. Each roll picks one entry by Weight."
          },
          "SlotID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Slot identifier for analytics / UI / debugging (\"guaranteed_coins\", \"bonus_item\")."
          },
          "MaxRolls": {
            "type": "integer",
            "format": "int32"
          },
          "MinRolls": {
            "type": "integer",
            "format": "int32",
            "description": "Number of rolls over Pool per lootbox opening. Chosen uniformly random in [Min, Max]. To make the slot guaranteed set Min=Max=1; to make it optional set Min=0."
          }
        }
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "RewardPoolLibrary": {
        "type": "object",
        "properties": {
          "PityPresets": {
            "type": [
              "null",
              "object"
            ],
            "description": "Pity-rule sets keyed by PresetID. Mirrors the inline PityRules shape.",
            "additionalProperties": {
              "$ref": "#/definitions/PityRuleSet"
            }
          },
          "SlotPresets": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reward-slot sets keyed by PresetID. Mirrors the inline RewardSlots/BonusRewardSlots shape.",
            "additionalProperties": {
              "$ref": "#/definitions/RewardSlotSet"
            }
          }
        },
        "description": "Library of reusable reward sets scoped to a single owning module. Each module keeps its OWN instance: LootboxDefinitions.RewardPools and CollectionDefinitions.RewardPools are two independent registries, NOT shared across the title (Lootbox presets are not visible to Collection or vice versa). The same drop-table (reward-slot set and/or pity-rule set) is authored once within the module; its entities reference it by PresetID instead of inlining a heavy pool in every entity. Resolved at read-time via RewardSlotHelpers (replace: a non-empty inline overrides the preset). null = unused."
      },
      "LootboxAmountRange": {
        "type": "object",
        "properties": {
          "Max": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Amount value (inclusive). Must be >= Min."
          },
          "Min": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Amount value (inclusive). Must be >= 0."
          }
        }
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "CollectionDefinition": {
        "type": "object",
        "properties": {
          "Sets": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CollectionSetDefinition"
            },
            "description": "All Sets in the collection (analogous to album pages). Display order is determined by CollectionSetDefinition.SortOrder."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Paths to collection assets (album cover, background art). Order and purpose are determined by the client.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "GrandPrize": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Grand Prize for full collection completion (grant only)."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description of the collection for UI."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the collection."
          },
          "CollectionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique ID of the collection within the title. Used as the key in CollectionDefinitions.Collections."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional binding to a season chain. null — the collection operates independently of the season system. If set — collection wipe is synced with season change."
          }
        },
        "description": "A single collection — top level of the hierarchy. Groups all Sets of one thematic (season) bundle. Completing it (all Collectibles + all Gold) grants the Grand Prize."
      },
      "CollectibleDefinition": {
        "type": "object",
        "properties": {
          "Rarity": {
            "type": "integer",
            "format": "int32",
            "description": "Rarity of the Collectible: 1 (common) to 5 (legendary). Affects drop frequency, CollectionCurrency yield on duplicate conversion, and CollectionChest availability."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Display order of the Collectible within the Set (lower = earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Paths to Collectible assets (regular and Special version images). The client decides which asset belongs to which version.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the Collectible."
          },
          "CollectibleID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique ID of the Collectible within the collection. Used as the key in player state dictionaries."
          },
          "HasSpecialVersion": {
            "type": "boolean",
            "description": "Whether a Special version of this Collectible exists. Special versions trade only during SpecialTradeEventDefinition windows. CollectibleJoker cannot be used to obtain a Special version."
          }
        },
        "description": "A single Collectible (analogous to a sticker in an album). The base unit of a collection. May have a Special version."
      },
      "CollectionSetDefinition": {
        "type": "object",
        "properties": {
          "SetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique ID of the Set within the collection."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Display order of the Set within the collection (lower = earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Paths to Set assets (page cover, thematic illustration).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the Set."
          },
          "Collectibles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CollectibleDefinition"
            },
            "description": "Collectibles that belong to the Set. Typically 9, but the count is configurable."
          },
          "SetCompletionReward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "One-time reward for completing the Set (grant only)."
          }
        },
        "description": "Set — a thematic group of Collectibles inside a collection (analogous to an album page). Completing the Set (all Collectibles collected) grants SetCompletionReward."
      },
      "CollectionGlobalSettings": {
        "type": "object",
        "properties": {
          "MaxPackOpenCount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max packs per single OpenPack call for every pack type of the title. Overridden per pack type via CollectionPackTypeDefinition.MaxOpenCount. null = platform default (CollectionDefinitionDefaults.DefaultMaxPackOpenCount). <= 0 = opening disabled. A client-requested count is CLAMPED to this ceiling, not rejected."
          },
          "MaxChestOpenCount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Same for collection chests (OpenCollectionChest). A separate setting rather than shared with packs: chests are bought with duplicate currency and may warrant a different cap. Overridden per chest via CollectionChestDefinition.MaxOpenCount."
          }
        },
        "description": "Module-wide Collection settings. Each value applies to every collection and pack type of the title unless the entity overrides it."
      },
      "CollectionChestDefinition": {
        "type": "object",
        "properties": {
          "Tier": {
            "type": "integer",
            "format": "int32",
            "description": "Visual CollectionChest tier for sorting and UI display. 1 = Bronze, 2 = Silver, 3 = Gold."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CollectionRewardPresetBindings"
              }
            ],
            "description": "Container of chest preset wiring (bonus slots / pity rules). Registry is this module's CollectionDefinitions.RewardPools. null = presets unused."
          },
          "PityRules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxPityRule"
            },
            "description": "Pity rules. Behaves identically to LootboxV2: every Threshold openings guarantees one roll from the rule's Pool. Counters live in UserCollectionState.PityCounters. When Presets.PityRules is set, merged with the preset by RuleID key (preset base + inline override/add)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Paths to CollectionChest assets (image, opening animation).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the CollectionChest."
          },
          "MaxOpenCount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max chests of THIS type per single OpenCollectionChest call. Overrides CollectionGlobalSettings.MaxChestOpenCount. null = fall back to the module setting, then to the platform default. <= 0 = this chest cannot be opened. Read only via CollectionDefinitionDefaults.EffectiveMaxChestOpenCount."
          },
          "BonusRewardSlots": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardSlot"
            },
            "description": "Weighted pools of bonus rewards granted alongside Collectibles. Same mechanism as LootboxV2: each slot independently performs [MinRolls, MaxRolls] rolls over its Pool with AmountRange and weights support. When Presets.BonusRewardSlots is set, merged with the preset by SlotID key (preset base + inline override/add)."
          },
          "CollectionChestID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique ID of the CollectionChest within the title. Example: \"CollectionChest_bronze\", \"CollectionChest_silver\", \"CollectionChest_gold\"."
          },
          "GuaranteedMinRarity": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum guaranteed rarity of Collectibles from the CollectionChest. All dropped Collectibles will have rarity at least this value."
          },
          "MaxCollectibleCount": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of Collectibles granted from the CollectionChest. Actual count is chosen randomly in [MinCollectibleCount; MaxCollectibleCount]."
          },
          "MinCollectibleCount": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum number of Collectibles granted from the CollectionChest."
          },
          "CollectionCurrencyCost": {
            "type": "integer",
            "format": "int32",
            "description": "Cost of opening the CollectionChest in CollectionCurrency."
          }
        },
        "description": "CollectionChest — Pity System mechanic. Player spends CollectionCurrency (accrued from duplicates) and receives guaranteed Collectibles with a minimum rarity. Three standard tiers: Bronze, Silver, Gold."
      },
      "SpecialTradeEventDefinition": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "End of the SpecialTradeEvent window (UTC). null = unset -> the window never opens (both bounds are required)."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Start of the SpecialTradeEvent window (UTC). null = unset -> the window never opens (both bounds are required)."
          },
          "SpecialTradeEventID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique ID of the SpecialTradeEvent."
          },
          "AllowedSpecialCollectibleIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "List of CollectibleIDs whose Special versions are allowed to be traded during this window. Typically 2-3 Collectibles."
          },
          "SpecialTradeEventDailyTradeLimit": {
            "type": "integer",
            "format": "int32",
            "description": "Increased daily trade limit during the SpecialTradeEvent. 0 — use the global CollectionDefinitions.DailyTradeLimit."
          }
        },
        "description": "SpecialTradeEvent — a limited time window in which P2P trading of Special-version Collectibles is allowed. Blitz windows (typically 4 hours) let 2-3 specific Special Collectibles be exchanged. Anti-whale mechanic."
      },
      "CollectionPackTypeDefinition": {
        "type": "object",
        "properties": {
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CollectionRewardPresetBindings"
              }
            ],
            "description": "Container of pack preset wiring (bonus slots / pity rules). Registry is this module's CollectionDefinitions.RewardPools. null = presets unused."
          },
          "ColorTier": {
            "type": "integer",
            "format": "int32",
            "description": "Visual tier of the pack for sorting and UI. 1 = Green, 2 = Blue, 3 = Orange, 4 = Purple."
          },
          "PityRules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxPityRule"
            },
            "description": "Pack pity rules. Behaves identically to LootboxV2: every Threshold openings of this pack guarantees one roll from the rule's Pool. Counters live in UserCollectionState.PityCounters. When Presets.PityRules is set, merged with the preset by RuleID key (preset base + inline override/add)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Paths to pack assets (image, opening animation).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "PackTypeID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique pack type ID. Recommended values: \"green\", \"blue\", \"orange\", \"purple\"."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the pack."
          },
          "MaxOpenCount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max packs of THIS type per single OpenPack call. Overrides CollectionGlobalSettings.MaxPackOpenCount. null = fall back to the module setting, then to CollectionDefinitionDefaults.DefaultMaxPackOpenCount. <= 0 = this pack type cannot be opened. Read only via CollectionDefinitionDefaults.EffectiveMaxPackOpenCount."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay. Dictionary key = PriceOption.OptionID; the player picks one. Empty/null = free.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "RarityWeights": {
            "type": [
              "null",
              "object"
            ],
            "description": "Collectible drop weights by rarity for non-guaranteed slots. Key is rarity as string (\"1\"..\"5\"), value is an arbitrary weight. Server normalizes: P(rarity) = weight / sum(all weights).",
            "additionalProperties": {
              "type": "integer",
              "format": "int32"
            }
          },
          "BonusRewardSlots": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardSlot"
            },
            "description": "Weighted pools of bonus rewards granted alongside Collectibles. Each slot independently performs [MinRolls, MaxRolls] rolls over its Pool. Uses the same mechanism as LootboxV2. When Presets.BonusRewardSlots is set, merged with the preset by SlotID key (preset base + inline override/add)."
          },
          "CollectibleCount": {
            "type": "integer",
            "format": "int32",
            "description": "Total Collectible count in the pack. Typical values: 3 (Green), 4 (Blue/Orange), 5 (Purple)."
          },
          "GuaranteeMaxRarity": {
            "type": "boolean",
            "description": "If true, the pack guarantees at least one Collectible of maximum rarity (5 stars). Used for Purple packs."
          },
          "GuaranteedMinRarity": {
            "type": "integer",
            "format": "int32",
            "description": "Guaranteed minimum rarity for at least one Collectible in the pack. Remaining slots are filled according to RarityWeights."
          }
        },
        "description": "Pack type for the collection (lootbox). Defines Collectible count, rarity guarantees and drop weights. Example tiers by color: Green -> Blue -> Orange -> Purple."
      },
      "CollectionRewardPresetBindings": {
        "type": "object",
        "properties": {
          "PityRules": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Pity-rule preset binding (merge by RuleID)."
          },
          "BonusRewardSlots": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Bonus reward-slot preset binding (merge by SlotID)."
          }
        },
        "description": "Container of reward preset wiring for PackType/Chest — one PresetBinding per block. Inline data (BonusRewardSlots/PityRules) lives on the entity. Resolved via RewardSlotHelpers over PresetResolver. null = presets unused."
      },
      "DuplicateCollectionCurrencyConversion": {
        "type": "object",
        "properties": {
          "Rarity": {
            "type": "integer",
            "format": "int32",
            "description": "Rarity of the duplicate Collectible (1-5). Must match CollectibleDefinition.Rarity."
          },
          "CollectionCurrencyGranted": {
            "type": "integer",
            "format": "int32",
            "description": "Amount of CollectionCurrency credited to the balance per converted duplicate."
          }
        },
        "description": "Rule for automatically converting a duplicate Collectible into CollectionCurrency. Conversion happens instantly upon receiving a duplicate; the duplicate does not enter inventory. CollectionCurrency accrues in UserCollectionState.CollectionCurrencyBalance."
      }
    },
    "additionalProperties": false
  }

  arguments 1186 lines copy
• get_craft unknown never probed

  GET ONLY the 'Craft' field of TitlePublicConfigurationModel. Crafting / recipe system — input resources, output item, success rate, time cost, station/skill prerequisites. Item IDs in inputs/outputs reference the Item catalogue; currency costs reference Currency.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_craft unknown never probed

  PARTIAL SAVE: writes ONLY the 'Craft' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Crafting / recipe system — input resources, output item, success rate, time cost, station/skill prerequisites. Item IDs in inputs/outputs reference the Item catalogue; currency costs reference Currency.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "CraftDefinitions",
        "properties": {
          "Definitions": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/definitions/CraftDefinition"
            }
          }
        },
        "description": "New value for the Craft field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "CraftType": {
        "enum": [
          "TradeUpRarity",
          "TradeUpCollection"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TradeUpRarity",
          "TradeUpCollection"
        ]
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "CraftDefinition": {
        "type": "object",
        "properties": {
          "Type": {
            "$ref": "#/definitions/CraftType"
          },
          "CraftID": {
            "type": [
              "null",
              "string"
            ]
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Source item catalog ID (V2: ItemDefinitions.Catalogs[CatalogID]). If null/empty, ItemDefinition lookup goes across all title catalogs."
          },
          "CollectionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "For TradeUpCollection — source collection ID (Metadata.CollectionID on input and output items must equal this). Ignored for TradeUpRarity."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "InputRarityID": {
            "type": [
              "null",
              "string"
            ]
          },
          "InputSelection": {
            "oneOf": [
              {
                "$ref": "#/definitions/CraftInputSelectionMode"
              }
            ],
            "description": "Which unstackable input instances are burned. ProtectLeveled = legacy: only non-upgraded ones, oldest first — with it OutputLevelMode has no effect, since every input is level 1. ClientSelected: the client names the instances (InputInstanceIDs); without them the server falls back to ProtectLeveled. LowestLevelFirst / HighestLevelFirst: the server picks, weakest or strongest first. Equipped and expired instances are never burned."
          },
          "OutputRarityID": {
            "type": [
              "null",
              "string"
            ]
          },
          "OutputLevelMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/CraftOutputLevelMode"
              }
            ],
            "description": "How the output item level is derived from the input levels, per craft (each craft's RequiredItemCount inputs). Stackable inputs and non-upgraded instances count as level 1. None = legacy: the output is always level 1."
          },
          "RequiredItemCount": {
            "type": "integer",
            "format": "int32"
          },
          "OutputLevelOverflow": {
            "oneOf": [
              {
                "$ref": "#/definitions/CraftOutputLevelOverflow"
              }
            ],
            "description": "What to do when the derived level exceeds the output item's Upgrade.MaxLevel (an output without Upgrade, or a stackable one, is capped at 1). Clamp: lower it to MaxLevel. Reject: refuse the craft — checked against the lowest MaxLevel of the whole output pool, so the outcome never depends on the roll."
          }
        }
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "CraftOutputLevelMode": {
        "enum": [
          "None",
          "Min",
          "Average",
          "Max"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "None",
          "Min",
          "Average",
          "Max"
        ]
      },
      "CraftInputSelectionMode": {
        "enum": [
          "ProtectLeveled",
          "ClientSelected",
          "LowestLevelFirst",
          "HighestLevelFirst"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ProtectLeveled",
          "ClientSelected",
          "LowestLevelFirst",
          "HighestLevelFirst"
        ]
      },
      "CraftOutputLevelOverflow": {
        "enum": [
          "Clamp",
          "Reject"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Clamp",
          "Reject"
        ]
      }
    },
    "additionalProperties": false
  }

  arguments 512 lines copy
• get_lootbox unknown never probed

  GET ONLY the 'Lootbox' field of TitlePublicConfigurationModel. Lootbox / gacha definitions — loot tables with weighted entries, pity systems, guaranteed rares, currency to open. Each entry references Item or Currency IDs. For straight (non-random) reward bundles use Reward.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_lootbox unknown never probed

  PARTIAL SAVE: writes ONLY the 'Lootbox' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Lootbox / gacha definitions — loot tables with weighted entries, pity systems, guaranteed rares, currency to open. Each entry references Item or Currency IDs. For straight (non-random) reward bundles use Reward.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "LootboxDefinitions",
        "properties": {
          "Settings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LootboxGlobalSettings"
              }
            ],
            "description": "Module-wide settings shared by every lootbox of the title. null = platform defaults apply (see LootboxDefinitionDefaults)."
          },
          "Definitions": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/definitions/LootboxDefinition"
            }
          },
          "RewardPools": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardPoolLibrary"
              }
            ],
            "description": "Reusable reward-pool library scoped to THIS module (not title-wide — Collection has its own, separate one). Lootboxes reference it via LootboxDefinition.Presets. null = presets unused."
          }
        },
        "description": "New value for the Lootbox field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "CurvePoint": {
        "type": "object",
        "properties": {
          "Value": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Value at this point. Empty = the point is ignored."
          },
          "AtStep": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Step (level / rank / stage) at which this point takes effect. Empty = the point is ignored."
          }
        },
        "description": "One breakpoint of a table curve."
      },
      "CurveShape": {
        "enum": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Flat",
          "PerStep",
          "PerStepRate",
          "Geometric",
          "Table",
          "TableAbsolute"
        ],
        "x-enum-descriptions": [
          "Value does not change with the step. Same behaviour as an unset curve.",
          "Additive in the value's own units: base + PerStep * (step - firstStep).",
          "Additive share of the base: base * (1 + PerStepRate * (step - firstStep)). 0.1 = +10% of base per step.",
          "Compounding: base * (1 + GrowthRate)^(step - firstStep).",
          "Table of multipliers over the base: base * interpolate(Points, step).",
          "Table of absolute values: interpolate(Points, step). The base is ignored."
        ]
      },
      "PityRuleSet": {
        "type": "object",
        "properties": {
          "PityRules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxPityRule"
            }
          }
        },
        "description": "Thin wrapper for a reusable pity-rule set."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "RewardSlotSet": {
        "type": "object",
        "properties": {
          "RewardSlots": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardSlot"
            }
          }
        },
        "description": "Thin wrapper for a reusable reward-slot set."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "LootboxPityRule": {
        "type": "object",
        "properties": {
          "Pool": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardRoll"
            },
            "description": "Weighted pool of possible pity rewards. Each rule fire performs one roll over Pool (by Weight, like LootboxRewardSlot.Pool). If an entry has AmountRange, it is applied to the rolled reward."
          },
          "RuleID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Rule identifier within the lootbox (e.g. \"guaranteed_5star\", \"guaranteed_legendary\"). Used as part of the counter storage key. Must be stable — renaming resets player counters."
          },
          "Threshold": {
            "type": "integer",
            "format": "int32",
            "description": "How many openings without a hit before the reward is guaranteed. Threshold=10 means on the 10th, 20th, 30th opening the player receives a roll from Pool. Must be >= 1."
          }
        },
        "description": "Pity guarantee rule. Fires every Threshold openings of the specific lootbox. When fired, one random reward from Pool is rolled by weights, just like normal RewardSlots. Lets pity be configured as a weighted pool rather than a single fixed award."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScalarCurveSpec": {
        "type": "object",
        "properties": {
          "Base": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Base the curve is computed from. Empty = use the base supplied by the caller. Fill it only where the base is a publisher setting (a multiplier starting at 1.5, a table's value before its first point) — where the base comes from data (a stat value, a level price, an item bonus) leaving it empty is required, otherwise it overrides the real base."
          },
          "Shape": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveShape"
              }
            ],
            "description": "Curve shape. Empty = Flat, i.e. no growth."
          },
          "Points": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CurvePoint"
            },
            "description": "Table breakpoints (Shape=Table or TableAbsolute). Empty = no growth."
          },
          "PerStep": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Units added per step (Shape=PerStep). Empty or 0 = no growth."
          },
          "MaxResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Upper bound of the result. Empty = there is NO upper bound (not 0)."
          },
          "MinResult": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Lower bound of the result. Empty = there is NO lower bound (not 0)."
          },
          "GrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Compounding rate per step (Shape=Geometric): 0.1 = x1.1 per step. Empty or 0 = no growth."
          },
          "PerStepRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Share of the base added per step (Shape=PerStepRate): 0.1 = +10% of base per step. Empty or 0 = no growth."
          },
          "Interpolation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CurveInterpolation"
              }
            ],
            "description": "How to interpolate between points. Empty = Step."
          },
          "TailGrowthRate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Growth beyond the last table point (share per step). Empty = hold the last point's value."
          }
        },
        "description": "Scalar curve f(base, step): how a value grows with a level, rank, stage or count. THE MODULE'S RULE: an empty field does nothing — an unset curve is the identity f(base,n)=base, an unset bound means there is no bound. All rates are shares (0.1 = +10%), never multipliers, so 0 and empty always mean the same thing."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "LootboxDefinition": {
        "type": "object",
        "properties": {
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LootboxPresetBindings"
              }
            ],
            "description": "Container of lootbox preset wiring (reward slots / pity rules). Registry is this module's LootboxDefinitions.RewardPools. null = presets unused. Resolved by PresetResolver."
          },
          "LootboxID": {
            "type": [
              "null",
              "string"
            ]
          },
          "PityRules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxPityRule"
            },
            "description": "Pity rules (hard pity). Each rule is independent: it stores a player counter on (LootboxID, RuleID). On each opening the counter increments by 1; when it reaches Threshold the player is granted the rule's reward and the counter resets to 0. Pity rewards are granted IN ADDITION to normal RewardSlots rolls. When Presets.PityRules is set, merged with the preset by RuleID key (preset base + inline override/add)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            }
          },
          "RewardSlots": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardSlot"
            },
            "description": "Reward slots. On each opening, every slot independently performs [MinRolls, MaxRolls] rolls over its Pool; all results merge into one ResourceOperation. Used for both guaranteed and random rewards. When Presets.RewardSlots is set, merged with the preset by SlotID key (preset base + inline override/add)."
          },
          "MaxOpenCount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max boxes per single Open call for THIS lootbox. Overrides LootboxGlobalSettings.MaxOpenCount. null = fall back to the module setting, then to LootboxDefinitionDefaults.DefaultMaxOpenCount. <= 0 = this lootbox cannot be opened. Read only via LootboxDefinitionDefaults.EffectiveMaxOpenCount."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "SupplyLimits": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxSupplyRule"
            },
            "description": "Per-title item drop limits FOR THIS lootbox (separate subsystem, analogous to PityRules but keyed by item). Each rule: item (CatalogID, ItemID) drops from this lootbox at most MaxDrops times title-wide. Monotonic lifetime counter (burning instances does NOT refund it). Works together with but independent of ItemDefinition.MaxSupply, which is the primary ceiling and binds first. null = no drop limits."
          },
          "RewardMultiplier": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RewardProgressionMultiplierSpec"
              }
            ],
            "description": "Optional per-lootbox progression reward multiplier. Scales rolled rewards (RewardSlots and pity) by a multiplier derived from a player progression metric. Opening cost is not affected. null = disabled."
          }
        }
      },
      "LootboxRewardRoll": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Resource reward of this roll. Grant-only: Standard.Items, Standard.EventTokens, PremiumTiers. For random amount use AmountRange. Use separate entries for distinct items so AmountRange doesn't apply to all simultaneously."
          },
          "Weight": {
            "type": "integer",
            "format": "int32"
          },
          "AmountRange": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LootboxAmountRange"
              }
            ],
            "description": "Optional range that randomly picks final Amount. On each roll N is chosen in [Min, Max] inclusive and REPLACES Amount on every Item/EventToken in Reward. Best used with single-resource Reward entries. null = use Amount from Reward as-is."
          }
        }
      },
      "LootboxRewardSlot": {
        "type": "object",
        "properties": {
          "Pool": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/LootboxRewardRoll"
            },
            "description": "Weighted reward pool of this slot. Each roll picks one entry by Weight."
          },
          "SlotID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Slot identifier for analytics / UI / debugging (\"guaranteed_coins\", \"bonus_item\")."
          },
          "MaxRolls": {
            "type": "integer",
            "format": "int32"
          },
          "MinRolls": {
            "type": "integer",
            "format": "int32",
            "description": "Number of rolls over Pool per lootbox opening. Chosen uniformly random in [Min, Max]. To make the slot guaranteed set Min=Max=1; to make it optional set Min=0."
          }
        }
      },
      "LootboxSupplyRule": {
        "type": "object",
        "properties": {
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item ID within the catalog."
          },
          "MaxDrops": {
            "type": "integer",
            "format": "int64",
            "description": "Max item units this lootbox may ever grant title-wide (monotonic lifetime budget), counted in item units (granted amount). <= 0 means the item can never drop."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog ID. Together with ItemID addresses the item."
          }
        },
        "description": "Per-title drop limit for one item from one lootbox. See LootboxDefinition.SupplyLimits."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ProgressionSource": {
        "enum": [
          "BoardStageLevel",
          "BoardRank",
          "BoardCyclesCompleted",
          "CharacterLevel",
          "SeasonTier",
          "EventTokenTotalEarned",
          "VirtualCurrencyBalance",
          "PlayerLevel"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardStageLevel",
          "BoardRank",
          "BoardCyclesCompleted",
          "CharacterLevel",
          "SeasonTier",
          "EventTokenTotalEarned",
          "VirtualCurrencyBalance",
          "PlayerLevel"
        ]
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "RewardPoolLibrary": {
        "type": "object",
        "properties": {
          "PityPresets": {
            "type": [
              "null",
              "object"
            ],
            "description": "Pity-rule sets keyed by PresetID. Mirrors the inline PityRules shape.",
            "additionalProperties": {
              "$ref": "#/definitions/PityRuleSet"
            }
          },
          "SlotPresets": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reward-slot sets keyed by PresetID. Mirrors the inline RewardSlots/BonusRewardSlots shape.",
            "additionalProperties": {
              "$ref": "#/definitions/RewardSlotSet"
            }
          }
        },
        "description": "Library of reusable reward sets scoped to a single owning module. Each module keeps its OWN instance: LootboxDefinitions.RewardPools and CollectionDefinitions.RewardPools are two independent registries, NOT shared across the title (Lootbox presets are not visible to Collection or vice versa). The same drop-table (reward-slot set and/or pity-rule set) is authored once within the module; its entities reference it by PresetID instead of inlining a heavy pool in every entity. Resolved at read-time via RewardSlotHelpers (replace: a non-empty inline overrides the preset). null = unused."
      },
      "CurveInterpolation": {
        "enum": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Step",
          "Linear",
          "Geometric"
        ],
        "x-enum-descriptions": [
          "Step: hold the previous point's value until the next one. Behaviour of an unset field.",
          "Linear between adjacent points.",
          "Geometric between adjacent points: lo * (hi/lo)^t."
        ]
      },
      "LootboxAmountRange": {
        "type": "object",
        "properties": {
          "Max": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Amount value (inclusive). Must be >= Min."
          },
          "Min": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Amount value (inclusive). Must be >= 0."
          }
        }
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "LootboxGlobalSettings": {
        "type": "object",
        "properties": {
          "MaxOpenCount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max boxes per single Open call for every lootbox of the title. Overridden per lootbox via LootboxDefinition.MaxOpenCount. null = platform default (LootboxDefinitionDefaults.DefaultMaxOpenCount). <= 0 = opening disabled (same semantics as LootboxSupplyRule.MaxDrops). A client-requested count is CLAMPED to this ceiling, not rejected."
          }
        },
        "description": "Module-wide Lootbox settings. Each value applies to every lootbox of the title unless the lootbox overrides it."
      },
      "LootboxPresetBindings": {
        "type": "object",
        "properties": {
          "PityRules": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Pity-rule preset binding (merge by RuleID)."
          },
          "RewardSlots": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Reward-slot preset binding (merge by SlotID)."
          }
        },
        "description": "Container of preset wiring for a lootbox — one PresetBinding per block. Inline data (RewardSlots/PityRules) lives on LootboxDefinition. null = presets unused."
      },
      "RewardProgressionMultiplierSpec": {
        "type": "object",
        "properties": {
          "Curve": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScalarCurveSpec"
              }
            ],
            "description": "Multiplier curve: how the multiplier grows with progress. Evaluated over a base of 1.0, so an unset curve means a multiplier of 1 and an unchanged reward. Shape/PerStep/Points/Interpolation/MinResult/MaxResult are documented on ScalarCurveSpec."
          },
          "Anchor": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Progress value from which the curve starts counting. Empty = from zero."
          },
          "Source": {
            "oneOf": [
              {
                "$ref": "#/definitions/ProgressionSource"
              }
            ],
            "description": "Which player progression metric to read (see ProgressionSource)."
          },
          "SourceKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Extra key for sources that need a parameter: VirtualCurrencyBalance -> CurrencyID; SeasonTier -> SeasonChainID; EventTokenTotalEarned -> \"{bucket}:{entityID}\" (bucket: TimedEvent/Leaderboard/Season/CoopEvent/Quest/DealOffer); CharacterLevel -> CharacterID (empty = \"Main\"). Ignored for other sources."
          },
          "ExcludeRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Rewards to exclude (same ResourceBundle shape as IncludeRewards). Takes precedence: a reward matched by Type + ID is never scaled. null/empty = no exclusions."
          },
          "IncludeRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Rewards to scale — a strictly typed set (ResourceBundle): currencies/items in Entries (matched by Type + ID: ItemID for items, else CurrencyID), event tokens in EventTokens (matched by Address.EntityID). Entry Amount is ignored — this is a selector, not a grant. null/empty (no Entries and no EventTokens) = apply to ALL milestone rewards."
          }
        },
        "description": "Milestone overlay: progression-based reward multiplier (cash multiplier). Scales targeted milestone rewards of ANY type — currencies, items and event tokens — by a multiplier derived from a configurable player progression metric (Source) via a shared platform curve (ScalarCurveSpec). What gets scaled is a strictly typed set IncludeRewards/ExcludeRewards (ResourceBundle, matched by Type + ID); empty Include = ALL. Applied in RewardProgressionResolver inside MilestoneRewardResolver, after bonus-window and season-tier. null on a milestone = disabled."
      }
    },
    "additionalProperties": false
  }

  arguments 1053 lines copy
• get_store unknown never probed

  GET ONLY the 'Store' field of TitlePublicConfigurationModel. In-game shop, built as a tree: Stores -> Layout.Sections -> Slots, plus a flat StoreOffers catalogue. A SLOT is the only address a product can be bought through, and it decides what stands in it: Rotation.Mode is Fixed (a pinned product - an ordinary shelf), Title (everyone sees the same roll) or Player (a personal roll), with a weighted Pool and an optional per-window purchase cap. The refresh window is a ScheduleSpec on the slot. A product not placed in any slot cannot be bought at all. Price is always a PriceOptions dictionary and can be virtual currency, crypto, a store product (real money), an ad credit, or FREE - an unset Cost means free, and a free product must be limited on some axis. Pricing.CompareAt is a struck-through price for display only and never reaches the charge. Identity.Tags and Identity.CustomParams are badges and ribbons the server never interprets. Distinct from Premium (real-money tiered offers) and DealOffer (limited-time promotions with progression).

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_store unknown never probed

  PARTIAL SAVE: writes ONLY the 'Store' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. In-game shop, built as a tree: Stores -> Layout.Sections -> Slots, plus a flat StoreOffers catalogue. A SLOT is the only address a product can be bought through, and it decides what stands in it: Rotation.Mode is Fixed (a pinned product - an ordinary shelf), Title (everyone sees the same roll) or Player (a personal roll), with a weighted Pool and an optional per-window purchase cap. The refresh window is a ScheduleSpec on the slot. A product not placed in any slot cannot be bought at all. Price is always a PriceOptions dictionary and can be virtual currency, crypto, a store product (real money), an ad credit, or FREE - an unset Cost means free, and a free product must be limited on some axis. Pricing.CompareAt is a struck-through price for display only and never reaches the charge. Identity.Tags and Identity.CustomParams are badges and ribbons the server never interprets. Distinct from Premium (real-money tiered offers) and DealOffer (limited-time promotions with progression).

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "StoreDefinitions",
        "properties": {
          "Stores": {
            "type": [
              "null",
              "object"
            ],
            "description": "Storefront catalog. Dictionary key = StoreID.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreDefinition"
            }
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StorePresetRegistry"
              }
            ],
            "description": "Registry of reusable blocks. null = presets unused. Expanded once when the config is materialized (PlatformCache.ResolveCompositeSections), so the module downstream sees flat definitions and merges nothing on the hot path."
          },
          "StoreOffers": {
            "type": [
              "null",
              "object"
            ],
            "description": "Goods (SKU) catalog. Dictionary key = OfferID. The same product may sit in several slots and several stores; it is described once.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreOfferDefinition"
            }
          }
        },
        "description": "Root of the shop. Holds the storefront catalog (Stores) and the goods catalog (StoreOffers). A storefront is a TREE: store -> sections -> slots, and a purchasable offer is reachable only through a slot. An ordinary shelf of six SKUs is six Fixed slots; a daily rotation is the same six slots with a pool and a schedule. An offer deliberately has no host-storefront list: the single address is the slot, because a purchase must re-verify that the requested offer is the one that actually came up for this player in that slot."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "StoreLayout": {
        "type": "object",
        "properties": {
          "Sections": {
            "type": [
              "null",
              "object"
            ],
            "description": "Storefront sections. Dictionary key = SectionID.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreSectionDefinition"
            }
          }
        },
        "description": "Storefront layout — an ordered set of sections."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "StoreIdentity": {
        "type": "object",
        "properties": {
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Client-side labels: best_value, x2, minus20. The engine NEVER interprets them — they are presentation identical for every player. A badge whose truth depends on the PLAYER (first purchase, sold out, 2 left) cannot be a tag: the server computes it into StoreOfferStateView."
          },
          "SortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Sort order among siblings. Unset = last; ties are broken by identifier."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Assets (icon, banner, background). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display description. A localization key or a literal."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name. A localization key or a literal."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Free-form presentation parameters for the client: ribbon, accent colour and so on. Example: {\"ribbon\":\"store.ribbon.plus200\",\"accent\":\"#FFB020\"}.",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        "description": "Presentation of a storefront entity. One type for store, section, slot and offer: their shape is identical, and a twin type is exactly what makes duplicated models drift. All display strings are plain strings that are either a localization key or a literal, resolved client-side by own table -> fallback -> the key itself."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "StoreDefinition": {
        "type": "object",
        "properties": {
          "Layout": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreLayout"
              }
            ],
            "description": "Layout: sections and slots."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StorePresetBindings"
              }
            ],
            "description": "Preset wiring. null = presets unused."
          },
          "StoreID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Storefront identifier. If empty, the dictionary key is substituted (StoreDefinitionResolver), as with quests. It becomes part of the Mongo path of rotation counters, so . and $ are rejected by StoreHelpers.IsMongoSafeKey."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreIdentity"
              }
            ],
            "description": "Storefront presentation."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreAvailability"
              }
            ],
            "description": "Storefront availability: schedule and gate."
          }
        },
        "description": "A single storefront: presentation, availability and layout."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "StoreOfferReward": {
        "type": "object",
        "properties": {
          "Grant": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "The grant: items, currency, event tokens, premium."
          }
        },
        "description": "What the player receives for the purchase."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "StoreAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who to show it to. Unset = everyone. Resolved by SegmentGateEvaluator.Passes. The player projection reaching the gate must carry every field it reads: a missing projected field means a condition that never passes, silently."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Display window. Unset = always. On a slot this is the ROTATION window: its key feeds the seed and its end is sent to the client as the refresh time. No field initializer on purpose, otherwise unset would be indistinguishable from set-to-empty and presets would stop being inherited."
          }
        },
        "description": "Availability of a store, section or slot: WHEN to show it and TO WHOM. The schedule is the shared ScheduleSpec rather than a pair of bare dates. A daily storefront follows from this: a Cyclic slot gets a window whose end is the refresh countdown, and the window key feeds the rotation seed, so the goods change exactly on the window boundary."
      },
      "StoreOfferPricing": {
        "type": "object",
        "properties": {
          "Options": {
            "type": [
              "null",
              "object"
            ],
            "description": "Payment options. Dictionary key = PriceOption.OptionID; the player picks one. Several are needed where the payment method depends on the platform. The storefront returns only the options available on the player platform, and the charge re-checks the platform anyway: the client renders, the server allows.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "CompareAt": {
            "type": [
              "null",
              "object"
            ],
            "description": "Compare-at (strikethrough) price for display. Key = the OptionID it is drawn next to. DISPLAY ONLY: this value never enters a ResourceOperation. The platform already has two real discount mechanisms - lowering Cost itself, and Cost.PremiumDiscounts/PremiumTiers applied inside ResourceService. A third would create a SECOND place deciding what is charged.",
            "additionalProperties": {
              "$ref": "#/definitions/ResourceConsume"
            }
          }
        },
        "description": "Product price. The KIND of price is not a separate field: it follows from the contents of PriceOption.Cost, and there are exactly five kinds, identical platform-wide - resources, crypto, a store product (a Purchase entry), an ad credit (a RewardedVideoCredit entry) and FREE, meaning an unset Cost, which the documentation of PriceOption itself already states."
      },
      "StoreRotationMode": {
        "enum": [
          "Fixed",
          "Title",
          "Player"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Fixed",
          "Title",
          "Player"
        ],
        "x-enum-descriptions": [
          "The slot is pinned to a single product (StoreSlotRotation.OfferID) — an ordinary shelf. Zero deliberately: a document without the field deserializes to zero, and that is only safe for the mode without randomness. Same migration contract as BanMode.Soft = 0.",
          "One set for the whole title: every player sees the same thing and it changes on the slot schedule. The seed does not include the player.",
          "A personal set per player — a daily storefront in the Brawl Stars vein. The seed includes the player identifier, so the set is stable for them and differs between players."
        ]
      },
      "StoreSlotRotation": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/StoreRotationMode"
              }
            ],
            "description": "Mode. Unset = Fixed."
          },
          "Pool": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/StoreSlotPoolEntry"
            },
            "description": "Pool for the Title and Player modes. An empty pool means an empty slot rather than a refusal: the storefront returns the slot without a product and the client draws an empty place."
          },
          "Salt": {
            "type": [
              "null",
              "string"
            ],
            "description": "Roll salt. The only way to DELIBERATELY reshuffle a slot without touching the pool: changing the salt changes the seed and therefore the drawn product for everyone."
          },
          "OfferID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Product of a pinned slot. Read only when Mode = Fixed."
          },
          "PerInstanceCap": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many times the product of this slot may be bought inside ONE rotation window. Unset or 0 = unlimited. Not the same as LimitSpec.DailyCap, which counts UTC calendar days: the rotation window is defined by the slot schedule and need not align with a day."
          }
        },
        "description": "How the slot is filled. The roll is NEVER STORED: it is recomputed as a pure function of (mode, player, slot address, schedule window key, salt, pool). That is load-bearing — only then does reading the storefront stay a READ and qualify for ClientActionPolicy.ReadOnlyActions, dropping the per-user Redis lock from the most frequently opened screen in the game. The price is stated out loud: editing the pool mid-window reshuffles the storefront for everyone who has it open. Purchases are not undone, since counters are addressed by product and slot rather than by the roll."
      },
      "StoreSlotPoolEntry": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who this entry may come up for. Unset = everyone. Filtered out BEFORE the draw, so its weight is redistributed among the remaining entries rather than lost."
          },
          "Weight": {
            "type": "integer",
            "format": "int32",
            "description": "Draw weight. Zero or negative = the entry does not take part. A weight of 1 next to a neighbour of 1000 means it will practically never come up, which is visible only by counting — that is what the distribution preview in the dashboard is for."
          },
          "OfferID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Product from the StoreOffers catalog."
          }
        },
        "description": "A single pool entry: what may come up, with what weight and for whom."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "StorePresetBindings": {
        "type": "object",
        "properties": {
          "Layout": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Layout block. Remove IS meaningful here: the block holds a dictionary of sections, and a store may drop an inherited section by key."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Identity block. Remove is not applicable — the block is not a dictionary."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Availability block. Remove is not applicable — the block is not a dictionary."
          }
        },
        "description": "Store preset wiring — one PresetBinding per block."
      },
      "StorePresetRegistry": {
        "type": "object",
        "properties": {
          "Layout": {
            "type": [
              "null",
              "object"
            ],
            "description": "Whole store layout (sections and slots).",
            "additionalProperties": {
              "$ref": "#/definitions/StoreLayout"
            }
          },
          "Reward": {
            "type": [
              "null",
              "object"
            ],
            "description": "Offer reward.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreOfferReward"
            }
          },
          "Pricing": {
            "type": [
              "null",
              "object"
            ],
            "description": "Offer pricing: payment options and compare-at price.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreOfferPricing"
            }
          },
          "Identity": {
            "type": [
              "null",
              "object"
            ],
            "description": "Presentation block, shared by store, section, slot and offer.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreIdentity"
            }
          },
          "Rotation": {
            "type": [
              "null",
              "object"
            ],
            "description": "Slot rotation rule: mode, pool, salt, per-window cap.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreSlotRotation"
            }
          },
          "Availability": {
            "type": [
              "null",
              "object"
            ],
            "description": "Availability of a store / section / slot: schedule and audience gate.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreAvailability"
            }
          },
          "OfferAvailability": {
            "type": [
              "null",
              "object"
            ],
            "description": "OFFER availability. A separate dictionary from Availability because an offer adds purchase limits to the schedule and gate, which makes it a different type.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreOfferAvailability"
            }
          }
        },
        "description": "Registry of reusable blocks. Each field is a dictionary keyed by PresetID and mirrors the same-named definition block. Same shape as QuestPresetRegistry."
      },
      "StoreSlotDefinition": {
        "type": "object",
        "properties": {
          "SlotID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Slot identifier. If empty, the dictionary key is substituted."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreSlotPresetBindings"
              }
            ],
            "description": "Slot preset wiring."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreIdentity"
              }
            ],
            "description": "Presentation of the slot itself (frame, caption of the place), not of the product inside it."
          },
          "Rotation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreSlotRotation"
              }
            ],
            "description": "What fills the slot."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreAvailability"
              }
            ],
            "description": "Slot availability. Its Schedule is the ROTATION window: the window key feeds the seed and the window end is sent to the client as the card refresh time."
          }
        },
        "description": "A slot is a single card on screen. Rotation lives HERE: what fills the card is decided by StoreSlotRotation."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "StoreOfferDefinition": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreOfferReward"
              }
            ],
            "description": "What the player receives."
          },
          "OfferID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Product identifier. If empty, the dictionary key is substituted. It becomes part of the Mongo path of the purchase counter: an empty field name is rejected by the driver and the product becomes UNBUYABLE with a driver-level refusal."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreOfferPresetBindings"
              }
            ],
            "description": "Product preset wiring."
          },
          "Pricing": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreOfferPricing"
              }
            ],
            "description": "Price."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreIdentity"
              }
            ],
            "description": "Product presentation."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreOfferAvailability"
              }
            ],
            "description": "Schedule, gate and purchase limits."
          }
        },
        "description": "A product (SKU): what it is, what it costs, what it grants and who may buy it."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "StoreOfferAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who may buy the product. Unset = everyone."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Purchase limits: TotalCap over all time, DailyCap per UTC calendar day, CooldownSeconds between purchases. 0 on an axis = unlimited. CooldownSeconds is what bounds a FREE slot and also gives the client its next-available time; a free product with no limit on any axis is refused at purchase, because otherwise it is a button that grants itself forever. No field initializer on purpose: read only via StoreDefinitionDefaults.EffectiveLimits."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Sales window of the product. Unset = always."
          }
        },
        "description": "Product availability: when, to whom and how many times."
      },
      "StoreSectionDefinition": {
        "type": "object",
        "properties": {
          "Slots": {
            "type": [
              "null",
              "object"
            ],
            "description": "Section slots. Dictionary key = SlotID.",
            "additionalProperties": {
              "$ref": "#/definitions/StoreSlotDefinition"
            }
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreSectionPresetBindings"
              }
            ],
            "description": "Section preset wiring."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreIdentity"
              }
            ],
            "description": "Section presentation (the heading above the group of cards)."
          },
          "SectionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Section identifier. If empty, the dictionary key is substituted."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StoreAvailability"
              }
            ],
            "description": "Section availability: schedule and gate."
          },
          "UniqueOffersInSection": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether a product may repeat inside the section. Unset = repeats allowed. Slots are resolved in a deterministic order (SortOrder, ties by SlotID) and already-drawn products are excluded from later pools. The order must be deterministic: a BSON dictionary does not guarantee one, and a non-deterministic order would make two identical requests render different storefronts."
          }
        },
        "description": "A storefront section — a visible group of cards: Gems, Supply crates, ROLLS."
      },
      "StoreSlotPresetBindings": {
        "type": "object",
        "properties": {
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Identity block."
          },
          "Rotation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Rotation block. Remove IS meaningful: the block holds a pool keyed by OfferID, and a slot may drop an inherited pool entry."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Availability block."
          }
        },
        "description": "Slot preset wiring."
      },
      "StoreOfferPresetBindings": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Reward block."
          },
          "Pricing": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Pricing block. Remove IS meaningful: the block holds a dictionary of payment options keyed by OptionID."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Identity block."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Availability block."
          }
        },
        "description": "Offer preset wiring."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "StoreSectionPresetBindings": {
        "type": "object",
        "properties": {
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Identity block."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Availability block."
          }
        },
        "description": "Section preset wiring."
      }
    },
    "additionalProperties": false
  }

  arguments 1877 lines copy
• get_ban unknown never probed

  GET ONLY the 'Ban' field of TitlePublicConfigurationModel. Ban levels and the level ban gates apply to a player. The publisher defines any number of named levels (e.g. "low"/"medium"/"hard") — each with capability checkboxes (BanCapability: block withdrawals, deposits, leaderboards, trading, PvP, chat, social, coop, referral, push, community marketing, crypto convert, purchases) plus an optional BlockLogin flag that shuts the player out of the game entirely and overrides everything else on that level. DefaultLevelID is the level a manual ban applies when the caller does not pick one. Two built-in ids always work even when not listed here: "hard" (blocks login) and "soft" (synthesized from the legacy Soft section below). Use PLAYER-facing tools (SetPlayerBanStatus) to actually ban a player with a level ID from here — this section only defines what each level MEANS.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_ban unknown never probed

  PARTIAL SAVE: writes ONLY the 'Ban' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Ban levels and the level ban gates apply to a player. The publisher defines any number of named levels (e.g. "low"/"medium"/"hard") — each with capability checkboxes (BanCapability: block withdrawals, deposits, leaderboards, trading, PvP, chat, social, coop, referral, push, community marketing, crypto convert, purchases) plus an optional BlockLogin flag that shuts the player out of the game entirely and overrides everything else on that level. DefaultLevelID is the level a manual ban applies when the caller does not pick one. Two built-in ids always work even when not listed here: "hard" (blocks login) and "soft" (synthesized from the legacy Soft section below). Use PLAYER-facing tools (SetPlayerBanStatus) to actually ban a player with a level ID from here — this section only defines what each level MEANS.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "BanDefinitions",
        "properties": {
          "Levels": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ban levels the publisher has configured, keyed by a slug the publisher picks (e.g. \"low\", \"medium\", \"hard\"). Any number of levels, any names. The platform reserves no id.",
            "additionalProperties": {
              "$ref": "#/definitions/BanLevelDefinition"
            }
          },
          "DefaultLevelID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Level id applied by a manual ban that does not specify one, and by AutoBan rules that do not specify one. Must be a key of Levels."
          }
        },
        "description": "New value for the Ban field."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "BanCapability": {
        "enum": [
          0,
          1,
          2,
          3,
          4,
          5,
          6,
          7,
          8,
          9,
          10,
          11,
          12
        ],
        "type": "integer",
        "description": "",
        "x-enumNames": [
          "BlockWithdrawals",
          "ExcludeFromLeaderboards",
          "BlockLeaderboardRewards",
          "BlockTrading",
          "BlockPvP",
          "BlockChat",
          "BlockSocial",
          "BlockCoop",
          "BlockReferral",
          "BlockPush",
          "BlockCommunityMarketing",
          "BlockCryptoConvert",
          "BlockPurchases"
        ],
        "x-enum-descriptions": [
          "Blocks crypto/NFT withdrawal. Deposits are never blocked by any ban level — funds already committed on-chain must land somewhere.",
          "Player stops earning leaderboard scores and is removed from the ranked top.",
          "Blocks claiming leaderboard cycle/milestone rewards.",
          "Blocks the player-to-player marketplace and trade offers (send/accept).",
          "Blocks PvP matches, board attacks/raids and the community chest, and hides the player from other players' opponent/bot pools.",
          "Blocks the chat module entirely (read included).",
          "Blocks the social/friends module entirely.",
          "Blocks cooperative events entirely.",
          "Blocks the referral module entirely.",
          "Blocks push subscription actions.",
          "Blocks Community Marketing entirely (earnings become unreachable).",
          "Blocks converting virtual currency to/from crypto.",
          "Blocks real-money purchases (Purchase module — Google/Apple IAP)."
        ]
      },
      "BanLevelDefinition": {
        "type": "object",
        "properties": {
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name shown in the dashboard, e.g. \"Hard\", \"Medium\", \"Light\"."
          },
          "Severity": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order — higher is stricter. Used by AutoBan escalation to tell whether a step would upgrade or downgrade the current ban."
          },
          "BlockLogin": {
            "type": "boolean",
            "description": "Blocks the player out of the game entirely: no v2 request succeeds, login/refresh issue no tokens. Overrides every Capabilities/BlockedModules/BlockedActions entry on this level."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional note for the publisher explaining what this level is for."
          },
          "Capabilities": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/BanCapability"
            },
            "description": "Named restrictions this level applies — see BanCapability for exactly what each one closes. Prefer these over BlockedModules/BlockedActions; use the latter only for something a capability does not cover."
          },
          "PlayerMessage": {
            "type": [
              "null",
              "string"
            ],
            "description": "Text shown to the banned player instead of the generic ban message. Null = generic message."
          },
          "BlockedActions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Additional per-module action blocklist beyond what Capabilities already cover. Module -> action names, matched case-insensitively.",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "BlockedModules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Additional modules blocked entirely, beyond what Capabilities already cover. FunctionName values, e.g. \"Blockchain\", \"MarketplaceV2\". Matched case-insensitively; an unknown name simply never matches and never breaks the request."
          },
          "DefaultDurationHours": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Default ban duration in hours when this level is applied without an explicit duration (manual ban or AutoBan rule). Null = indefinite."
          }
        }
      }
    },
    "additionalProperties": false
  }

  arguments 165 lines copy
• get_purchase unknown never probed

  GET ONLY the 'Purchase' field of TitlePublicConfigurationModel. Real-money in-app purchases (IAP) for Google Play and the Apple App Store. Product catalogue with per-store SKUs (StoreProductIDs), what each purchase grants (Rewards), subscription products that activate a Premium entitlement, audience gates and purchase limits, plus per-store receipt-verification settings. Distinct from Store (in-game shop paid with virtual currency) and from Premium (which describes the entitlement itself, while this describes how it is sold in the stores). Contains NO secrets: the Google service-account JSON and the App Store Server API key are referenced by TitleSecrets entry name only; the Play licensing public key and Apple root certificates are public by nature and live here.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_deal_offer unknown never probed

  GET ONLY the 'DealOffer' field of TitlePublicConfigurationModel. Limited-time offers WITH PROGRESSION — starter packs, comeback bundles, aquarium-style chains, pick-one-of-N. Two axes: a SLOT is a UI position that cycles through its own ordered Queue of offers (its Availability.Schedule decides how: Chained advances per player, Scheduled/Cyclic/AlwaysOn follow the wall clock, Triggered fires on an event), and an OFFER is a graph of nodes. There is no declared graph mode: the shape (single, chain, branching, choice, metered) is whatever Graph.RootNodeIDs, node NextNodeIDs, ChoiceGroupID and UnlockRules describe. Every node declares its own price as a PriceOptions dictionary — resources, crypto, a store product (real money), an AD CREDIT (that is how "watch a video" is expressed; only the server grants credits) or nothing at all, which means free. A node pays out Reward.Grants, moves offer-local Tracks and adds Reward.MilestonePoints to the offer milestone bar. Slots, offers and nodes are decomposed into named blocks (Identity, Availability, Behaviour, Graph, Milestones, Pricing, Reward), each with its own independent preset binding into DealOffer.Presets. Distinct from Store (always-on shop, no progression) and Premium (ongoing paid subscriptions).

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_deal_offer unknown never probed

  PARTIAL SAVE: writes ONLY the 'DealOffer' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Limited-time offers WITH PROGRESSION — starter packs, comeback bundles, aquarium-style chains, pick-one-of-N. Two axes: a SLOT is a UI position that cycles through its own ordered Queue of offers (its Availability.Schedule decides how: Chained advances per player, Scheduled/Cyclic/AlwaysOn follow the wall clock, Triggered fires on an event), and an OFFER is a graph of nodes. There is no declared graph mode: the shape (single, chain, branching, choice, metered) is whatever Graph.RootNodeIDs, node NextNodeIDs, ChoiceGroupID and UnlockRules describe. Every node declares its own price as a PriceOptions dictionary — resources, crypto, a store product (real money), an AD CREDIT (that is how "watch a video" is expressed; only the server grants credits) or nothing at all, which means free. A node pays out Reward.Grants, moves offer-local Tracks and adds Reward.MilestonePoints to the offer milestone bar. Slots, offers and nodes are decomposed into named blocks (Identity, Availability, Behaviour, Graph, Milestones, Pricing, Reward), each with its own independent preset binding into DealOffer.Presets. Distinct from Store (always-on shop, no progression) and Premium (ongoing paid subscriptions).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "DealOfferDefinitions",
        "properties": {
          "Slots": {
            "type": [
              "null",
              "object"
            ],
            "description": "Slots — positions in the UI; each cycles through its own offer queue. Example: slot 0 = aquarium/hamster/..., slot 1 = wild sticker, slot 2 = dapper deal.",
            "additionalProperties": {
              "$ref": "#/definitions/DealSlotDefinition"
            }
          },
          "Offers": {
            "type": [
              "null",
              "object"
            ],
            "description": "Library of all offers in the title. Key = OfferID. Slots reference offers by OfferID.",
            "additionalProperties": {
              "$ref": "#/definitions/DealOfferDefinition"
            }
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealOfferPresetRegistry"
              }
            ],
            "description": "Registry of reusable presets. Entities reference it through per-block bindings. null = presets unused."
          }
        },
        "description": "Root config of the entire Deal Offers system. Contains the slot list, the offer library and the preset registry."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "DealIdentity": {
        "type": "object",
        "properties": {
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Client-side labels. The engine NEVER interprets them — presentation identical for every player. A badge whose truth depends on the PLAYER cannot be a tag."
          },
          "SortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Sort order among siblings. CLIENT CONTRACT: the server does not apply it and cannot — it has no screen. Entities are not sorted in the response; the renderer applies this."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Assets (icon, banner, background). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display description. A localization key or a literal."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name. A localization key or a literal."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary parameters for analytics, A/B tests and client presentation.",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        "description": "Identity and presentation — a block shared by slot, offer and node."
      },
      "DealNodeType": {
        "enum": [
          "Purchase",
          "FreeClaim",
          "RewardedVideo",
          "Info"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Purchase",
          "FreeClaim",
          "RewardedVideo",
          "Info"
        ],
        "x-enum-descriptions": [
          "Paid node — real money IAP or soft currency.",
          "Free claim — press the button, get the reward.",
          "Rewarded video view.",
          "Informational node without an action."
        ]
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "DealNodeReward": {
        "type": "object",
        "properties": {
          "Grants": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards granted on successful node completion."
          },
          "TrackChanges": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DealTrackChange"
            },
            "description": "Changes to offer-local tracks when the node is completed. Example: +5 shells on a Deal Aquarium purchase."
          },
          "MilestonePoints": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Points into the offer milestone bar on node execution (progress \"15/25\" badges). Granted to the EventTokenType.DealOffer token of the current activation in the same atomic TX as node rewards/state. Unset/0 = node does not move the bar. Applies only when the offer has a milestone block."
          }
        },
        "description": "What the node GIVES: the reward, offer-local track changes and milestone-bar points."
      },
      "DealOfferGraph": {
        "type": "object",
        "properties": {
          "Nodes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DealNodeDefinition"
            },
            "description": "All nodes of the offer."
          },
          "Tracks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DealTrackDefinition"
            },
            "description": "Offer-local progress tracks. Used for mechanics like \"aquarium shells\"."
          },
          "RootNodeIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Root nodes — available immediately on offer activation. One for a linear offer, several for branching and choice."
          },
          "ExhaustedWhenAllTerminalNodesCompleted": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "If true, the offer becomes exhausted when all terminal nodes (nodes without NextNodeIDs) are completed. Unset = true."
          }
        },
        "description": "The offer graph — nodes, roots, offer-local tracks and the exhaustion rule."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "DealNodePricing": {
        "type": "object",
        "properties": {
          "Options": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay for this node; dictionary key = PriceOption.OptionID. The single place a price is declared, for every node type. A cost entry can be resources, crypto, a store product (ResourceEntryType.Purchase — real money, needs a receipt), an ad credit (ResourceEntryType.RewardedVideoCredit — the player earned it by watching a video, and only the server can grant it), or nothing at all, which means FREE. \"Watch an ad\" is expressed as a price of N ad credits.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          }
        },
        "description": "Node pricing."
      },
      "DealTrackChange": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Positive = add, negative = subtract."
          },
          "TrackID": {
            "type": [
              "null",
              "string"
            ]
          },
          "RespectBounds": {
            "type": "boolean"
          }
        },
        "description": "Change to an offer-local track when a node is completed. Example: Purchase Deal Aquarium node adds +5 to the \"aquarium_shells\" track."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "DealAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate for the slot — standard SegmentGate (Core/Segment). Unset = available to all. Players failing the gate do not see this slot's offers."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Unified slot schedule container — same ScheduleSpec and modes as every other system. Chained = the Queue advanced per player; Scheduled/Cyclic/AlwaysOn = a single offer active by wall clock; Triggered = shown when an ActivationTriggers source fires. Unset = Chained."
          }
        },
        "description": "Slot availability — schedule and audience gate."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "DealSlotBehaviour": {
        "type": "object",
        "properties": {
          "AllowDismissSkip": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "If true, Dismiss skips to the next offer with DismissSkipDelaySec delay (only for One Time Offer slots). If false, Dismiss only records the closure and the timer keeps ticking. Unset = false."
          },
          "DismissSkipDelaySec": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Delay in seconds before moving to the next offer after Dismiss. Used only if AllowDismissSkip = true. Unset = 0 (immediately)."
          }
        },
        "description": "Slot behaviour when the player dismisses an offer."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "DealMilestoneBlock": {
        "type": "object",
        "properties": {
          "Token": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenDefinition"
              }
            ],
            "description": "Milestone-bar points-token definition (Core/Event, EventTokenDefinition) — same as TimedEvent/Quest. Carries caps/icon for points (MaxBalance, DailyEarnCap, MaxPerGrant). Unset = points granted without global caps."
          },
          "ClaimMode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MilestoneClaimMode"
              }
            ],
            "description": "Milestone claim mode (unified MilestoneClaimMode). Instant: as soon as the threshold is reached; AfterEventEnd/FeaturedAfterEnd: only after the offer activation ends. Unset = Instant."
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Offer milestones (unified MilestoneDefinition, Core/Milestone) — the top \"N/M\" progress bar with tier rewards. Key = MilestoneID. Progress is a dedicated EventToken (EventTokenType.DealOffer); points come from DealNodeReward.MilestonePoints; threshold is checked against EventTokenBalanceData.TotalEarned. Orthogonal to offer-local tracks. Unset/empty = no bar.",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          }
        },
        "description": "The offer milestone bar as a WHOLE: the tier set, the claim mode and the points token. The three live in one block deliberately — presetting only the tier dictionary silently lost the claim mode and the point caps."
      },
      "DealNodeDefinition": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/DealNodeType"
              }
            ],
            "description": "Node kind. Purchase / FreeClaim / RewardedVideo / Info."
          },
          "Action": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealNodeActionDefinition"
              }
            ],
            "description": "Node action parameters depending on Type."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Node execution limits — unified LimitSpec: PerActivationCap = \"N/N Available\" per activation, TotalCap = all-time, DailyCap = per day, CooldownSeconds = pause between executions. null = default \"once per activation\"."
          },
          "NodeID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique node ID within the offer."
          },
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealNodeReward"
              }
            ],
            "description": "Node reward block."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealNodePresetBindings"
              }
            ],
            "description": "Per-block preset bindings. null = presets unused."
          },
          "Pricing": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealNodePricing"
              }
            ],
            "description": "Node pricing block."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealIdentity"
              }
            ],
            "description": "Node identity and presentation block."
          },
          "NextNodeIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Nodes unlocked after this node is completed. Chain: next in chain. Choice: the selected one. Branching: several."
          },
          "UnlockRules": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealNodeUnlockRules"
              }
            ],
            "description": "Node unlock rules. Null = node is unlocked immediately (root). No preset by design — the rules NAME sibling node ids and are meaningful only inside their own graph."
          },
          "ChoiceGroupID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Choice group ID. Nodes sharing a ChoiceGroupID are mutually exclusive options: completing one locks the others. That is what makes a graph a choice — there is no separate mode field."
          },
          "HideWhenCompleted": {
            "type": "boolean",
            "description": "If true, the node is hidden in the UI after completion."
          },
          "ExhaustOfferOnComplete": {
            "type": "boolean",
            "description": "If true, completing this node immediately exhausts the entire offer. Used for choice (pick one — offer closes) and single-node offers."
          }
        },
        "description": "A single offer node — an atomic player action (purchase / free claim / watch an ad)."
      },
      "DealSlotDefinition": {
        "type": "object",
        "properties": {
          "Queue": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DealSlotQueueEntry"
            },
            "description": "Ordered queue of offers in the slot. Offers are shown by ascending Order; the queue loops after the last one. No preset by design — the queue IS the slot's content."
          },
          "SlotID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique slot ID. Example: \"slot_main\", \"slot_secondary\"."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Whether the slot is enabled."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealSlotPresetBindings"
              }
            ],
            "description": "Per-block preset bindings. null = presets unused."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealIdentity"
              }
            ],
            "description": "Slot identity and presentation block."
          },
          "Behaviour": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealSlotBehaviour"
              }
            ],
            "description": "Dismiss-behaviour block."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealAvailability"
              }
            ],
            "description": "Schedule and audience gate block."
          }
        },
        "description": "Slot — a UI position that sequentially shows offers from a queue. When the active offer expires or exhausts, the slot moves to the next one."
      },
      "DealSlotQueueEntry": {
        "type": "object",
        "properties": {
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Position in the queue. Lower = shown earlier."
          },
          "OfferID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Offer ID from DealOfferDefinitions.Offers."
          },
          "DurationSec": {
            "type": "integer",
            "format": "int32",
            "description": "Duration of showing this offer in the slot in seconds. After expiry the slot moves to the next offer. 0 = offer is active until limits are fully exhausted (no timer)."
          },
          "DelayBeforeActivationSec": {
            "type": "integer",
            "format": "int32",
            "description": "Delay before activating this offer in seconds (pause within the cycle). 0 = activates immediately after the previous."
          }
        },
        "description": "A single entry in a slot's queue — a reference to an offer with its individual timer."
      },
      "MilestoneClaimMode": {
        "enum": [
          "Instant",
          "AfterEventEnd",
          "FeaturedAfterEnd"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Instant",
          "AfterEventEnd",
          "FeaturedAfterEnd"
        ],
        "x-enum-descriptions": [
          "Claim instantly when the threshold is reached (accumulated progress >= RequiredProgress). Simplest, most predictable mode.",
          "Claim only after the instance ends (within the system's grace window, if any). All milestones accumulate and are claimed in one batch. Motivates playing to the end.",
          "Hybrid: regular milestones (IsFeatured = false) claim instantly; featured ones (IsFeatured = true) only after the instance ends."
        ]
      },
      "DealNodeUnlockRules": {
        "type": "object",
        "properties": {
          "RequiredTracks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DealTrackRequirement"
            },
            "description": "Requirements for offer-local tracks. Example: aquarium_shells >= 15 to unlock the third Deal Aquarium node."
          },
          "VisibleWhileLocked": {
            "type": "boolean",
            "description": "Whether the node is visible in UI while it is locked."
          },
          "RequiredCompletedNodeIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "All of these nodes must be completed for the current one to unlock."
          },
          "RequiredAnyCompletedNodeIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Completion of at least one of these nodes is sufficient."
          }
        },
        "description": "Conditions to unlock a node inside an offer."
      },
      "DealOfferDefinition": {
        "type": "object",
        "properties": {
          "Graph": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealOfferGraph"
              }
            ],
            "description": "Offer graph block."
          },
          "Enabled": {
            "type": "boolean",
            "description": "If false, the offer will not be activated anew. An activation already in progress keeps running, and a queue entry pointing at a disabled offer is SKIPPED (the slot is not zeroed)."
          },
          "OfferID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique offer ID. Example: \"aquarium_deal\", \"wild_sticker\", \"pick_one_kennel\"."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealOfferPresetBindings"
              }
            ],
            "description": "Per-block preset bindings. null = presets unused."
          },
          "Version": {
            "type": "integer",
            "format": "int32",
            "description": "Config version. Incremented on change."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealIdentity"
              }
            ],
            "description": "Offer identity and presentation block."
          },
          "Milestones": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealMilestoneBlock"
              }
            ],
            "description": "The milestone bar as a whole (tiers + claim mode + token)."
          }
        },
        "description": "Definition of a single offer. An offer is a graph of nodes with rewards, costs and unlock rules, plus an optional milestone bar on top."
      },
      "DealTrackDefinition": {
        "type": "object",
        "properties": {
          "TrackID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique track ID within the offer. Example: \"aquarium_shells\"."
          },
          "MaxValue": {
            "type": "integer",
            "format": "int64",
            "description": "0 = no maximum."
          },
          "MinValue": {
            "type": "integer",
            "format": "int64"
          },
          "ClampToMax": {
            "type": "boolean"
          },
          "ClampToMin": {
            "type": "boolean"
          },
          "StartValue": {
            "type": "integer",
            "format": "int64"
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "HiddenFromUI": {
            "type": "boolean",
            "description": "Hide this track from the UI (a service counter rather than a progress bar). CLIENT CONTRACT: the server does not draw tracks, it only counts them."
          }
        },
        "description": "Offer-local progress track. Used for mechanics like aquarium shells."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "MilestoneDefinition": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base rewards. Always granted on a successful claim."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order in the UI (lower = higher/earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone images (icon, badge). null = unset.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsFeatured": {
            "type": "boolean",
            "description": "Featured milestone: special UI styling. With MilestoneClaimMode.FeaturedAfterEnd these can only be claimed after the instance ends."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI/CMS. null = unset."
          },
          "MilestoneID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique milestone ID within its owning entity (Mongo-safe, claim idempotency key)."
          },
          "BonusRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Bonus-window overlay: extra rewards on top of Rewards when the bonus phase is active at claim time (MilestoneRewardContext.BonusActive). Applied via MilestoneRewardResolver. null = no bonus part."
          },
          "RequiredProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Threshold over ACCUMULATED progress to unlock. EventToken systems: EventTokenBalanceData.TotalEarned (not current balance). CommunityChest: shared group progress."
          },
          "SeasonTierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SeasonTierRewardSet"
              }
            ],
            "description": "Season-tier overlay: reward scaling by the player's season tier. Applied via MilestoneRewardResolver (SeasonTierRewardResolver.Resolve) only when MilestoneRewardContext.SeasonChainID is set. null = disabled."
          }
        },
        "description": "Unified milestone primitive for all platform systems (TimedEvent, Leaderboard, Quest, CommunityChest, DealOffer). Replaces the per-module milestone definitions. Threshold is checked against accumulated progress (RequiredProgress): EventToken systems use EventTokenBalanceData.TotalEarned; CommunityChest uses shared group progress. Reward overlays BonusRewards (bonus-window) and SeasonTierRewards (season-tier) are platform-wide optional fields applied via MilestoneRewardResolver; leave null if unused."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "SeasonTierRewardSet": {
        "type": "object",
        "properties": {
          "Bundles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardBundle"
            },
            "description": "Structurally different rewards for specific tiers. On match, replaces the base ResourceGrant entirely (Replace)."
          },
          "Multipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardMultiplier"
            },
            "description": "Multipliers applied to Amount of the base ResourceGrant. Used ONLY if no Bundles entry matched."
          }
        },
        "description": "Generic container of season-tier reward scaling. Used by any platform system (leaderboards, lootboxes, shop, daily) that wants to scale a ResourceGrant by the player's current tier in a season chain. Empty/null lists = neutral."
      },
      "DealTrackRequirement": {
        "type": "object",
        "properties": {
          "Value": {
            "type": "integer",
            "format": "int64"
          },
          "TrackID": {
            "type": [
              "null",
              "string"
            ]
          },
          "Operator": {
            "$ref": "#/definitions/DealComparisonOperator"
          }
        },
        "description": "Requirement on the value of an offer-local track to unlock a node."
      },
      "EventTokenConversion": {
        "type": "object",
        "properties": {
          "Rate": {
            "type": "number",
            "format": "double",
            "description": "Conversion rate: 1 event token = Rate units of the target currency. Example: 0.1 means 10 tokens = 1 unit of currency."
          },
          "MaxConvertAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Max number of tokens eligible for conversion. Inflation guard — if the player has 100000 tokens, only up to MaxConvertAmount is converted."
          },
          "TargetCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "What to convert to (VirtualCurrency ID). Example: \"IG\" (in-game gold), \"DICE\"."
          }
        },
        "description": "Conversion rules for event tokens at burn. Lets the platform compensate the player for unused tokens."
      },
      "EventTokenDefinition": {
        "type": "object",
        "properties": {
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Token images: icon and similar assets.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "MaxBalance": {
            "type": "integer",
            "format": "int64",
            "description": "Max token balance the player can accumulate. 0 = unlimited. Protects against unbounded accrual."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Token name shown in UI. Example: \"Pumpkin Coins\", \"Raid Points\"."
          },
          "MaxPerGrant": {
            "type": "integer",
            "format": "int64",
            "description": "Max tokens per single grant (anti-abuse). Caps the maximum portion of a single grant."
          },
          "DailyEarnCap": {
            "type": "integer",
            "format": "int64",
            "description": "Max tokens per day across all sources. 0 = unlimited. Global daily cap."
          },
          "BurnConversion": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenConversion"
              }
            ],
            "description": "Conversion rules for the leftover balance at burn. If set, the remainder is converted to the specified VirtualCurrency. null = balance is zeroed without compensation."
          },
          "BurnOnEventEnd": {
            "type": "boolean",
            "description": "Whether tokens burn at event end. true = balance is zeroed (or converted via BurnConversion). false = tokens persist (collectible)."
          }
        },
        "description": "Event-token definition. An event token is a separate entity, not a VirtualCurrency. Balance lives in UserEventProgress.TokenBalance, ensuring isolation between events and automatic burn-on-end behavior."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "DealComparisonOperator": {
        "enum": [
          "Eq",
          "Gte",
          "Lte"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Eq",
          "Gte",
          "Lte"
        ]
      },
      "DealNodePresetBindings": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Reward preset binding. Remove is not applicable — the block is not a dictionary."
          },
          "Pricing": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Pricing preset binding (merge by OptionID; Remove drops payment options)."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Identity preset binding. Remove is not applicable — the block is not a dictionary."
          }
        },
        "description": "Node preset bindings — one independent binding per block. null = presets unused."
      },
      "DealSlotPresetBindings": {
        "type": "object",
        "properties": {
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Identity preset binding. Remove is not applicable — the block is not a dictionary."
          },
          "Behaviour": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Dismiss-behaviour preset binding. Remove is not applicable — the block is not a dictionary."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Availability preset binding. Remove is not applicable — the block is not a dictionary."
          }
        },
        "description": "Slot preset bindings — one independent binding per block. null = presets unused."
      },
      "SeasonTierRewardBundle": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this tier. Passed unmodified into ResourceService via a regular ResourceOperation.Grant."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this bundle to apply. Matches SeasonTierDefinition.Tier / UserSeasonState.CurrentTier."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to. Selection matches only tiers with the same SeasonChainID."
          }
        },
        "description": "Structurally different rewards for a season-chain tier. Analogous to PremiumTierBundle but the trigger is the player's season tier. Selection picks the single best match (MinSeasonTier <= playerTier); not stacked."
      },
      "DealOfferPresetBindings": {
        "type": "object",
        "properties": {
          "Graph": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Graph preset binding. Remove is not applicable — the block is not a dictionary."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Identity preset binding. Remove is not applicable — the block is not a dictionary."
          },
          "Milestones": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Milestone-bar preset binding (merge by MilestoneID; Remove drops tiers)."
          }
        },
        "description": "Offer preset bindings — one independent binding per block. null = presets unused."
      },
      "DealOfferPresetRegistry": {
        "type": "object",
        "properties": {
          "Graph": {
            "type": [
              "null",
              "object"
            ],
            "description": "Offer graph presets, keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/DealOfferGraph"
            }
          },
          "Reward": {
            "type": [
              "null",
              "object"
            ],
            "description": "Node reward presets, keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/DealNodeReward"
            }
          },
          "Pricing": {
            "type": [
              "null",
              "object"
            ],
            "description": "Node pricing presets, keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/DealNodePricing"
            }
          },
          "Identity": {
            "type": [
              "null",
              "object"
            ],
            "description": "Identity presets (slot / offer / node), keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/DealIdentity"
            }
          },
          "Behaviour": {
            "type": [
              "null",
              "object"
            ],
            "description": "Slot dismiss-behaviour presets, keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/DealSlotBehaviour"
            }
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone-bar presets as a whole (tiers + claim mode + token), keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/DealMilestoneBlock"
            }
          },
          "Availability": {
            "type": [
              "null",
              "object"
            ],
            "description": "Slot availability presets (schedule + gate), keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/DealAvailability"
            }
          }
        },
        "description": "Preset registry — MIRRORS the block names. Resolved once when the config is materialized (PlatformCache.ResolveCompositeSections), so the whole module below sees assembled entities and merges nothing."
      },
      "DealNodeActionDefinition": {
        "type": "object",
        "properties": {
          "RewardedVideo": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DealRewardedVideoActionDefinition"
              }
            ],
            "description": "Populated if Type = RewardedVideo."
          }
        },
        "description": "Container for node action parameters. The relevant nested block is populated depending on DealNodeType."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "SeasonTierRewardMultiplier": {
        "type": "object",
        "properties": {
          "Multiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier. 1.0 = neutral (resolver returns the base reward without copying). Rounding: (long)Math.Round(Amount * Multiplier). Entries with final Amount <= 0 are dropped."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this multiplier to apply."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to."
          }
        },
        "description": "Multiplier applied to Amount of the base ResourceGrant for a season-chain tier. Applied to every ResourceEntry.Amount and EventTokenOperation.Amount in Standard and in PremiumTiers.Resources."
      },
      "DealRewardedVideoActionDefinition": {
        "type": "object",
        "properties": {
          "GrantRewardsPerView": {
            "type": "boolean",
            "description": "If true, reward per view; otherwise only after completion."
          },
          "MaxViewsPerActivation": {
            "type": "integer",
            "format": "int32",
            "description": "Max views per single activation. 0 = no limit."
          },
          "ViewsRequiredToComplete": {
            "type": "integer",
            "format": "int32",
            "description": "Number of confirmed views required to complete the node."
          }
        },
        "description": "Progression of a \"watch an ad\" node: how many views complete it and how rewards are paid out. The PRICE is not here — it lives in DealNodePricing.Options as a RewardedVideoCredit entry, like everywhere else on the platform."
      }
    },
    "additionalProperties": false
  }

  arguments 2286 lines copy
• get_marketplace unknown never probed

  GET ONLY the 'Marketplace' field of TitlePublicConfigurationModel. Player-to-player marketplace (v2) — fixed-price listings (price = ResourceBundle), auctions (single-axis bids), buy orders (escrowed payment), and direct trades/gifts. Configures the audience gate, open-window schedule, price composition policy (reusing the same EntryResourceRule whitelist as Match), commission policy (percent/min, burn or ledger sink, per-goods-catalog overrides), item tradability lists, and per-mechanic settings/limits. Distinct from Store (title-sold SKUs) and DealOffer (promotions): here players trade with each other. Everything offered is escrowed at creation; commission is taken at settlement.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_marketplace unknown never probed

  PARTIAL SAVE: writes ONLY the 'Marketplace' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Player-to-player marketplace (v2) — fixed-price listings (price = ResourceBundle), auctions (single-axis bids), buy orders (escrowed payment), and direct trades/gifts. Configures the audience gate, open-window schedule, price composition policy (reusing the same EntryResourceRule whitelist as Match), commission policy (percent/min, burn or ledger sink, per-goods-catalog overrides), item tradability lists, and per-mechanic settings/limits. Distinct from Store (title-sold SKUs) and DealOffer (promotions): here players trade with each other. Everything offered is escrowed at creation; commission is taken at settlement.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "MarketplaceDefinitions",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate: who can see the marketplace and trade (create/buy/bid). null = everyone. Escrow/refund claims are never blocked by the gate."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Module master switch. Default false — the marketplace must be enabled explicitly."
          },
          "Auctions": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplaceAuctionSettings"
              }
            ],
            "description": "Auction settings."
          },
          "Listings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplaceListingSettings"
              }
            ],
            "description": "Fixed-price listing settings."
          },
          "Matching": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplaceMatchingSettings"
              }
            ],
            "description": "Cross-offer auto-matching (order-book) settings. null = disabled."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Marketplace open windows (trade events, seasonal windows). null = always open. Outside a window trading actions are blocked, but escrow/refund claims are not."
          },
          "BuyOrders": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplaceBuyOrderSettings"
              }
            ],
            "description": "Buy-order settings."
          },
          "Commission": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplaceCommissionPolicy"
              }
            ],
            "description": "Commission policy applied at settlement."
          },
          "PricePolicy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplacePricePolicy"
              }
            ],
            "description": "Price composition policy (which resources are allowed as price positions and within what bounds)."
          },
          "Tradability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplaceTradabilityPolicy"
              }
            ],
            "description": "Item tradability policy (what may be listed at all)."
          },
          "DirectTrades": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplaceDirectTradeSettings"
              }
            ],
            "description": "Direct trade / gift settings."
          }
        },
        "description": "Title marketplace (v2) configuration. P2P trading on the atomic ResourceService stack: fixed-price listings (price = ResourceBundle), auctions (single-axis bids), buy orders (escrowed payment), direct trades/gifts. Everything offered is escrowed into the offer document at creation. Commission is taken at settlement (burned or credited to the title ledger). Escrow/refund claims are never gated by Gate/Schedule."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CommissionSink": {
        "enum": [
          "Burn",
          "Ledger"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Burn",
          "Ledger"
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EntryResourceKind": {
        "enum": [
          "VirtualCurrency",
          "Item",
          "EventToken",
          "CryptoCurrency"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "VirtualCurrency",
          "Item",
          "EventToken",
          "CryptoCurrency"
        ]
      },
      "EntryResourceRule": {
        "type": "object",
        "properties": {
          "Kind": {
            "oneOf": [
              {
                "$ref": "#/definitions/EntryResourceKind"
              }
            ],
            "description": "Resource kind this rule applies to."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item ID within the catalog (for Kind = Item). Key in cfg.Item.Catalogs[CatalogID].Items."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event ID within the system (for Kind = EventToken). null/empty = any event of that system."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog ID (for Kind = Item). Key in cfg.Item.Catalogs."
          },
          "MaxAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum amount of the entry position. 0 = no upper bound."
          },
          "MinAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum amount of the entry position. 0 = no lower bound."
          },
          "TokenType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "Event-token system (for Kind = EventToken)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency ID: a virtual currency (for Kind = VirtualCurrency, key in cfg.Currency.VirtualCurrencies) or a crypto currency (for Kind = CryptoCurrency, key in cfg.Currency.CryptoCurrencies)."
          }
        },
        "description": "One entry-whitelist rule: a concrete resource (or resource family) with amount bounds. An entry position matches by Kind and identifiers; 0 in Min/Max = unbounded on that side."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "MarketplacePricePolicy": {
        "type": "object",
        "properties": {
          "Allowed": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EntryResourceRule"
            },
            "description": "Whitelist of allowed price resources with Min/Max bounds. When non-empty it is authoritative: every price position must match a rule; the type flags are ignored."
          },
          "AllowItems": {
            "type": "boolean",
            "description": "Allow stackable items as a price position. Default false. Ignored when Allowed is non-empty."
          },
          "MaxPositions": {
            "type": "integer",
            "format": "int32",
            "description": "Max number of positions in the price bundle (Entries + EventTokens). Sanity cap. Default 5. 0 = unlimited."
          },
          "AllowEventTokens": {
            "type": "boolean",
            "description": "Allow event tokens as a price position. Default false (tokens of an ended event may become unclaimable — whitelist long-lived systems only). Ignored when Allowed is non-empty."
          },
          "AllowCryptoCurrency": {
            "type": "boolean",
            "description": "Allow the title's crypto currencies as a price position (whole tokens, no USD amount). Default false — trading crypto between players is enabled explicitly. Crypto positions carry the developer's trade fee (CryptoCurrencyDefinition.PlayerTradeFeePercent) instead of the marketplace Commission. Ignored when Allowed is non-empty."
          },
          "AllowVirtualCurrency": {
            "type": "boolean",
            "description": "Allow any virtual currency as a price position. Default true. Ignored when Allowed is non-empty."
          }
        },
        "description": "Price composition policy — mirror of the Match entry policy, reusing EntryResourceRule/EntryResourceKind. Two control levels: type flags ('any resource of this type') and the authoritative Allowed whitelist with Min/Max (when non-empty the flags are ignored). Unstackable items are always rejected as price."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "MarketplaceAuctionSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether auctions are enabled. Default true (when the module is enabled)."
          },
          "BidLimits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Bid limits: CooldownSeconds + DailyCap."
          },
          "MaxDurationHours": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum auction duration in hours. Default 168."
          },
          "MinDurationHours": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum auction duration in hours. Default 1."
          },
          "MinBidStepPercent": {
            "type": "number",
            "format": "double",
            "description": "Minimum bid step as a fraction of the current bid (0.05 = 5%). Step = max(ceil(current * percent), MinBidStepAbsolute)."
          },
          "MinBidStepAbsolute": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum absolute bid step. Default 1."
          },
          "AntiSnipeWindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Anti-snipe: a bid within the last N seconds extends the deadline. 0 = disabled. Default 120."
          },
          "MaxAntiSnipeExtensions": {
            "type": "integer",
            "format": "int32",
            "description": "Max anti-snipe extensions per auction. Default 10."
          },
          "AntiSnipeExtensionSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Deadline extension in seconds on anti-snipe. Default 120."
          }
        },
        "description": "Auction settings. The bid axis is exactly one position (a VC or a stackable item) so bids are comparable."
      },
      "MarketplaceListingSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether fixed-price listings are enabled. Default true (when the module is enabled)."
          },
          "BuyLimits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Purchase limits (Buy / FillBuyOrder): CooldownSeconds + DailyCap."
          },
          "CreateLimits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Listing/auction creation limits: CooldownSeconds + DailyCap."
          },
          "ListingFeeOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Optional ways to pay the listing fee (charged at creation). Dictionary key = PriceOption.OptionID. Only the option's Standard part is used (premium fields ignored — the refund must be deterministic). A store-paid option is not allowed: the fee may have to be refunded, and this is a player-to-player context.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "MaxActiveListings": {
            "type": "integer",
            "format": "int32",
            "description": "Max simultaneously open listings+auctions per player (count query). 0 = unlimited. Default 10."
          },
          "AllowedDurationsHours": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Allowed listing durations in hours. Empty/null = default {24, 72, 168}."
          },
          "RefundListingFeeOnCancel": {
            "type": "boolean",
            "description": "Whether the listing fee is refunded on cancel. Default false. Does not apply to expiry."
          }
        },
        "description": "Fixed-price listing settings."
      },
      "MarketplaceBuyOrderSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether buy orders are enabled. Default true (when the module is enabled)."
          },
          "FillLimits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Order fill limits (seller side): CooldownSeconds + DailyCap."
          },
          "CreateLimits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Order creation limits: CooldownSeconds + DailyCap."
          },
          "MaxActiveOrders": {
            "type": "integer",
            "format": "int32",
            "description": "Max simultaneously open buy orders per player. 0 = unlimited. Default 5."
          },
          "AllowedDurationsHours": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Allowed order durations in hours. Empty/null = default {24, 72, 168}."
          }
        },
        "description": "Buy-order settings. The creator escrows the full payment at creation."
      },
      "MarketplaceCommissionPolicy": {
        "type": "object",
        "properties": {
          "Sink": {
            "oneOf": [
              {
                "$ref": "#/definitions/CommissionSink"
              }
            ],
            "description": "Commission sink: Burn — destroyed (default), Ledger — credited to the title's MarketplaceLedger document."
          },
          "Percent": {
            "type": "number",
            "format": "double",
            "description": "Commission fraction (0.05 = 5%). Default 0.05."
          },
          "MinPerPosition": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum commission per price position (in the position's resource units). 0 = no minimum."
          },
          "LedgerAccountID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ledger account ID (for Sink=Ledger). Empty falls back to \"default\"."
          },
          "ApplyToDirectTrades": {
            "type": "boolean",
            "description": "Whether commission applies to direct trades (the RequestedBundle at accept). Default false — gifts/trades are commission-free."
          },
          "PerCatalogOverrides": {
            "type": [
              "null",
              "object"
            ],
            "description": "Commission overrides by the GOODS catalog (key = the offer's goods CatalogID).",
            "additionalProperties": {
              "$ref": "#/definitions/MarketplaceCommissionOverride"
            }
          }
        },
        "description": "Commission policy. Computed per price position at settlement: fee = min(amount, max(ceil(amount * Percent), MinPerPosition)); the seller receives the net. The policy is snapshotted into the offer at creation."
      },
      "MarketplaceMatchingSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether auto-matching is enabled. Default false — enabled explicitly via config."
          }
        },
        "description": "Cross-offer auto-matching (order-book). When enabled, creating a fixed scalar-VC-priced listing/buy-order first tries to execute immediately against the best opposite offer (same goods and quantity, bid >= ask) reusing atomic Buy/FillBuyOrder, at the maker's price. v1 scope: single-VC scalar price, exact GoodsAmount match (no partial fills), fungible goods only. Auctions and direct trades never match."
      },
      "MarketplaceTradabilityPolicy": {
        "type": "object",
        "properties": {
          "DeniedItemIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Specific ItemIDs denied from trading."
          },
          "DeniedCatalogIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Catalogs denied from trading (applied on top of AllowedCatalogIDs)."
          },
          "AllowedCatalogIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "When non-empty — only items from these catalogs may be traded."
          },
          "DeniedCurrencyIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Currencies denied from being traded as goods (applied on top of AllowedCurrencyIDs)."
          },
          "AllowedCurrencyIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "When non-empty — only these currencies may be listed as goods. The base gate VirtualCurrencyPermissions.IsTradable == true still applies."
          },
          "AllowUnstackableWithState": {
            "type": "boolean",
            "description": "Allow selling unstackable instances with state (Level > 1 / CustomData). State is preserved on transfer (templated instance grants). Default true. false = only pristine instances are tradable."
          }
        },
        "description": "Goods tradability policy. Items: base ItemDefinition.IsTradable == true on top of AND allow/deny lists of catalogs/items; equipped and expired instances are never tradable. Currencies as goods: base VirtualCurrencyPermissions.IsTradable == true on top of AND allow/deny currency lists."
      },
      "MarketplaceCommissionOverride": {
        "type": "object",
        "properties": {
          "Percent": {
            "type": "number",
            "format": "double",
            "description": "Commission fraction for this catalog (0.05 = 5%)."
          },
          "MinPerPosition": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum commission per price position."
          }
        },
        "description": "Commission override for a specific goods catalog."
      },
      "MarketplaceDirectTradeSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether direct trades are enabled. Default true (when the module is enabled)."
          },
          "AllowGifts": {
            "type": "boolean",
            "description": "Allow one-way gifts (empty RequestedBundle). Default true."
          },
          "CreateLimits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Trade offer creation limits: CooldownSeconds + DailyCap."
          },
          "MaxPendingOutgoing": {
            "type": "integer",
            "format": "int32",
            "description": "Max simultaneously pending outgoing offers per player. 0 = unlimited. Default 10."
          },
          "OfferExpirationHours": {
            "type": "integer",
            "format": "int32",
            "description": "Offer lifetime in hours. Default 168."
          }
        },
        "description": "Direct trade / gift settings. The initiator escrows the offered side at creation."
      }
    },
    "additionalProperties": false
  }

  arguments 1576 lines copy
• get_quest unknown never probed

  GET ONLY the 'Quest' field of TitlePublicConfigurationModel. Quest / mission / objective definitions — single tasks the player completes for a reward. Includes trigger conditions, progress counters, completion criteria, reward references (use Reward). For grouped quest chains use Season or TimedEvent.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_quest unknown never probed

  PARTIAL SAVE: writes ONLY the 'Quest' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Quest / mission / objective definitions — single tasks the player completes for a reward. Includes trigger conditions, progress counters, completion criteria, reward references (use Reward). For grouped quest chains use Season or TimedEvent.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "QuestDefinitions",
        "properties": {
          "Cycles": {
            "type": [
              "null",
              "object"
            ],
            "description": "Cycle definitions (daily/weekly/monthly/every N days). Reset time is fixed at 00:00:00 UTC. Weekly always starts Monday, Monthly always starts on the 1st.",
            "additionalProperties": {
              "$ref": "#/definitions/QuestCycleDefinition"
            }
          },
          "Quests": {
            "type": [
              "null",
              "object"
            ],
            "description": "Quest definitions keyed by QuestID. Empty Linking.CycleIDs => permanent quest; otherwise cyclic.",
            "additionalProperties": {
              "$ref": "#/definitions/QuestDefinition"
            }
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestPresetRegistry"
              }
            ],
            "description": "Registry of reusable blocks (Core/Presets) — the module's only reuse mechanism. Quests reference it via QuestDefinition.Presets; cycles and phases via their own Presets.Milestones."
          }
        },
        "description": "Root block of the quest system in the title config."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "QuestReward": {
        "type": "object",
        "properties": {
          "Grant": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Claim grant. Grant only — ResourceGrant, not ResourceOperation. Premium resolution runs in ResourceService against global cfg.Premium settings."
          },
          "PointsReward": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Points into the cycle track (\"crown points\") granted on quest claim. Default 0 = the quest gives no points. Backed by a Quest token (EventTokenType.Quest, EntityID \"{cycleID}:{instanceKey}\") inside the same atomic claim TX. Meaningful only for cyclic quests."
          }
        },
        "description": "Quest claim reward: the resource grant plus points into the cycle track."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "MilestoneSet": {
        "type": "object",
        "properties": {
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone set keyed by MilestoneID (same shape as the inline Milestones dictionary).",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          }
        },
        "description": "Thin wrapper for a reusable milestone set. Its single field mirrors the inline shape (EventContent.Milestones / LeaderboardDefinition.Milestones / DealOfferDefinition.Milestones) so the resolver returns a compatible dictionary. Cross-module type (used by TimedEvent, Leaderboard, DealOffer) -- lives in Core next to MilestoneDefinition. Resolved by PresetResolver.MergeDictionary."
      },
      "QuestLinking": {
        "type": "object",
        "properties": {
          "GroupID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Group label (Mongo-safe): UI sections/tabs and the QuestGroupCompletionDefinition grand reward (\"complete N tasks of the group\"). Just a string — the module has no separate \"group\" entity."
          },
          "CycleIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "List of CycleIDs the quest belongs to. Empty list => permanent. Otherwise cyclic, one entry per cycle it appears in."
          },
          "PhaseIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Chain phases (QuestPhaseDefinition.PhaseID) in which this quest is active. Empty = every phase of the cycle. Only meaningful for a cycle with Mode = Chained. Gates both progress accrual and claiming."
          },
          "PrerequisiteMode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestPrerequisiteMode"
              }
            ],
            "description": "What prerequisites (RequiredQuestIDs) affect: BlockProgressAndClaim (default) — the quest does NOT start accruing progress and thus cannot be claimed; BlockClaimOnly — progress accrues immediately but the REWARD cannot be claimed until dependencies complete. Ignored when RequiredQuestIDs is empty."
          },
          "RequiredQuestIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Prerequisites: which QuestIDs must be Completed/Claimed. What the dependency affects is set in PrerequisiteMode. The dependency is looked up where its progress lives (permanent -> PermanentQuests; cyclic -> the same cycle, otherwise its first cycle)."
          }
        },
        "description": "Quest links: which cycles and phases it belongs to, which label groups it, and what it depends on. Analogous to CharacterClassification — categorical traits and references."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "QuestIdentity": {
        "type": "object",
        "properties": {
          "SortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "UI sort order (lower = higher). Default 0."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Quest assets (task icon). Key = logical slot name.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Quest description for UI. Usually shared by a batch of tasks — lives in a preset."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Quest display name for UI."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary client-side parameters: things the UI needs to draw that do not belong in the backend schema (localization key, day number, category tag, colour). The engine never interprets them.",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        "description": "Display part of a quest. Analogous to CharacterIdentity: everything needed to draw it and nothing that affects the rules."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "QuestDefinition": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestReward"
              }
            ],
            "description": "Claim reward: the grant plus points into the cycle track."
          },
          "Linking": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestLinking"
              }
            ],
            "description": "Links: cycles, group label, phases, prerequisites."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestPresetBindings"
              }
            ],
            "description": "Preset wiring — one binding per block. The only reuse mechanism."
          },
          "QuestID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Quest ID (e.g. \"win_3_raids\"). Mongo-safe. Matches the dictionary key."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestIdentity"
              }
            ],
            "description": "Display part: name, description, order, assets, custom params."
          },
          "Objectives": {
            "type": [
              "null",
              "object"
            ],
            "description": "Quest objectives. The quest is completed when ALL objectives are completed. Key = ObjectiveID. Merged by key on top of the preset's objectives, and inside a matched objective the same \"unset = from preset\" rule applies: \"same objective but 50 instead of 15\" is { \"task\": { \"TargetValue\": 50 } }, not a copy of the triggers.",
            "additionalProperties": {
              "$ref": "#/definitions/QuestObjectiveDefinition"
            }
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestAvailability"
              }
            ],
            "description": "Availability: window, accrue-while-locked, audience gate, point limits."
          }
        },
        "description": "Quest definition. Only the ID lives at the root; everything else is split into blocks, each optional and each able to come wholly or partly from a preset (Presets)."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "QuestAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Quest audience gate — standard SegmentGate (Core/Segment). Unset = available to all. Effective gate = cycle gate AND quest gate."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Limits on this quest's POINT grants into the track — standard LimitSpec (Core/Limits). Mapped into EventTokenGrantContext as per-source caps/cooldown (DailyWeightCap->DailyCapFromSource, DailyCap->DailyTriggerCap, CooldownSeconds). Unset = no per-source limits. Global point caps live in QuestCycleDefinition.PointsToken."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Per-quest availability/unlock window — standard ScheduleSpec (Core/Scheduling), like TimedEvent/Leaderboard/TimedBoost. Resolved by the same ScheduleResolver: progress accrues while CanEarn, claim allowed while CanClaim (with grace). Unset = the quest inherits its cycle window. This IS the staged unlock: \"days\" are a special case (Relative windows with staggered starts, or Chained phases)."
          },
          "AccrueProgressWhenLocked": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether to accrue progress while the quest window (Schedule) is not yet open / already closed, as long as the event (cycle) window is active. false (default) — progress follows the quest schedule strictly: a locked stage accrues nothing (the lock on \"Day N\"). true — progress always accrues within the event window, but the REWARD is still claimable only after unlock. Applies only when Schedule is set."
          }
        },
        "description": "Quest access rules: when it is open, who may see it, under which limits. Analogous to CharacterUnlock."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "MilestoneDefinition": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base rewards. Always granted on a successful claim."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order in the UI (lower = higher/earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone images (icon, badge). null = unset.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsFeatured": {
            "type": "boolean",
            "description": "Featured milestone: special UI styling. With MilestoneClaimMode.FeaturedAfterEnd these can only be claimed after the instance ends."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI/CMS. null = unset."
          },
          "MilestoneID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique milestone ID within its owning entity (Mongo-safe, claim idempotency key)."
          },
          "BonusRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Bonus-window overlay: extra rewards on top of Rewards when the bonus phase is active at claim time (MilestoneRewardContext.BonusActive). Applied via MilestoneRewardResolver. null = no bonus part."
          },
          "RequiredProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Threshold over ACCUMULATED progress to unlock. EventToken systems: EventTokenBalanceData.TotalEarned (not current balance). CommunityChest: shared group progress."
          },
          "SeasonTierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SeasonTierRewardSet"
              }
            ],
            "description": "Season-tier overlay: reward scaling by the player's season tier. Applied via MilestoneRewardResolver (SeasonTierRewardResolver.Resolve) only when MilestoneRewardContext.SeasonChainID is set. null = disabled."
          }
        },
        "description": "Unified milestone primitive for all platform systems (TimedEvent, Leaderboard, Quest, CommunityChest, DealOffer). Replaces the per-module milestone definitions. Threshold is checked against accumulated progress (RequiredProgress): EventToken systems use EventTokenBalanceData.TotalEarned; CommunityChest uses shared group progress. Reward overlays BonusRewards (bonus-window) and SeasonTierRewards (season-tier) are platform-wide optional fields applied via MilestoneRewardResolver; leave null if unused."
      },
      "QuestPresetBindings": {
        "type": "object",
        "properties": {
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Reward preset (field-level overlay)."
          },
          "Linking": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Linking preset (field-level overlay)."
          },
          "Milestones": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Milestones preset — cycles and chain phases only (merge by MilestoneID)."
          },
          "Objectives": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Objectives preset: merge by ObjectiveID, field-level overlay inside a matched objective, PresetBinding.Remove drops inherited objectives."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Availability preset (field-level overlay)."
          }
        },
        "description": "Preset wiring container — one PresetBinding per block, like CharacterPresetBindings. Bindings are independent: take the schedule from one preset, the reward from another, and write the objectives inline."
      },
      "QuestPresetRegistry": {
        "type": "object",
        "properties": {
          "Reward": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable reward blocks: the grant plus points into the cycle track.",
            "additionalProperties": {
              "$ref": "#/definitions/QuestReward"
            }
          },
          "Linking": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable linking blocks: cycles, group label, phases, prerequisites.",
            "additionalProperties": {
              "$ref": "#/definitions/QuestLinking"
            }
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable milestone sets (shared MilestoneSet) for cycles and phases, keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneSet"
            }
          },
          "Objectives": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable objective sets (inner dictionary key = ObjectiveID). The preset says HOW an objective advances (Source, Triggers, aggregation); a quest normally overrides only TargetValue.",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "$ref": "#/definitions/QuestObjectiveDefinition"
              }
            }
          },
          "Availability": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable availability blocks: window, accrue-while-locked, audience gate, point limits.",
            "additionalProperties": {
              "$ref": "#/definitions/QuestAvailability"
            }
          }
        },
        "description": "Registry of reusable quest config blocks. Each field is a dictionary keyed by PresetID and mirrors the same-named QuestDefinition block. Direct analogue of CharacterPresetRegistry (Stats / Levels / Equipment)."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "SeasonTierRewardSet": {
        "type": "object",
        "properties": {
          "Bundles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardBundle"
            },
            "description": "Structurally different rewards for specific tiers. On match, replaces the base ResourceGrant entirely (Replace)."
          },
          "Multipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardMultiplier"
            },
            "description": "Multipliers applied to Amount of the base ResourceGrant. Used ONLY if no Bundles entry matched."
          }
        },
        "description": "Generic container of season-tier reward scaling. Used by any platform system (leaderboards, lootboxes, shop, daily) that wants to scale a ResourceGrant by the player's current tier in a season chain. Empty/null lists = neutral."
      },
      "EventTokenConversion": {
        "type": "object",
        "properties": {
          "Rate": {
            "type": "number",
            "format": "double",
            "description": "Conversion rate: 1 event token = Rate units of the target currency. Example: 0.1 means 10 tokens = 1 unit of currency."
          },
          "MaxConvertAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Max number of tokens eligible for conversion. Inflation guard — if the player has 100000 tokens, only up to MaxConvertAmount is converted."
          },
          "TargetCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "What to convert to (VirtualCurrency ID). Example: \"IG\" (in-game gold), \"DICE\"."
          }
        },
        "description": "Conversion rules for event tokens at burn. Lets the platform compensate the player for unused tokens."
      },
      "EventTokenDefinition": {
        "type": "object",
        "properties": {
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Token images: icon and similar assets.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "MaxBalance": {
            "type": "integer",
            "format": "int64",
            "description": "Max token balance the player can accumulate. 0 = unlimited. Protects against unbounded accrual."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Token name shown in UI. Example: \"Pumpkin Coins\", \"Raid Points\"."
          },
          "MaxPerGrant": {
            "type": "integer",
            "format": "int64",
            "description": "Max tokens per single grant (anti-abuse). Caps the maximum portion of a single grant."
          },
          "DailyEarnCap": {
            "type": "integer",
            "format": "int64",
            "description": "Max tokens per day across all sources. 0 = unlimited. Global daily cap."
          },
          "BurnConversion": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenConversion"
              }
            ],
            "description": "Conversion rules for the leftover balance at burn. If set, the remainder is converted to the specified VirtualCurrency. null = balance is zeroed without compensation."
          },
          "BurnOnEventEnd": {
            "type": "boolean",
            "description": "Whether tokens burn at event end. true = balance is zeroed (or converted via BurnConversion). false = tokens persist (collectible)."
          }
        },
        "description": "Event-token definition. An event token is a separate entity, not a VirtualCurrency. Balance lives in UserEventProgress.TokenBalance, ensuring isolation between events and automatic burn-on-end behavior."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "QuestCycleDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate for the whole event/cycle — standard SegmentGate (Core/Segment), like Store/Reward/TimedBoost/Experiment. null = available to all. AND-ed with the quest gate."
          },
          "Phases": {
            "type": [
              "null",
              "object"
            ],
            "description": "Chain phases — ONLY for Schedule.Mode = Chained. Key = PhaseID (Mongo-safe). Each phase is a standalone window with its OWN points track and milestones: the track address includes the instance's InstanceKey, which for a phase is chain:{cycleIndex}:{phaseID}, so points and claimed milestones never mix across phases, and the cycle state resets at a phase boundary exactly like it does at midnight for Daily. Empty while Chained = nothing to resolve, the cycle stays inactive. Ignored for other schedule modes.",
            "additionalProperties": {
              "$ref": "#/definitions/QuestPhaseDefinition"
            }
          },
          "CycleID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Cycle ID (e.g. \"daily\", \"weekly\", \"monthly\", \"cycle_10d\"). Mongo-safe (no '.' or '$'), since it may be a state key."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestPresetBindings"
              }
            ],
            "description": "Cycle-level preset wiring (Core/Presets). Currently the milestone set."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Unified cycle schedule container — same ScheduleSpec and modes as every other system. Usually Cyclic: Daily/Weekly/Monthly (calendar reset at 00:00 UTC; Weekly = Monday, Monthly = 1st) or FixedInterval (every Cyclic.IntervalSeconds seconds from Cyclic.AnchorUtc). Scheduled (one-off window) / AlwaysOn (eternal) are also allowed."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Cycle assets for the client (icon, banner). Key = logical slot name.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone rewards for points earned in the current cycle window.",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Cycle name for UI/admin panel."
          },
          "PointsToken": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenDefinition"
              }
            ],
            "description": "Points-track token definition (Core/Event, EventTokenDefinition) — same as TimedEvent. Carries caps/balance/burn for points (MaxBalance, DailyEarnCap, MaxPerGrant, BurnOnEventEnd...). null = points granted without global caps. Per-source limits live on the quest (QuestAvailability.Limits)."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary client-side parameters (badge colour, localization key, tag).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "GroupCompletions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Grand \"complete N tasks of the group\" rewards (the big chest). Key = CompletionID (Mongo-safe). Each completion references the QuestLinking.GroupID label and sets how many quests carrying it are required.",
            "additionalProperties": {
              "$ref": "#/definitions/QuestGroupCompletionDefinition"
            }
          }
        },
        "description": "Cycle definition: schedule + milestone rewards. Quests are NOT listed here — quests reference CycleID themselves."
      },
      "QuestObjectiveSource": {
        "enum": [
          "ClientApi",
          "ServerApi",
          "SystemEvent"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ClientApi",
          "ServerApi",
          "SystemEvent"
        ]
      },
      "QuestPhaseDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Phase audience gate (Core/Segment). AND-ed with the cycle gate and the quest gate. null = open to everyone the cycle let through."
          },
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Phase order within the cycle (0, 1, 2...). Defines the sequence."
          },
          "PhaseID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Phase ID, unique within the chain. Mongo-safe — it becomes part of the points-track key."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestPresetBindings"
              }
            ],
            "description": "Phase preset wiring. Applied to this phase's Milestones."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Phase assets. null = inherited from the cycle.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Points-track milestones of THIS phase. null = the cycle's milestones are used (one ladder shared by all phases). An empty dictionary explicitly means \"no milestones in this phase\" and does NOT inherit the cycle's.",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Phase name for the UI (\"Week 2\", \"Finale\")."
          },
          "DurationSec": {
            "type": "integer",
            "format": "int64",
            "description": "Phase duration in seconds. Must be > 0 or the phase will not resolve."
          },
          "PointsToken": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenDefinition"
              }
            ],
            "description": "Phase points-token definition. null = the cycle's token."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary client-side parameters for the phase. null = inherited from the cycle.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the phase ends during which rewards can still be claimed. 0 = only while the phase is active."
          }
        },
        "description": "One phase of a quest chain: the window (ScheduleChainPhase fields) plus its own content. Analogous to TimedEvent's ChainedEventDefinition, but the content is optional: any unset field falls back to the cycle level, so \"eight weeks with identical milestones\" is eight empty phases rather than eight copies of the settings."
      },
      "QuestPrerequisiteMode": {
        "enum": [
          "BlockProgressAndClaim",
          "BlockClaimOnly"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BlockProgressAndClaim",
          "BlockClaimOnly"
        ]
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "SeasonTierRewardBundle": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this tier. Passed unmodified into ResourceService via a regular ResourceOperation.Grant."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this bundle to apply. Matches SeasonTierDefinition.Tier / UserSeasonState.CurrentTier."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to. Selection matches only tiers with the same SeasonChainID."
          }
        },
        "description": "Structurally different rewards for a season-chain tier. Analogous to PremiumTierBundle but the trigger is the player's season tier. Selection picks the single best match (MinSeasonTier <= playerTier); not stacked."
      },
      "QuestObjectiveDefinition": {
        "type": "object",
        "properties": {
          "Source": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/QuestObjectiveSource"
              }
            ],
            "description": "Who advances the progress. Selects which field is read: MetricID (ClientApi/ServerApi) or Triggers (SystemEvent). Default ClientApi."
          },
          "MetricID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Metric key that contributes progress (e.g. \"raid_win\", \"currency_spent\"). Read ONLY when Source = ClientApi/ServerApi; matched exactly (Ordinal, trimmed). Ignored for SystemEvent."
          },
          "Triggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "In-game events that advance this objective. Read ONLY when Source = SystemEvent. Same TriggerSource used by EventContent.TokenSources (TimedEvent) and LeaderboardDefinition.ScoreSources: event type + filters (tile, outcome, Params) + BaseWeight as the progress step per fire. Matched by the shared TriggerMatcher; the list is OR-ed. An empty list = the objective never advances."
          },
          "ObjectiveID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Objective ID within the quest (e.g. \"raid_wins\"). Mongo-safe. Matches the dictionary key."
          },
          "TargetValue": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Required value to complete the objective. Default 1. This is the field an objective is normally overridden for on top of a preset."
          },
          "AggregationMethod": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/StatisticAggregationMethod"
              }
            ],
            "description": "Progress aggregation method. Default Sum."
          },
          "MaxProgressPerCall": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Delta cap for a SINGLE AddQuestProgress call. Applies to ClientApi only: exceeding it is treated as cheating and BANS the player (see QuestV2.AddQuestProgress) rather than silently clamping. Default 0 = no cap. For SystemEvent the step size comes from TriggerSource.BaseWeight."
          }
        },
        "description": "Quest objective — a counter driven by exactly one mechanism, selected by Source: ClientApi/ServerApi advance it by the string key MetricID (client calls Quest/AddQuestProgress, server calls server.AddQuestProgress from CloudCode); SystemEvent advances it from the Triggers list, i.e. the same in-game events (TriggerSource) that feed TimedEvent tokens and leaderboard score — no HTTP call involved. Every field is optional: an objective may be a delta over the preset's objective, setting only TargetValue. An unset field is taken from the objective with the same ObjectiveID in the preset, and only then from the hard default (ClientApi / 0 / 1 / Sum)."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "SeasonTierRewardMultiplier": {
        "type": "object",
        "properties": {
          "Multiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier. 1.0 = neutral (resolver returns the base reward without copying). Rounding: (long)Math.Round(Amount * Multiplier). Entries with final Amount <= 0 are dropped."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this multiplier to apply."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to."
          }
        },
        "description": "Multiplier applied to Amount of the base ResourceGrant for a season-chain tier. Applied to every ResourceEntry.Amount and EventTokenOperation.Amount in Standard and in PremiumTiers.Resources."
      },
      "StatisticAggregationMethod": {
        "enum": [
          "Last",
          "Minimum",
          "Maximum",
          "Sum"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Last",
          "Minimum",
          "Maximum",
          "Sum"
        ]
      },
      "QuestGroupCompletionDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Optional audience gate for the reward (Core/Segment). AND-ed with the cycle gate."
          },
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Completion rewards. Grant only — ResourceGrant."
          },
          "GroupID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Label (QuestLinking.GroupID) whose tasks are counted."
          },
          "CompletionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Completion ID (e.g. \"day1_all\"). Mongo-safe."
          },
          "PointsReward": {
            "type": "integer",
            "format": "int64",
            "description": "Points into the cycle track for the completion (optional, on top of per-quest points). 0 = none."
          },
          "RequiredCompletedQuests": {
            "type": "integer",
            "format": "int32",
            "description": "How many quests must be completed (Completed or Claimed). 0 = ALL quests carrying the label per config (this cycle's quests with a matching QuestLinking.GroupID)."
          }
        },
        "description": "Grand reward for completing N tasks sharing the QuestLinking.GroupID label (e.g. \"all event tasks\"). Counted by the NUMBER of completed quests, unlike cycle milestones which are counted by points."
      }
    },
    "additionalProperties": false
  }

  arguments 2000 lines copy
• get_tutorial unknown never probed

  GET ONLY the 'Tutorial' field of TitlePublicConfigurationModel. Tutorial / onboarding definitions — flows (ordered scenarios) built from steps that teach the player a mechanic. A step completes either by client acknowledgement or by a real game event (the same TriggerSource vocabulary as Quest), so "make a roll", "buy something", "open a chest" need no client-side bookkeeping. A step may also PREDETERMINE the outcome of another module (TutorialScriptedOutcome — e.g. force the board dice to land on a Raid tile), which is the only way to demonstrate a mechanic instead of randomness. Flows carry an audience gate (SegmentGate) and a schedule (ScheduleSpec); putting an Experiment condition in that gate is how two tutorial versions are A/B-tested. Gating other content on tutorial progress is done via SegmentGate.Tutorial per entity, or via Settings.Blocking to close whole modules until onboarding is finished.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_tutorial unknown never probed

  PARTIAL SAVE: writes ONLY the 'Tutorial' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Tutorial / onboarding definitions — flows (ordered scenarios) built from steps that teach the player a mechanic. A step completes either by client acknowledgement or by a real game event (the same TriggerSource vocabulary as Quest), so "make a roll", "buy something", "open a chest" need no client-side bookkeeping. A step may also PREDETERMINE the outcome of another module (TutorialScriptedOutcome — e.g. force the board dice to land on a Raid tile), which is the only way to demonstrate a mechanic instead of randomness. Flows carry an audience gate (SegmentGate) and a schedule (ScheduleSpec); putting an Experiment condition in that gate is how two tutorial versions are A/B-tested. Gating other content on tutorial progress is done via SegmentGate.Tutorial per entity, or via Settings.Blocking to close whole modules until onboarding is finished.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "TutorialDefinitions",
        "properties": {
          "Flows": {
            "type": [
              "null",
              "object"
            ],
            "description": "Tutorial flow (onboarding scenario) definitions keyed by FlowID.",
            "additionalProperties": {
              "$ref": "#/definitions/TutorialFlowDefinition"
            }
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialPresetRegistry"
              }
            ],
            "description": "Registry of reusable blocks (Core/Presets) — the module's only reuse mechanism. Flows reference it via TutorialFlowDefinition.Presets."
          },
          "Settings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGlobalSettings"
              }
            ],
            "description": "Module-wide settings: master switch and the policy for blocking other modules."
          }
        },
        "description": "Root block of the tutorial (onboarding) system in the title config."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "TutorialReward": {
        "type": "object",
        "properties": {
          "Grant": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Completion grant. Grant only — ResourceGrant, not ResourceOperation: nobody pays for a tutorial. Premium resolution runs in ResourceService against global cfg.Premium settings."
          },
          "AutoClaim": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether to grant automatically on finishing the last step. Default false — the reward is taken by an explicit ClaimFlowReward: the client needs a moment at which to show the \"here is what you got\" screen."
          }
        },
        "description": "Flow completion reward."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "TutorialIdentity": {
        "type": "object",
        "properties": {
          "SortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "UI sort order (lower = higher). Default 0."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Flow assets (icon, banner). Key = logical slot name.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Flow description for UI."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Flow display name for UI."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary client-side parameters: things the UI needs to draw that do not belong in the backend schema (theme, category tag, colour). The engine never interprets them.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "DescriptionKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key for the description. Same semantics as DisplayNameKey."
          },
          "DisplayNameKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key for the name. When set, the client resolves it via its own dictionary and ignores DisplayName; when empty, DisplayName is shown as-is."
          }
        },
        "description": "Display part of a flow: everything needed to draw it and nothing that affects the rules."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "TutorialFlowPolicy": {
        "type": "object",
        "properties": {
          "Skippable": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the whole flow may be skipped. Default false: onboarding is mandatory by default, and skippability is a deliberate publisher decision."
          },
          "IsBlocking": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether this flow participates in hard module blocking (TutorialBlockingPolicy). Default false. The flag alone closes nothing — the restriction set is defined by the policy in TutorialGlobalSettings."
          },
          "RestartPolicy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialRestartPolicy"
              }
            ],
            "description": "Whether the flow can be taken again. Default Never."
          },
          "UnlockFeatures": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "What completing the flow unlocks — arbitrary feature labels for the CLIENT (\"shop\", \"raids\"). This is the soft gating level: the server only reports them, it does not enforce them. Server-side enforcement is SegmentGate.Tutorial on the entity itself, or TutorialBlockingPolicy."
          },
          "ExpireAfterSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "After how many seconds an unfinished flow is considered Expired and stops blocking/showing. 0 (default) = never expires."
          },
          "SkippableFromOrder": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "From which TutorialStepDefinition.Order skipping becomes available. Default 0 (skippable immediately when Skippable = true). Lets you force the first N steps and release the player afterwards."
          }
        },
        "description": "Flow progression policy: what the player may do with it and what it unlocks."
      },
      "TutorialStepPolicy": {
        "type": "object",
        "properties": {
          "Skippable": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether this particular step may be skipped without abandoning the flow. Default false. Distinct from TutorialFlowPolicy.Skippable, which skips the whole scenario; this skips one step (e.g. an optional aside)."
          },
          "TimeoutSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "After how many seconds from being shown the step auto-completes. 0 (default) = no time-based completion. Needed for informational asides that await no player action."
          }
        },
        "description": "Per-step policy."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "TutorialBoardAction": {
        "enum": [
          "Raid",
          "Attack"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Raid",
          "Attack"
        ],
        "x-enum-descriptions": [
          "Raid.",
          "Attack."
        ]
      },
      "TutorialBoardScript": {
        "type": "object",
        "properties": {
          "TileType": {
            "type": [
              "null",
              "string"
            ],
            "description": "Tile type to land on — a BoardTileType name or a CustomTypeID, case-insensitive (the same convention as TriggerSource.TileTypeFilter). The NEAREST matching tile forward along the board is used. Empty = type not forced."
          },
          "TileIndex": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Exact tile index. When set, it wins over TileType: an index is unambiguous while a type may occur many times on the board. null = not forced."
          },
          "ChanceOutcomeID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Chance tile outcome (ChanceOutcome.OutcomeID). Forcing it separately is necessary: without it, a step saying \"a chance tile is coming and you will get coins\" would show a random outcome from the table, i.e. contradict its own copy. Empty = honest outcome."
          },
          "RandomActionType": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialBoardAction"
              }
            ],
            "description": "What a RandomAction tile resolves to — Raid or Attack. Same reason as ChanceOutcomeID: otherwise the random-action tile shows a different mechanic than the step describes. null = honest roll."
          }
        },
        "description": "Predetermined board roll. All three fields are independent: you may force only the tile and leave the Chance outcome honest."
      },
      "TutorialStepEffects": {
        "type": "object",
        "properties": {
          "Grant": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Grant for completing the step. Grant only (ResourceGrant). Applied through ResourceService inside the same atomic operation as the step progress write."
          },
          "UnlockFeatures": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Feature labels unlocked by this step (soft gating level, see TutorialFlowPolicy.UnlockFeatures)."
          }
        },
        "description": "Side effects of completing a step."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "TutorialAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate — standard SegmentGate (Core/Segment). Unset = available to all. A/B lives HERE: Gate.Experiment binds the flow to an experiment variant, so two tutorial versions differ by a single config field."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Availability window — standard ScheduleSpec (Core/Scheduling). Unset = always available (equivalent to AlwaysOn). Plain onboarding needs no schedule; a seasonal tutorial for a new feature does."
          },
          "AutoStart": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Auto-start on the first request from a player who passes the gate. Default true — onboarding must start by itself: a client that forgets to call StartFlow would otherwise silently leave the player without a tutorial. false = the flow starts only via an explicit call or a trigger."
          },
          "StartTrigger": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TriggerSource"
              }
            ],
            "description": "Game event that starts the flow (the same TriggerSource used by quests). When set, the flow starts on a fire regardless of AutoStart. Needed for just-in-time tutorials: explain raids not at session start but when the player first lands on the matching tile."
          },
          "RequiredFlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Prerequisites: which FlowIDs must be finished (Completed or Skipped) first. Empty = no gate."
          }
        },
        "description": "Flow access rules: when it is open, who may see it, what starts it."
      },
      "TutorialScriptModule": {
        "enum": [
          "GameLoop"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "GameLoop"
        ],
        "x-enum-descriptions": [
          "The GameLoop board: dice value, Chance outcome, RandomAction resolution."
        ]
      },
      "TutorialStepIdentity": {
        "type": "object",
        "properties": {
          "Body": {
            "type": [
              "null",
              "string"
            ],
            "description": "Hint body text."
          },
          "Title": {
            "type": [
              "null",
              "string"
            ],
            "description": "Hint title."
          },
          "UiHint": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary rendering hints for the client: popup position, mask shape, whether tapping outside is allowed. The engine never interprets them.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BodyKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key for the body. When set, it wins over Body."
          },
          "AnchorID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Logical name of the UI element the hint attaches to (\"roll_button\", \"shop_tab\"). The engine never interprets it — it is a contract between the config and the game."
          },
          "TitleKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key for the title. When set, it wins over Title."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Step assets (image, video, arrow). Key = logical slot name.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "HighlightTarget": {
            "type": [
              "null",
              "string"
            ],
            "description": "What to highlight when it is not the anchor itself (e.g. the hint sits by a button but the whole panel must be lit). Empty = AnchorID is highlighted."
          }
        },
        "description": "Display part of a step. This is what makes A/B over wording possible: copy and anchors live in the config, so two tutorial variants differ without rebuilding the game."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "TutorialRestartPolicy": {
        "enum": [
          "Never",
          "OnRequest",
          "Always"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Never",
          "OnRequest",
          "Always"
        ],
        "x-enum-descriptions": [
          "Not allowed. Default.",
          "Only on an explicit player request (a \"replay tutorial\" button in the settings).",
          "Again whenever the availability conditions hold. Careful: for a rewarded flow this would mean re-granting, so such a flow's reward is granted on the first pass only."
        ]
      },
      "TutorialBlockingPolicy": {
        "type": "object",
        "properties": {
          "BlockedActions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Individually closed actions: module -> action list. Lets you close purchasing while leaving the shop readable — otherwise the client cannot draw the very screen the tutorial is showing.",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          "BlockedModules": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Modules closed entirely until the blocking flow completes (FunctionName values: \"Store\", \"Marketplace\", ...)."
          },
          "SkipLiftsBlock": {
            "type": "boolean",
            "description": "Whether a Skipped flow lifts the block. true (default) — yes: if the publisher allowed skipping, the skipper must get the full game. false — skipping closes the tutorial but the restrictions remain (\"you may skip, but the shop still opens only after completing\")."
          },
          "BlockingFlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Which flows block. Empty = every flow with Policy.IsBlocking = true blocks. List them explicitly when only some mandatory flows should block."
          },
          "BlockBeforeStart": {
            "type": "boolean",
            "description": "Whether blocking applies BEFORE the player starts the flow. true (default) — yes: the point of mandatory onboarding is that you cannot walk past it. false — blocking starts only after StartFlow, and a player who never began is unrestricted."
          }
        },
        "description": "Hard module blocking while a tutorial is in progress. Modelled on BanLevelDefinition's BlockedModules/BlockedActions: names are FunctionName values and module action-enum values, matched case-insensitively; an unknown name simply does not match and never breaks the request. This is the cheapest of the three gating levels — one check in ClientRun instead of a gate on every entity. Costs nothing for titles that leave it empty."
      },
      "TutorialFlowDefinition": {
        "type": "object",
        "properties": {
          "Steps": {
            "type": [
              "null",
              "object"
            ],
            "description": "Flow steps keyed by StepID. Ordering comes from TutorialStepDefinition.Order, not from key order — BSON dictionaries guarantee no order. Merged by key on top of the preset's steps, with the same \"unset = from preset\" rule inside a matched step.",
            "additionalProperties": {
              "$ref": "#/definitions/TutorialStepDefinition"
            }
          },
          "FlowID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Flow ID (e.g. \"first_session\"). Mongo-safe. Matches the dictionary key."
          },
          "Policy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialFlowPolicy"
              }
            ],
            "description": "Policy: skipping, restart, expiry, blocking flag, feature unlocks."
          },
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialReward"
              }
            ],
            "description": "Flow completion reward."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialPresetBindings"
              }
            ],
            "description": "Preset wiring — one binding per block."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialIdentity"
              }
            ],
            "description": "Display part: name, description, order, assets, custom params."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialAvailability"
              }
            ],
            "description": "Availability: schedule, audience gate, prerequisites, event-driven auto-start."
          }
        },
        "description": "Definition of a single onboarding scenario. Only the ID lives at the root; everything else is split into blocks, each optional and each able to come wholly or partly from a preset."
      },
      "TutorialGlobalSettings": {
        "type": "object",
        "properties": {
          "Blocking": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialBlockingPolicy"
              }
            ],
            "description": "Policy for hard-blocking other modules while the tutorial is in progress. null/empty = nothing is blocked (the default for a title that never configured blocking)."
          },
          "IsEnabled": {
            "type": "boolean",
            "description": "Master switch. false = the module serves no flows and advances no progress; already started flows stay untouched in the player document."
          },
          "MaxActiveFlows": {
            "type": "integer",
            "format": "int32",
            "description": "How many flows the player may keep InProgress at once. 0 = no limit. Exceeding it fails StartFlow rather than silently closing an older flow — auto-closing would discard progress the player never agreed to lose."
          }
        },
        "description": "Module-wide tutorial settings."
      },
      "TutorialPresetBindings": {
        "type": "object",
        "properties": {
          "Steps": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Steps preset: merge by StepID, field-level overlay inside a matched step, PresetBinding.Remove drops inherited steps."
          },
          "Policy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Policy preset (field-level overlay)."
          },
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Reward preset (field-level overlay)."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Availability preset (field-level overlay)."
          }
        },
        "description": "Preset wiring container — one PresetBinding per block. Bindings are independent: take the schedule from one preset, the reward from another, and write the steps inline."
      },
      "TutorialPresetRegistry": {
        "type": "object",
        "properties": {
          "Steps": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable step sets (inner dictionary key = StepID). The preset says HOW a step closes (Completion, Script); a flow normally overrides only the copy and the order.",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "$ref": "#/definitions/TutorialStepDefinition"
              }
            }
          },
          "Policy": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable policy blocks: skipping, restart, expiry, blocking flag.",
            "additionalProperties": {
              "$ref": "#/definitions/TutorialFlowPolicy"
            }
          },
          "Reward": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable flow-completion reward blocks.",
            "additionalProperties": {
              "$ref": "#/definitions/TutorialReward"
            }
          },
          "Availability": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable availability blocks: schedule, audience gate, prerequisites, auto-start.",
            "additionalProperties": {
              "$ref": "#/definitions/TutorialAvailability"
            }
          }
        },
        "description": "Registry of reusable tutorial config blocks. Each field is a dictionary keyed by PresetID and mirrors the same-named TutorialFlowDefinition block. Direct analogue of QuestPresetRegistry."
      },
      "TutorialStepCompletion": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialStepCompletionMode"
              }
            ],
            "description": "How the step completes. Selects which fields are read: SystemEvent -> Triggers; other modes need no triggers. Default ClientAck."
          },
          "Triggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Game events that complete the step. Read only when Mode = SystemEvent. The same TriggerSource and the same TriggerMatcher used by quest objectives — so a step can wait for ANY platform event (board roll, purchase, chest open, currency spend) without a single edit in the source module. An empty list = the step never completes on its own."
          },
          "TargetValue": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "How many fires are required. Default 1. \"Roll the dice three times\" is TargetValue = 3."
          },
          "RequireAllTriggers": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether ALL triggers in the list are required (each at least once) or any one suffices. Default false = any one (the list is OR-ed, as in quests). Read only when Mode = Composite."
          }
        },
        "description": "Step completion condition."
      },
      "TutorialStepDefinition": {
        "type": "object",
        "properties": {
          "Order": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Step order within the flow (lower = earlier). Default 0. Steps sharing an order are sorted by StepID — otherwise the tutorial sequence would depend on BSON key order, which is not guaranteed."
          },
          "Policy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialStepPolicy"
              }
            ],
            "description": "Step policy: skipping, timeout."
          },
          "Script": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialScriptedOutcome"
              }
            ],
            "description": "Predetermined outcome in another module while this step is active (scripted board). null = nothing is forced and the mechanics run honestly."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Step ID (e.g. \"first_roll\"). Mongo-safe. Matches the dictionary key."
          },
          "Effects": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialStepEffects"
              }
            ],
            "description": "What happens when the step completes."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialStepIdentity"
              }
            ],
            "description": "Display part of the step: copy, UI anchor, assets."
          },
          "Completion": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialStepCompletion"
              }
            ],
            "description": "How the step is completed."
          }
        },
        "description": "Definition of a single tutorial step."
      },
      "TutorialScriptedOutcome": {
        "type": "object",
        "properties": {
          "Board": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialBoardScript"
              }
            ],
            "description": "Board script. Read when Module = GameLoop."
          },
          "Module": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialScriptModule"
              }
            ],
            "description": "Which module is forced. Currently only GameLoop (the board) is supported."
          },
          "MaxUses": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many times the script fires within the step. Default 1: the mechanic is shown, then the game is honest again. 0 = unlimited (only for a step that closes itself by TargetValue)."
          }
        },
        "description": "Predetermined outcome in another module, active while the tutorial step is current. Exists for exactly one reason: to show the player the mechanic rather than the randomness — \"the first roll lands on Raid, the second on the shop\" is otherwise impossible, since the board is honestly random and the tutorial would narrate a raid while showing an empty tile. THIS IS A SERVER-SIDE CHEAT PATH, locked behind three simultaneous conditions: the flow must be InProgress, this step must be the current one, and MaxUses must not be exhausted. Without all three, a client able to keep the tutorial open would choose its own tiles forever."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "TutorialStepCompletionMode": {
        "enum": [
          "ClientAck",
          "SystemEvent",
          "Auto",
          "Composite"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ClientAck",
          "SystemEvent",
          "Auto",
          "Composite"
        ],
        "x-enum-descriptions": [
          "The client calls Tutorial/CompleteStep itself (\"the player tapped Next\"). Default.",
          "An internal engine game event (Completion.Triggers), with no separate HTTP call: the step is closed by the very action it was asking for.",
          "Completes immediately on being shown (ReportStepShown) — an informational aside.",
          "Several triggers with an explicit all/any rule (Completion.RequireAllTriggers)."
        ]
      }
    },
    "additionalProperties": false
  }

  arguments 1834 lines copy
• get_localization unknown never probed

  GET ONLY the 'Localization' field of TitlePublicConfigurationModel. Localization SETTINGS — which locales the title offers, which one is the default (and therefore the fallback), what to render for a missing key, and the store limits. The translation TABLES are deliberately NOT here: they live in the separate TitleLocalization collection (one document per title+locale) and are delivered one file per locale, because text changes far more often than balance and must not invalidate the whole title config. Client resolution is t(x) = own table -> fallback table -> x itself, which is why a title whose DisplayName fields hold literal names keeps working unchanged: a literal is simply a key with no translation. Add or edit translations through the Localization endpoints, not through this section.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_referral unknown never probed

  GET ONLY the 'Referral' field of TitlePublicConfigurationModel. Referral / invite system configuration — invite codes, attribution rules, milestones (e.g. invite N friends → reward), per-side rewards (inviter + invitee). Reward bundles reference Reward.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_referral unknown never probed

  PARTIAL SAVE: writes ONLY the 'Referral' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Referral / invite system configuration — invite codes, attribution rules, milestones (e.g. invite N friends → reward), per-side rewards (inviter + invitee). Reward bundles reference Reward.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "ReferralDefinitions",
        "properties": {
          "IsEnabled": {
            "type": "boolean",
            "description": "Whether the referral system is enabled for this title. Disabled by default: the subsystem grants resources (activation reward, invite milestones, percent kickback to the referrer), so it must be switched on deliberately. While false, every mutating action of the module is refused; reads stay available."
          },
          "SpendRewards": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SpendRewardDefinition"
            },
            "description": "Percent-based referral kickback config per feature. Determines what percent of a follower's spend goes to the referrer. The calling API must invoke ReferralV2.ProcessSpendRewardAsync after a successful deduction."
          },
          "InviteRewards": {
            "type": [
              "null",
              "object"
            ],
            "description": "Staged rewards to the referrer for hitting follower thresholds — unified MilestoneDefinition (Core/Milestone). Key = MilestoneID. RequiredProgress is checked against UserReferralState.FollowersCount; claimed manually via ClaimInviteReward (claimed state lives in UserReferralState.InviteRewardStates, not EventToken).",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          },
          "ActivationReward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "One-time reward to the current user for the first activation of another user's referral code."
          }
        },
        "description": "Title's referral system configuration. Stored in TitlePublicConfigurationModel.ReferralDefinitions."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "SpendRewardBasis": {
        "enum": [
          "Spend",
          "Earn"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Spend",
          "Earn"
        ],
        "x-enum-descriptions": [
          "From what the follower SPENT (operation Consume). Store, marketplace, crafting.",
          "From what the follower RECEIVED (operation Grant). Rewards, lootboxes, milestones. The kickback is always minted for the referrer; nothing is taken from the follower."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "MilestoneDefinition": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base rewards. Always granted on a successful claim."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order in the UI (lower = higher/earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone images (icon, badge). null = unset.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsFeatured": {
            "type": "boolean",
            "description": "Featured milestone: special UI styling. With MilestoneClaimMode.FeaturedAfterEnd these can only be claimed after the instance ends."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI/CMS. null = unset."
          },
          "MilestoneID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique milestone ID within its owning entity (Mongo-safe, claim idempotency key)."
          },
          "BonusRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Bonus-window overlay: extra rewards on top of Rewards when the bonus phase is active at claim time (MilestoneRewardContext.BonusActive). Applied via MilestoneRewardResolver. null = no bonus part."
          },
          "RequiredProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Threshold over ACCUMULATED progress to unlock. EventToken systems: EventTokenBalanceData.TotalEarned (not current balance). CommunityChest: shared group progress."
          },
          "SeasonTierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SeasonTierRewardSet"
              }
            ],
            "description": "Season-tier overlay: reward scaling by the player's season tier. Applied via MilestoneRewardResolver (SeasonTierRewardResolver.Resolve) only when MilestoneRewardContext.SeasonChainID is set. null = disabled."
          }
        },
        "description": "Unified milestone primitive for all platform systems (TimedEvent, Leaderboard, Quest, CommunityChest, DealOffer). Replaces the per-module milestone definitions. Threshold is checked against accumulated progress (RequiredProgress): EventToken systems use EventTokenBalanceData.TotalEarned; CommunityChest uses shared group progress. Reward overlays BonusRewards (bonus-window) and SeasonTierRewards (season-tier) are platform-wide optional fields applied via MilestoneRewardResolver; leave null if unused."
      },
      "SeasonTierRewardSet": {
        "type": "object",
        "properties": {
          "Bundles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardBundle"
            },
            "description": "Structurally different rewards for specific tiers. On match, replaces the base ResourceGrant entirely (Replace)."
          },
          "Multipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardMultiplier"
            },
            "description": "Multipliers applied to Amount of the base ResourceGrant. Used ONLY if no Bundles entry matched."
          }
        },
        "description": "Generic container of season-tier reward scaling. Used by any platform system (leaderboards, lootboxes, shop, daily) that wants to scale a ResourceGrant by the player's current tier in a season chain. Empty/null lists = neutral."
      },
      "SpendRewardDefinition": {
        "type": "object",
        "properties": {
          "Rate": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Share the referrer receives: 0.05 = 5%. Empty or 0 = no kickback. The unit is the same across the whole platform — never a 0..100 percent. Calculated from the ACTUALLY applied operation, so premium discounts and tier prices are already accounted for."
          },
          "Basis": {
            "oneOf": [
              {
                "$ref": "#/definitions/SpendRewardBasis"
              }
            ],
            "description": "What to calculate the percent from: the follower's spend or their gain. Defaults to spend."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits for the REFERRER under this rule — unified LimitSpec: DailyCap (payouts per day) and DailyWeightCap (total currency per day). null = no limits. Counted per recipient, not per follower."
          },
          "IsEnabled": {
            "type": "boolean",
            "description": "Whether this rule is enabled. A disabled rule is never evaluated and never pays."
          },
          "FeatureKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Feature identifier — which follower action is paid for. Values are listed in ReferralV2.SpendFeatureKeys. An unknown key simply never matches, so the rule stays silent."
          },
          "MinSourceAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum operation amount below which no kickback is granted at all. 0 = no threshold. Filters out a stream of tiny grants from micro-spends."
          },
          "SourceCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the follower's currency the percent is calculated from. EMPTY = any virtual currency: the rule fires for each currency of the operation separately."
          },
          "TargetCurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "ID of the currency the referrer receives. EMPTY = the same currency as the source (handy together with an empty SourceCurrencyID)."
          },
          "MaxRewardPerOperation": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on the kickback for a SINGLE operation. 0 = no cap. Limits a one-off payout from a large purchase without changing the percent."
          }
        },
        "description": "A single referral kickback rule: for which follower action, from which currency, and what percent the referrer receives. Rules are independent — they can be switched on and off individually, several per feature, each with its own limits."
      },
      "SeasonTierRewardBundle": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this tier. Passed unmodified into ResourceService via a regular ResourceOperation.Grant."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this bundle to apply. Matches SeasonTierDefinition.Tier / UserSeasonState.CurrentTier."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to. Selection matches only tiers with the same SeasonChainID."
          }
        },
        "description": "Structurally different rewards for a season-chain tier. Analogous to PremiumTierBundle but the trigger is the player's season tier. Selection picks the single best match (MinSeasonTier <= playerTier); not stacked."
      },
      "SeasonTierRewardMultiplier": {
        "type": "object",
        "properties": {
          "Multiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier. 1.0 = neutral (resolver returns the base reward without copying). Rounding: (long)Math.Round(Amount * Multiplier). Entries with final Amount <= 0 are dropped."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this multiplier to apply."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to."
          }
        },
        "description": "Multiplier applied to Amount of the base ResourceGrant for a season-chain tier. Applied to every ResourceEntry.Amount and EventTokenOperation.Amount in Standard and in PremiumTiers.Resources."
      }
    },
    "additionalProperties": false
  }

  arguments 612 lines copy
• get_blockchain unknown never probed

  GET ONLY the 'Blockchain' field of TitlePublicConfigurationModel. On-chain integration config — chain selectors, smart contract addresses, RPC overrides, gas policy, supported networks for Crypto currencies. Built largely from Currency.CryptoCurrencies[].Networks; this is the title-level companion config.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_blockchain unknown never probed

  PARTIAL SAVE: writes ONLY the 'Blockchain' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. On-chain integration config — chain selectors, smart contract addresses, RPC overrides, gas policy, supported networks for Crypto currencies. Built largely from Currency.CryptoCurrencies[].Networks; this is the title-level companion config.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "BlockchainDefinitions",
        "properties": {
          "Networks": {
            "type": [
              "null",
              "object"
            ],
            "description": "Connected networks. Key is NetworkID (\"ethereum\", \"bsc\", \"polygon\", \"solana\", ...).",
            "additionalProperties": {
              "$ref": "#/definitions/BlockchainNetworkDefinition"
            }
          },
          "PlayAccess": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BlockchainPlayAccessPolicy"
              }
            ],
            "description": "Title login mode and the token balance required to play. Open = any login method, no balance check (default). AnyWithLinkedWallet = any method except guest; play only with a signature-linked wallet meeting TokenGates. WalletOnly = only wallet login; its wallet must meet TokenGates. Balance is re-checked on every session ticket issue (login and refresh)."
          },
          "SystemState": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BlockchainSystemState"
              }
            ],
            "description": "Global blockchain feature switches (on top of per-network ones)."
          },
          "WalletLogin": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BlockchainWalletLoginPolicy"
              }
            ],
            "description": "Wallet-signature login/registration — one of the login methods. Who may play and with what token balance is Blockchain.PlayAccess."
          },
          "AccountSafety": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/BlockchainAccountSafetyPolicy"
              }
            ],
            "description": "Account safety policies for crypto operations."
          },
          "IframeConnectHosts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Extra hosts (bare hostname, no scheme/path) the title's game may send network requests to (fetch/WebSocket) while embedded in an idosgames.com iframe. Requests only: framing a non-platform site inside idosgames.com is never allowed, so the game build must be hosted on the platform. Platform hosts are always allowed. Wallet-connection hosts are rejected on save."
          }
        },
        "description": "V2 definition of the title's blockchain integration. Contains only public data safe for clients (chain IDs, contracts, feature switches, safety policies). Private data lives in TitlePrivateConfiguration."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "PlayAccessMode": {
        "enum": [
          "Open",
          "AnyWithLinkedWallet",
          "WalletOnly"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Open",
          "AnyWithLinkedWallet",
          "WalletOnly"
        ]
      },
      "WalletPlayTokenGate": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether the requirement is active. False skips this gate (does not block)."
          },
          "NetworkID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Network this gate applies to (key from Blockchain.Networks)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "CurrencyID (cfg.Currency.CryptoCurrencies) whose balance is checked. Its binding for NetworkID provides ContractAddress (mint for Solana) and Decimals."
          },
          "MinBalance": {
            "type": "number",
            "format": "decimal",
            "description": "Minimum balance in whole units (e.g. 1000 = 1000 game tokens)."
          },
          "DenyMessage": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional custom denial message shown to the client (otherwise a default text is used)."
          },
          "BalanceSource": {
            "oneOf": [
              {
                "$ref": "#/definitions/WalletGateBalanceSource"
              }
            ],
            "description": "Where to read the balance compared against MinBalance: OnChain (wallet balance via RPC only), Combined (on-chain + in-game available balance InventoryV2.CryptoCurrencies[CurrencyID].Amount, excluding Frozen), InGame (in-game available balance only; no wallet, no RPC, NetworkID ignored). Default OnChain."
          }
        },
        "description": "One wallet-balance requirement for play access. Token contract and on-chain decimals are resolved from CryptoCurrencyDefinition.Networks by (CurrencyID, NetworkID), not duplicated here."
      },
      "BlockchainNetworkType": {
        "enum": [
          "EVM",
          "Solana"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "EVM",
          "Solana"
        ]
      },
      "BlockchainSystemState": {
        "type": "object",
        "properties": {
          "DepositsEnabled": {
            "type": "boolean"
          },
          "PlatformOverrides": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PlatformBlockchainState"
              }
            ]
          },
          "NftDepositsEnabled": {
            "type": "boolean"
          },
          "WithdrawalsEnabled": {
            "type": "boolean"
          },
          "NftWithdrawalsEnabled": {
            "type": "boolean"
          }
        },
        "description": "Global blockchain feature switches on top of per-network ones."
      },
      "PlatformBlockchainState": {
        "type": "object",
        "properties": {
          "Ios": {
            "type": "boolean"
          },
          "Web": {
            "type": "boolean"
          },
          "Android": {
            "type": "boolean"
          }
        }
      },
      "WalletGateBalanceSource": {
        "enum": [
          "OnChain",
          "Combined",
          "InGame"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "OnChain",
          "Combined",
          "InGame"
        ]
      },
      "BlockchainPlayAccessPolicy": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/PlayAccessMode"
              }
            ],
            "description": "Open (default): any login method, no balance check. AnyWithLinkedWallet: any method except guest; play requires a signature-linked wallet meeting TokenGates. WalletOnly: only wallet login allowed."
          },
          "TokenGates": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/WalletPlayTokenGate"
            },
            "description": "Balance requirements, all must pass. Wallet gates (OnChain/Combined) apply to the network of the player's chosen wallet; InGame gates always apply. Empty in a closed mode = no balance requirement, only the login-method restriction."
          }
        },
        "description": "Title login mode and play-access token requirements."
      },
      "BlockchainNetworkDefinition": {
        "type": "object",
        "properties": {
          "Type": {
            "$ref": "#/definitions/BlockchainNetworkType"
          },
          "RpcUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "Read-only. Public RPC URL of the network from the platform registry (when it has no ticker). Never taken from title config."
          },
          "ChainID": {
            "type": "integer",
            "format": "int32",
            "description": "EVM chain ID. 0 for Solana (not used)."
          },
          "GasPrice": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Read-only. Network gas price (EVM) from the platform registry. Never taken from title config."
          },
          "NetworkID": {
            "type": [
              "null",
              "string"
            ]
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Network assets (logos, etc.). Purpose is defined by client convention.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "ChainTicker": {
            "type": [
              "null",
              "string"
            ],
            "description": "Chain ticker (e.g. \"eth\", \"bsc\"), shown in the dashboard. The engine replaces it with the platform registry's ticker; RPC is built only from the registry."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ]
          },
          "NftCollections": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/BlockchainNftCollectionBinding"
            },
            "description": "NFT collections available for deposit/withdraw in this network. The specific ItemID is resolved through the item catalog by NftTokenID (EVM) or mint address (Solana)."
          },
          "SignatureEpoch": {
            "type": "integer",
            "format": "int64",
            "description": "Contract/program signature epoch. Must match the on-chain value (RewardPool.signatureEpoch / Config.signature_epoch) — it is bound into the signed voucher. Bumping it on-chain revokes all outstanding vouchers; update this field right after, or withdrawals stop working."
          },
          "DepositsEnabled": {
            "type": "boolean"
          },
          "NftBridgeAddress": {
            "type": [
              "null",
              "string"
            ],
            "description": "Read-only. EVM ItemBridge address (NFT deposit destination and mint-withdrawal contract), set by the engine from the platform registry. Empty falls back to RewardPoolAddress."
          },
          "PlatformOverrides": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PlatformBlockchainState"
              }
            ],
            "description": "Per-platform overrides (e.g. disable the network on iOS, keep on Android)."
          },
          "RewardPoolAddress": {
            "type": [
              "null",
              "string"
            ],
            "description": "Read-only. Platform pool contract (EVM) / Program ID (Solana), set by the engine from the platform registry. Never taken from title config."
          },
          "ChainConfigVersion": {
            "type": "integer",
            "format": "int32",
            "description": "Chain config version. Controls the withdrawal signature payload format (V2 includes UserID, V1 does not)."
          },
          "NftDepositsEnabled": {
            "type": "boolean"
          },
          "WithdrawalsEnabled": {
            "type": "boolean"
          },
          "VaultDepositAddress": {
            "type": [
              "null",
              "string"
            ],
            "description": "Solana-only: vault address for SPL deposits (if used)."
          },
          "NftWithdrawalsEnabled": {
            "type": "boolean"
          },
          "RequiredConfirmations": {
            "type": "integer",
            "format": "int32",
            "description": "Ignored: the platform sets the confirmation depth (EVM 2 blocks, Solana confirmed)."
          }
        },
        "description": "Definition of a single network. NFT collections available here are listed in NftCollections. Token contracts are bound to crypto currencies elsewhere."
      },
      "BlockchainWalletLoginPolicy": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether wallet login is enabled at all. False makes the endpoints reject the request."
          },
          "WalletConnectProjectId": {
            "type": [
              "null",
              "string"
            ],
            "description": "WalletConnect Cloud / Reown project id (dashboard.reown.com). Public value, safe to embed in the client. Enables mobile wallet login via WalletConnect (QR on desktop, deep-link on phones). Empty means only browser-extension wallets are offered and mobile login does not work. Each title provides its own id."
          }
        },
        "description": "Wallet login policy. The client requests a challenge, signs it, the server recovers the address. Token balance requirements are Blockchain.PlayAccess. Public data only."
      },
      "BlockchainAccountSafetyPolicy": {
        "type": "object",
        "properties": {
          "MinAccountAgeDays": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum account age (in days) required for withdrawal. Defense against \"register-deposit-withdraw-to-third-party\" laundering schemes."
          },
          "MultiAccountCheckEnabled": {
            "type": "boolean",
            "description": "Enable check: the same wallet address across different UserIDs results in banning both accounts."
          },
          "PendingWithdrawalTtlHours": {
            "type": "integer",
            "format": "int32",
            "description": "Pending withdrawal TTL in hours. Past the TTL the request is auto-cancelled and funds return from Frozen to Amount."
          },
          "BanOnSharedWithdrawalAddress": {
            "type": "boolean",
            "description": "Ban on attempting to withdraw to an address previously used by another account."
          }
        },
        "description": "Anti-fraud / anti-multiaccount policies for crypto operations. Applied before creating withdrawal requests; deposits are always accepted but may flag the account."
      },
      "BlockchainNftCollectionBinding": {
        "type": "object",
        "properties": {
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the collection (admin panel/logs)."
          },
          "ItemCatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog ID (cfg.Item.Catalogs[CatalogID]) the collection is bound to."
          },
          "ContractAddress": {
            "type": [
              "null",
              "string"
            ],
            "description": "NFT contract address. EVM: ERC721/ERC1155 contract address. Solana: Metaplex collection mint address or collection identifier."
          },
          "DepositsEnabled": {
            "type": "boolean",
            "description": "Whether NFTs of this collection can be deposited into the game."
          },
          "WithdrawalsEnabled": {
            "type": "boolean",
            "description": "Whether NFTs of this collection can be withdrawn from the game to a wallet."
          }
        },
        "description": "Binding of one NFT contract/collection to an item catalog. One contract = one collection."
      }
    },
    "additionalProperties": false
  }

  arguments 440 lines copy
• get_timed_boost unknown never probed

  GET ONLY the 'TimedBoost' field of TitlePublicConfigurationModel. Buff / boost definitions with a time component — temporary XP multipliers, drop-rate boosts, energy-cap boosts. Granted via Reward, Store, DealOffer, or events. Define the buff's effect and duration here; granting is done elsewhere.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_timed_boost unknown never probed

  PARTIAL SAVE: writes ONLY the 'TimedBoost' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Buff / boost definitions with a time component — temporary XP multipliers, drop-rate boosts, energy-cap boosts. Granted via Reward, Store, DealOffer, or events. Define the buff's effect and duration here; granting is done elsewhere.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "TimedBoostDefinitions",
        "properties": {
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostPresetRegistry"
              }
            ],
            "description": "Registry of reusable boost config blocks. null = presets unused. Expanded once when the config is materialized (PlatformCache.ResolveCompositeSections), so the TimedBoost module downstream merges nothing."
          },
          "Settings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostGlobalSettings"
              }
            ],
            "description": "Global subsystem settings (per-target stacking caps, etc.)."
          },
          "BoostChains": {
            "type": [
              "null",
              "object"
            ],
            "description": "Global cyclic chains of boost windows (happy-hour rotation). Key = BoostChainDefinition.ChainID. The active phase is computed deterministically from AnchorUtc. Mirrors TimedEventDefinitions.Definitions (Chained mode).",
            "additionalProperties": {
              "$ref": "#/definitions/BoostChainDefinition"
            }
          },
          "Definitions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Definitions dictionary: key = TimedBoostDefinition.BoostID. If the key is missing/null, a boost with that ID does not exist and activation will Fail.",
            "additionalProperties": {
              "$ref": "#/definitions/TimedBoostDefinition"
            }
          },
          "ScheduledBoosts": {
            "type": [
              "null",
              "object"
            ],
            "description": "Global fixed-window boosts (\"happy hour\"). Key = ScheduledBoostDefinition.ScheduledBoostID. Effect is active for all (gated) players within [StartUtc..EndUtc] and computed deterministically from config + time — no per-player state or activation. Mirrors TimedEventDefinitions.Definitions (Scheduled mode).",
            "additionalProperties": {
              "$ref": "#/definitions/ScheduledBoostDefinition"
            }
          },
          "TriggeredBoosts": {
            "type": [
              "null",
              "object"
            ],
            "description": "Triggered boosts: a per-player boost is granted for FREE when a source fires (tile landing, attack, quest, purchase, etc.). Key = TriggeredBoostDefinition.TriggeredBoostID. Granted into the existing UserDataDocument.TimedBoost.Active with SourceType = EventReward. Sources use the unified TriggerSource.",
            "additionalProperties": {
              "$ref": "#/definitions/TriggeredBoostDefinition"
            }
          }
        },
        "description": "Container for all TimedBoost definitions. Bound to cfg.TimedBoost in TitlePublicConfigurationModel. Style-aligned with other V2 definition containers (cfg.Currency, cfg.Item, cfg.Premium, ...)."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "BoostStackCap": {
        "type": "object",
        "properties": {
          "MaxAddFlat": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Max total AddFlat from boosts. null = no flat cap."
          },
          "MaxMultiply": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Max total Multiply factor from boosts (3.0 = x3). null = no multiply cap."
          },
          "MaxAddPercent": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Max total AddPercent from boosts (0.5 = +50%). null = no percent cap."
          }
        },
        "description": "Cap on the total boost contribution for a single target."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "ModifierOperation": {
        "enum": [
          "Multiply",
          "AddPercent",
          "AddFlat"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Multiply",
          "AddPercent",
          "AddFlat"
        ],
        "x-enum-descriptions": [
          "Multiply the final value. Example: x2 from an event, x1.5 from a season buff. Applied as result *= value.",
          "Percent added to the base value. Example: +50% = value 0.5 -> result += base * 0.5. All AddPercent sum BEFORE multiplication (additive stacking).",
          "Fixed amount added to the base value (before multiplications). Example: +5 spins, +100 coins."
        ]
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "EventModifierTarget": {
        "enum": [
          "BoardAttackReward",
          "BoardRaidReward",
          "BoardPassStartReward",
          "BoardBuildCost",
          "BoardBuildReward",
          "BoardTileLandingReward",
          "BoardRollSteps",
          "QuestReward",
          "AllReward",
          "AllCost",
          "Custom"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardAttackReward",
          "BoardRaidReward",
          "BoardPassStartReward",
          "BoardBuildCost",
          "BoardBuildReward",
          "BoardTileLandingReward",
          "BoardRollSteps",
          "QuestReward",
          "AllReward",
          "AllCost",
          "Custom"
        ],
        "x-enum-descriptions": [
          "Multiplier on board attack rewards.",
          "Multiplier on board raid rewards.",
          "Multiplier on rewards for passing start (GO) on the board.",
          "Multiplier on the cost of building or repairing a structure.",
          "Multiplier on rewards for completing a build/stage.",
          "Multiplier on rewards for landing on a tile.",
          "Multiplier on roll steps (more steps = move further).",
          "Multiplier on quest completion rewards.",
          "Generic \"any reward\" target: a modifier with this target applies at ALL reward calculation points regardless of the specific board target. Enables a single global \"+200% earnings\" boost. Boosts targeting AllReward are added on top of any reward target.",
          "Generic \"any cost\" target: symmetric to AllReward but for cost calculations (build/repair cost, etc.). Applied at all cost calculation points.",
          "Arbitrary modifier — the developer defines the semantics. Used together with CustomParams."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "TimedBoostEffectSet": {
        "type": "object",
        "properties": {
          "Effects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TimedBoostEffectSpec"
            },
            "description": "Effects of the set."
          }
        },
        "description": "Reusable set of effects — payload of the Effects block preset."
      },
      "BoostChainDefinition": {
        "type": "object",
        "properties": {
          "Phases": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ChainedBoostDefinition"
            },
            "description": "Ordered list of chain window-phases."
          },
          "ChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stable chain ID. Key in cfg.TimedBoost.BoostChains."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostPresetBindings"
              }
            ],
            "description": "Preset wiring (Availability). null = presets unused."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset path map by keys.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Chain description for UI."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Chain display name for UI."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostAvailability"
              }
            ],
            "description": "Chain availability: schedule (Mode = Chained; anchor, pauses, MaxCycles and Schedule.IsActive live in Schedule.Chain) plus audience gate. Read via TimedBoostDefinitionDefaults."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary developer-defined parameters for the entire chain.",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        "description": "Global cyclic chain of boost window-phases (happy-hour rotation). Mirrors TimedEventDefinition (Chained). Phase dates are computed from AnchorUtc, per-phase durations and pauses. At most one phase is active at a time (or none — during a pause / after cycles are exhausted)."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "TimedBoostDefinition": {
        "type": "object",
        "properties": {
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "UI tags for interface grouping (\"economy\", \"pvp\", \"tournament\", ...). Does not affect server logic."
          },
          "Effect": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostEffectSpec"
              }
            ],
            "description": "Effect specification: what is affected, how, and by how much."
          },
          "BoostID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stable ID. Matches the key in cfg.TimedBoost.Definitions. Stored in ActiveTimedBoost.BoostID for back-reference."
          },
          "Charges": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Optional \"works for N actions\" limit. When set, the boost consumes 1 charge per application; once RemainingCharges <= 0 the boost becomes inactive regardless of timer. null = no charges, timer-only."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset path map by keys — icons, banners, backgrounds, animations and any other visual/audio resources for UI. Typical keys: \"icon\", \"banner\", \"thumbnail\", \"effect_anim\", \"sound\". null or empty is valid.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description for UI / tooltip."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localized name for UI."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Ways to pay. Dictionary key = PriceOption.OptionID; the player picks one. Empty/null = free.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "StackingPolicy": {
            "oneOf": [
              {
                "$ref": "#/definitions/TimedBoostStackingPolicy"
              }
            ],
            "description": "Behavior on re-activating the same BoostID. See TimedBoostStackingPolicy for per-variant details."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Boost lifetime in seconds from activation. ActiveTimedBoost.ExpiresAtUtc = ActivatedAtUtc + DurationSeconds. Must be > 0 (validated by the Activate HTTP endpoint)."
          },
          "MaxActiveInstances": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Optional cap on the number of simultaneously active instances of the same BoostID in UserTimedBoostsState.Active. Relevant only for Stack policy; ignored otherwise. null = no cap."
          }
        },
        "description": "Definition of a single boost — the static part stored in cfg.TimedBoost.Definitions[BoostID]. Describes what is consumed on activation, which effect is applied, how long it lives and how it behaves on re-activation."
      },
      "TimedBoostEffectSpec": {
        "type": "object",
        "properties": {
          "Value": {
            "type": "number",
            "format": "double",
            "description": "Effect magnitude. Semantics by Operation: AddFlat: +5 = 5.0; AddPercent: +50% = 0.5, -30% = -0.3; Multiply: x2 = 2.0, x0.5 = 0.5. Clamped only inside ModifierService."
          },
          "Target": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventModifierTarget"
              }
            ],
            "description": "What the boost affects. Matches EventModifierTarget — the same target used by season buffs and event modifiers. Only ActiveTimedBoost entries whose EffectSnapshot.Target equals this target enter the context."
          },
          "Operation": {
            "oneOf": [
              {
                "$ref": "#/definitions/ModifierOperation"
              }
            ],
            "description": "Arithmetic operation type used in the calculation. AddFlat — add to base before multiplies. AddPercent — additive percent (all AddPercent in context sum before multiply). Multiply — multiplicative chain."
          }
        },
        "description": "Effect specification of a single boost: what is affected, how, and by how much. Semantically identical to ModifierEntry so ActiveTimedBoost can be converted into ModifierEntry without translation."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "ChainedBoostDefinition": {
        "type": "object",
        "properties": {
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Position in the chain (0, 1, 2...)."
          },
          "Effects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TimedBoostEffectSpec"
            },
            "description": "Effects active while this phase runs. See ScheduledBoostDefinition.Effects."
          },
          "DurationSec": {
            "type": "integer",
            "format": "int64",
            "description": "Phase duration in seconds. Must be > 0."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary developer-defined parameters for this phase.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "ChainedBoostID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Phase ID within the chain. Unique within the chain."
          }
        },
        "description": "A single window-phase inside a BoostChainDefinition. Dates are not set manually — computed from AnchorUtc plus the DurationSec of preceding phases. Mirrors ChainedEventDefinition."
      },
      "TimedBoostAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who the window applies to. null/empty = everyone."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Window schedule. null = no window (the boost is never active on its own)."
          }
        },
        "description": "Availability block of a boost window: schedule plus audience gate. Direct analogue of QuestAvailability. All fields are nullable and have no initializers — required by preset merging. Read only via TimedBoostDefinitionDefaults."
      },
      "ScheduledBoostDefinition": {
        "type": "object",
        "properties": {
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "UI tags for grouping."
          },
          "Effects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TimedBoostEffectSpec"
            },
            "description": "List of window effects. Multiple are allowed (e.g. \"+50% cash AND -20% build cost\" in one window) — hence a list. Each TimedBoostEffectSpec has the same semantics as a manual boost, but no snapshot is taken. No field initializer on purpose: \"unset\" must differ from \"set to empty\" for preset merging."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostPresetBindings"
              }
            ],
            "description": "Preset wiring (Availability / Effects). null = presets unused."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset path map by keys (icon/banner/...). See the same field on TimedBoostDefinition.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description for UI / tooltip."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localized name for UI."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostAvailability"
              }
            ],
            "description": "Window availability: schedule (Mode = Scheduled) plus audience gate. The block and its fields are nullable — required by preset merging. Read via TimedBoostDefinitionDefaults."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary developer-defined key/value parameters.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "ScheduledBoostID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stable window ID. Key in cfg.TimedBoost.ScheduledBoosts."
          }
        },
        "description": "Global fixed-window boost with concrete dates — a \"happy hour\". Mirrors TimedEventDefinition (Scheduled). While StartUtc <= now <= EndUtc and IsActive is true, the listed Effects apply to reward/cost calculations for all players who pass the Gate. No per-player state or activation."
      },
      "TimedBoostGlobalSettings": {
        "type": "object",
        "properties": {
          "StackingCaps": {
            "type": [
              "null",
              "object"
            ],
            "description": "Cap on the total boost contribution per EventModifierTarget. Key = target. Applied when assembling modifiers, BEFORE ModifierService.Apply, so overlapping windows + activations + triggers cannot produce an extreme multiplier. null/empty = no cap (only ModifierService default clamps remain).",
            "x-dictionaryKey": {
              "$ref": "#/definitions/EventModifierTarget"
            },
            "additionalProperties": {
              "$ref": "#/definitions/BoostStackCap"
            }
          }
        },
        "description": "Global settings of the TimedBoost subsystem. Stored in cfg.TimedBoost.Settings."
      },
      "TimedBoostPresetBindings": {
        "type": "object",
        "properties": {
          "Effects": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset binding for the Effects block."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset binding for the Availability block."
          }
        },
        "description": "Container of preset wiring — one PresetBinding per block. Inline data lives on the definition itself. null = presets unused."
      },
      "TimedBoostPresetRegistry": {
        "type": "object",
        "properties": {
          "Effects": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable effect sets, keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/TimedBoostEffectSet"
            }
          },
          "Availability": {
            "type": [
              "null",
              "object"
            ],
            "description": "Reusable availability blocks (schedule + gate), keyed by PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/TimedBoostAvailability"
            }
          }
        },
        "description": "Registry of reusable boost config blocks. Each field is a dictionary keyed by PresetID and mirrors the same-named definition block. Analogue of QuestPresetRegistry."
      },
      "TimedBoostStackingPolicy": {
        "enum": [
          "Replace",
          "Refresh",
          "KeepBest",
          "Stack"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Replace",
          "Refresh",
          "KeepBest",
          "Stack"
        ],
        "x-enum-descriptions": [
          "All active instances with the same BoostID are removed and a new instance is added with a fresh ExpiresAtUtc. Guarantees one active boost of this type.",
          "The existing active instance is extended: ExpiresAtUtc is shifted from now by the new duration (not added to remaining); RemainingCharges is added to the remaining. If none active — behaves like Replace.",
          "Activates only if the new instance is \"better\" than the existing one (longer TTL or higher absolute Value). If not better — activation succeeds (item consumed) but no new ActiveTimedBoost is created.",
          "Each activation creates a NEW ActiveTimedBoost with its own InstanceID. Multiple instances of the same BoostID are allowed. Effects stack at ModifierService level. Capped by MaxActiveInstances if set."
        ]
      },
      "TriggeredBoostDefinition": {
        "type": "object",
        "properties": {
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "UI tags for grouping."
          },
          "Charges": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Optional \"works for N applications\" limit. null = timer-only."
          },
          "Effects": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TimedBoostEffectSpec"
            },
            "description": "Effects of the granted boost. N effects -> N ActiveTimedBoost instances."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostPresetBindings"
              }
            ],
            "description": "Preset wiring (Availability / Effects). null = presets unused."
          },
          "Sources": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Grant triggers. A match with ANY source in the list (after its filters) is enough. See the unified TriggerSource."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Asset path map by keys.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localized name for UI."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TimedBoostAvailability"
              }
            ],
            "description": "Who the trigger is available to. null/empty = everyone."
          },
          "StackingPolicy": {
            "oneOf": [
              {
                "$ref": "#/definitions/TimedBoostStackingPolicy"
              }
            ],
            "description": "Stacking policy when the same TriggeredBoostID is granted again."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Lifetime of the granted boost (seconds). ExpiresAtUtc = grantTime + DurationSeconds. 0 is allowed if Charges is set (charge-only boost)."
          },
          "TriggeredBoostID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stable ID. Key in cfg.TimedBoost.TriggeredBoosts. Stored in ActiveTimedBoost.BoostID."
          },
          "MaxActiveInstances": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Cap on simultaneous instances (only for Stack policy). null = no cap."
          }
        },
        "description": "Triggered boost: when one of the Sources fires, the player is granted a per-player ActiveTimedBoost for FREE (like manual activation but without ActivationCost), with SourceType = EventReward. If Effects has N entries, N instances are created (one snapshot per ActiveTimedBoost). Sources use the unified TriggerSource."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      }
    },
    "additionalProperties": false
  }

  arguments 1767 lines copy
• get_experiment unknown never probed

  GET ONLY the 'Experiment' field of TitlePublicConfigurationModel. A/B experiments — variant definitions with weighted allocation, audience gate (SegmentGate) and schedule (ScheduleSpec). Players are assigned to a variant by a stable hash; variant Params carry inline config overrides. Used to test config changes against measurable cohorts.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_experiment unknown never probed

  PARTIAL SAVE: writes ONLY the 'Experiment' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. A/B experiments — variant definitions with weighted allocation, audience gate (SegmentGate) and schedule (ScheduleSpec). Players are assigned to a variant by a stable hash; variant Params carry inline config overrides. Used to test config changes against measurable cohorts.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "ExperimentDefinitions",
        "properties": {
          "Experiments": {
            "type": [
              "null",
              "object"
            ],
            "description": "Experiments by ID.",
            "additionalProperties": {
              "$ref": "#/definitions/ExperimentDefinition"
            }
          }
        },
        "description": "Root block of the A/B experiment system. An experiment = who (Gate: SegmentGate) + when (Schedule: ScheduleSpec) + a random sticky split into variants. Variant assignment is deterministic by a STABLE hash (ExperimentAssigner), NOT SecureRandom, so it is reproducible and stable across sessions. Consumed as a SegmentGate.Experiment condition, so A/B works in every module already using SegmentGate."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "ExperimentGoal": {
        "type": "object",
        "properties": {
          "Kind": {
            "type": [
              "null",
              "string"
            ],
            "description": "Metric kind: EventConversion | EventCountPerUser | EventValuePerUser | RetentionD1 | RetentionD7 | PayerConversion | Arpu."
          },
          "MetricID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Metric ID within the experiment (mongo-safe)."
          },
          "EventName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Custom event name — for the Event* kinds."
          },
          "IsPrimary": {
            "type": "boolean",
            "description": "Primary goal: the experiment's overall verdict is based on it. One per experiment."
          }
        },
        "description": "Experiment goal — a single report metric."
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "ExperimentVariant": {
        "type": "object",
        "properties": {
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Variant params — a simple way to carry inline overrides (e.g. {\"discount\":\"20\"}) without separate gated entities per variant.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Weight": {
            "type": "integer",
            "format": "int32",
            "description": "Relative allocation weight. 0 = not allocated. E.g. 50/50 -> [50,50]; 90/10 -> [90,10]."
          },
          "IsControl": {
            "type": "boolean",
            "description": "Control (baseline) variant. Flagged for analytics and as the default behavior."
          },
          "VariantID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Variant ID (mongo-safe): e.g. \"control\", \"A\", \"B\". Unique within the experiment."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for admin/analytics."
          }
        },
        "description": "Experiment variant (an A/B/C arm, incl. control)."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "ExperimentDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who participates (population) — unified SegmentGate (tier/level/country/segment/recency). null/empty = everyone. Assignment happens ONLY for players passing the gate."
          },
          "Salt": {
            "type": [
              "null",
              "string"
            ],
            "description": "Assignment hash salt. Changing it RE-RANDOMIZES the split (a new experiment iteration): stored assignments with a different salt are reassigned. Empty = no salt."
          },
          "Goals": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ExperimentGoal"
            },
            "description": "Goals — metrics the dashboard report judges the experiment by. Kinds: EventConversion (share of participants who sent EventName at least once), EventCountPerUser, EventValuePerUser (mean sum of the event's Value — revenue, score), RetentionD1, RetentionD7, PayerConversion, Arpu. Exactly one goal may be IsPrimary: the overall verdict is based on it."
          },
          "LayerID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Mutual-exclusion layer. Experiments sharing a LayerID are mutually exclusive: a player lands in at most one (so overlap does not distort metrics). null = standalone. Exclusion is enforced at the assignment step."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "When the experiment is active — unified ScheduleSpec (usually a Scheduled window or AlwaysOn). Outside the active window no assignment happens (control behavior)."
          },
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ExperimentVariant"
            },
            "description": "Experiment variants (incl. control). A player's share = Weight relative to the sum of weights. Variants with Weight = 0 are not allocated (paused)."
          },
          "IsEnabled": {
            "type": "boolean",
            "description": "Master switch. false = experiment is not assigned (everyone gets control/baseline)."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Hypothesis description."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for admin/analytics."
          },
          "CustomParams": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arbitrary experiment-level parameters (for analytics/custom logic).",
            "additionalProperties": {
              "type": "string"
            }
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID (mongo-safe, no '.' or '$') — used as the assignment key and in the stable hash."
          },
          "ActivationEvent": {
            "type": [
              "null",
              "string"
            ],
            "description": "Activation event (like Firebase's): a player counts as a participant in the report only after sending this custom event. Empty = participant from assignment. Report filter only — does not affect assignment or gating."
          },
          "RolloutVariantID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Rolled-out winner. When set (to an existing VariantID) the experiment is finished: no new assignments, and every player's variant gate resolves to this variant, including never-assigned players. Stored assignments are kept for the report."
          },
          "StickyAssignment": {
            "type": "boolean",
            "description": "true — assignment is frozen on first exposure (stored in UserExperimentState; survives later weight changes). false — purely deterministic (weight changes may re-split). Salt overrides both (always reassigns)."
          }
        },
        "description": "Single A/B experiment definition."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      }
    },
    "additionalProperties": false
  }

  arguments 875 lines copy
• get_advertising unknown never probed

  GET ONLY the 'Advertising' field of TitlePublicConfigurationModel. Advertising — logical ad Placements (rewarded video, interstitial, banner, app-open), the mediation Providers that serve them (AppLovin MAX, LevelPlay, ...) with per-platform app IDs and ad unit IDs, per-format settings, frequency capping, premium ad-removal perks, GDPR/ATT consent policy, rewarded-video server-side verification (SSV) and the daily revenue import from the provider's Reporting API. Shared secrets (SSV keys, report keys) are NOT stored here — only the NAME of the TitleSecrets entry that holds them.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_chat unknown never probed

  GET ONLY the 'Chat' field of TitlePublicConfigurationModel. Player chat - the catalog of persistent CHANNELS the title offers (world / announcement / group), plus direct-message settings, moderation rules and polling economics. A channel declares who SEES it (SegmentGate + ScheduleSpec) and who may WRITE to it (a second gate plus LimitSpec anti-spam: slow mode, daily cap); an announcement channel is simply one nobody passes the write gate of. A channel may be PARTITIONED by the player's language or country and sharded by capacity - the partition key is computed by the SERVER (language is validated against this title's Localization locales, country comes from IP), so the set of rooms is bounded by config and never by client input. Type=Group is the extension point for clans: membership comes from an external provider named in GroupSource, and no provider exists yet, so such a channel is currently hidden rather than shown empty. Messages themselves are NOT here - they live in the ChatMessages collection and expire by Retention.HistoryHours; only the hot tail is cached in Redis. Muting a player and reviewing reports are admin actions, not config.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_chat unknown never probed

  PARTIAL SAVE: writes ONLY the 'Chat' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Player chat - the catalog of persistent CHANNELS the title offers (world / announcement / group), plus direct-message settings, moderation rules and polling economics. A channel declares who SEES it (SegmentGate + ScheduleSpec) and who may WRITE to it (a second gate plus LimitSpec anti-spam: slow mode, daily cap); an announcement channel is simply one nobody passes the write gate of. A channel may be PARTITIONED by the player's language or country and sharded by capacity - the partition key is computed by the SERVER (language is validated against this title's Localization locales, country comes from IP), so the set of rooms is bounded by config and never by client input. Type=Group is the extension point for clans: membership comes from an external provider named in GroupSource, and no provider exists yet, so such a channel is currently hidden rather than shown empty. Messages themselves are NOT here - they live in the ChatMessages collection and expire by Retention.HistoryHours; only the hot tail is cached in Redis. Muting a player and reviewing reports are admin actions, not config.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "ChatDefinitions",
        "properties": {
          "Direct": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DirectMessageSettings"
              }
            ],
            "description": "Direct (1-on-1) message settings. Not set = direct messages are unavailable."
          },
          "Polling": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatPollingSettings"
              }
            ],
            "description": "Polling economics: how often the client may poll and how much a single poll returns. The client MUST take the interval from here - every poll counts against the title's API quota."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatPresetRegistry"
              }
            ],
            "description": "Preset registry: shared blocks referenced by channels through their Presets bindings. null = presets unused."
          },
          "Channels": {
            "type": [
              "null",
              "object"
            ],
            "description": "Catalog of the title's persistent channels, key = ChannelID (e.g. \"world\", \"trade\", \"news\", \"clan\"). Direct 1-on-1 messages are NOT here - they have their own Direct block.",
            "additionalProperties": {
              "$ref": "#/definitions/ChatChannelDefinition"
            }
          },
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Master switch for the chat module. Not set = enabled (a missing section means 'not configured', not 'disabled')."
          },
          "Moderation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatModerationSettings"
              }
            ],
            "description": "Moderation rules shared by every channel: the word blocklist, the per-player ignore list and player reports."
          }
        },
        "description": "Configuration of the title's player chat: the catalog of persistent channels (world/announcement/group), direct-message settings, moderation rules and polling economics. Channels are addressed by ChannelID; a channel may be partitioned by the player's language or country and sharded by capacity, and the partition key is computed by the SERVER, never sent by the client. Messages themselves are not here - they live in the ChatMessages collection."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ChatChannelType": {
        "enum": [
          "Global",
          "Announcement",
          "Group"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Global",
          "Announcement",
          "Group"
        ],
        "x-enum-descriptions": [
          "Title-wide channel: anyone passing the write gate may post.",
          "Publisher announcements: players read only. The publisher posts through the admin path, not through a player action.",
          "Group channel: the roster comes from the external provider named in GroupSource. This is the extension point for clans."
        ]
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "ChatPartitioning": {
        "enum": [
          "None",
          "Language",
          "Region"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "None",
          "Language",
          "Region"
        ],
        "x-enum-descriptions": [
          "Not split: one room per title (plus capacity shards).",
          "By the player's language (locale from the Localization module).",
          "By the player's country (resolved from IP on the server)."
        ]
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "ChatDirectAudience": {
        "enum": [
          "Anyone",
          "Friends"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Anyone",
          "Friends"
        ],
        "x-enum-descriptions": [
          "Anyone.",
          "Friends only - an accepted edge in the Social graph."
        ]
      },
      "ChatPresetRegistry": {
        "type": "object",
        "properties": {
          "Write": {
            "type": [
              "null",
              "object"
            ],
            "description": "Write-rule presets, key = PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/ChatChannelWriteRules"
            }
          },
          "Retention": {
            "type": [
              "null",
              "object"
            ],
            "description": "Retention presets, key = PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/ChatChannelRetention"
            }
          },
          "Availability": {
            "type": [
              "null",
              "object"
            ],
            "description": "Availability presets, key = PresetID.",
            "additionalProperties": {
              "$ref": "#/definitions/ChatChannelAvailability"
            }
          }
        },
        "description": "Chat preset registry: shared blocks reused across channels."
      },
      "ChatChannelIdentity": {
        "type": "object",
        "properties": {
          "IconPath": {
            "type": [
              "null",
              "string"
            ],
            "description": "Path to the channel icon in the client atlas."
          },
          "SortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Sort order in the channel list, lower = higher. Not set = 0."
          },
          "DisplayNameKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization KEY of the channel name (not a literal). Client resolution is 'own table -> fallback table -> the key itself', so a literal still renders - but a title written with literals cannot be translated."
          },
          "JoinedByDefault": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the channel is open to the player by default. Not set = true (a channel that passed the visibility gate is visible without an explicit join). false = the player must call JoinChannel."
          }
        },
        "description": "Channel presentation."
      },
      "ChatPollingSettings": {
        "type": "object",
        "properties": {
          "MaxHistoryPageSize": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Cap on a history page. Not set = 50."
          },
          "MaxMessagesPerPoll": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Cap on messages returned by one poll, across all channels combined. Not set = 100."
          },
          "MinIntervalSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Recommended and minimum poll interval in seconds. Not set = 5. The client must honour it; the server rate-limits on top of it anyway."
          }
        },
        "description": "Polling economics. Every poll counts against the publisher's API quota, so the interval comes FROM THE SERVER rather than being hard-coded in the client: 1000 players online at a 1-second interval is 1000 requests per second. The client must also poll only while the chat screen is open - a closed chat updates its badge from the ordinary state response."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "ChatChannelRetention": {
        "type": "object",
        "properties": {
          "HotTailSize": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Depth of the hot tail kept in Redis (messages). This is how much catch-up a returning player gets in one poll, and the range over which the unread badge is counted. Not set = 200."
          },
          "HistoryHours": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Durable history window in hours (collection TTL). Not set = 72. 0 means 'keep nothing beyond the hot tail' and leaves GetHistory empty."
          }
        },
        "description": "Message retention for a channel."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "ChatBlockedTermAction": {
        "enum": [
          "Reject",
          "Mask"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Reject",
          "Mask"
        ],
        "x-enum-descriptions": [
          "Reject the whole message.",
          "Mask the term with asterisks and let the message through."
        ]
      },
      "ChatChannelDefinition": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatChannelType"
              }
            ],
            "description": "Channel type: Global (anyone who passes the gate), Announcement (publisher writes, players only read), Group (membership resolved by an external provider named in GroupSource, e.g. a clan)."
          },
          "Write": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatChannelWriteRules"
              }
            ],
            "description": "Who WRITES to the channel and under which limits. A channel whose Write gate nobody passes is readable but silent - that is how a read-only channel is expressed."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatChannelPresetBindings"
              }
            ],
            "description": "Preset wiring: one binding per preset-able block (Availability / Write / Retention)."
          },
          "Capacity": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Member cap of a single room. 0 / not set = no sharding, one room. Above the cap the next shard of the same partition is opened."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatChannelIdentity"
              }
            ],
            "description": "Presentation: what the channel is called and how it looks in the client."
          },
          "ChannelID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Channel identifier. May be omitted in config - the resolver fills it in from the dictionary key."
          },
          "Retention": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatChannelRetention"
              }
            ],
            "description": "How long the channel's messages live: the hot tail depth kept in Redis and the durable history window in MongoDB."
          },
          "GroupSource": {
            "type": [
              "null",
              "string"
            ],
            "description": "Membership provider name for a Group channel (e.g. \"Clan\"). No providers are registered in the engine today: a Group channel answers 'not a member' until the module that owns the roster is built."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatChannelAvailability"
              }
            ],
            "description": "Who SEES the channel: audience gate plus an optional schedule."
          },
          "Partitioning": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatPartitioning"
              }
            ],
            "description": "How the channel is split into rooms. The partition key is computed by the SERVER from the player's locale and IP country - the client never chooses it, otherwise it would forge it."
          }
        },
        "description": "One persistent chat channel. Type decides who may write and where membership comes from; Partitioning and Capacity decide how the channel is split into the room the player is actually placed into."
      },
      "ChatChannelWriteRules": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Gate for the right to write. null = anyone who sees the channel may write. An announcement channel is expressed as a gate nobody passes."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-spam: cooldown between messages (slow mode), daily cap, sliding window. Counters are written ALWAYS, even when no limit is set, so enabling a limit later works on live players immediately."
          },
          "MaxLength": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum message length in characters. Not set = 500."
          }
        },
        "description": "Write rules for a channel."
      },
      "DirectMessageSettings": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Gate for the right to use direct messages at all. null = allowed for everyone."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-spam limits for direct messages, same model as channels."
          },
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether direct messages are enabled. Not set = false - this is opt-in."
          },
          "MaxLength": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum message length in characters. Not set = 500."
          },
          "HistoryHours": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Direct history window in hours. Not set = 720 (30 days) - deliberately much longer than a world channel: a lost direct message is a real loss, a lost world line is not."
          },
          "WhoCanMessage": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatDirectAudience"
              }
            ],
            "description": "Who may open a conversation: Anyone, or Friends only (an accepted edge in the Social graph). Not set = Anyone."
          },
          "MaxConversations": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Cap on the number of conversations one player may keep. Not set = 100. 0 = no cap."
          }
        },
        "description": "Direct (1-on-1) message settings. A direct channel is never declared in the catalog - its address is derived from the pair of participants, so all direct channels share these settings."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "ChatModerationSettings": {
        "type": "object",
        "properties": {
          "BlockedTerms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Blocklist of forbidden words/substrings (case-insensitive). The server normalizes the text before matching - strips diacritics, collapses repeats and separators, folds simple leet-speak - so spaced-out and homoglyph spellings are caught by the same list. Empty = no blocklist."
          },
          "ReportLimits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-spam for reports: cooldown and daily cap per reporting player."
          },
          "ReportsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether players may report messages. Not set = true."
          },
          "BlockedTermAction": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ChatBlockedTermAction"
              }
            ],
            "description": "What to do with a message containing a blocked term: Reject it outright, or Mask the term with asterisks and let the message through. Not set = Reject."
          },
          "MaxIgnoreListSize": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Cap on a player's personal ignore list. Not set = 200. 0 = the ignore list is disabled."
          }
        },
        "description": "Moderation rules shared by all channels and direct messages."
      },
      "ChatChannelAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate (level, country, premium tier, account age, A/B variant). null = everyone sees it."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Schedule during which the channel exists. null = always."
          }
        },
        "description": "Channel visibility."
      },
      "ChatChannelPresetBindings": {
        "type": "object",
        "properties": {
          "Write": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Write block."
          },
          "Retention": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Retention block."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Availability block."
          }
        },
        "description": "Preset wiring of a channel: one PresetBinding per preset-able block."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      }
    },
    "additionalProperties": false
  }

  arguments 1288 lines copy
• get_community_marketing unknown never probed

  GET ONLY the 'CommunityMarketing' field of TitlePublicConfigurationModel. Community Marketing - the program that rewards community members for posting about the game on external social platforms (YouTube/TikTok/Instagram). A campaign declares WHO may take part (Participation + SegmentGate), WHEN it runs (ScheduleSpec), WHICH platforms count and at what weight, WHAT the post must contain (hashtags, mention, the creator verification code), and HOW it pays: RateCards give a linear rate per metric (e.g. 60 GOLD per 1000 views, optionally multiplied by a per-submission moderator coefficient), while Milestones give threshold rewards using the shared platform milestone primitive. Spending is bounded by a campaign Budget plus per-submission, per-creator and per-team Caps - all evaluated against what has been PAID, never what has been earned. Providers says where the view/like/comment/share numbers come from per platform (the title's own API key or aggregator key, addressed BY NAME in TitleSecrets - never the value itself), Moderation says what a human reviews, and AntiFraud sets the hold period before earnings mature plus the anomaly thresholds that freeze a suspicious submission. Creators, submissions, metric snapshots, accruals and the payout journal are NOT here - they are operational data in their own collections. The Community Marketing pool bucket is funded by a fee on player crypto withdrawals, configured in the Currency section (CryptoCurrencyDefinition.CommunityMarketingWithdrawalFeePercent), not here.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_community_marketing unknown never probed

  PARTIAL SAVE: writes ONLY the 'CommunityMarketing' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Community Marketing - the program that rewards community members for posting about the game on external social platforms (YouTube/TikTok/Instagram). A campaign declares WHO may take part (Participation + SegmentGate), WHEN it runs (ScheduleSpec), WHICH platforms count and at what weight, WHAT the post must contain (hashtags, mention, the creator verification code), and HOW it pays: RateCards give a linear rate per metric (e.g. 60 GOLD per 1000 views, optionally multiplied by a per-submission moderator coefficient), while Milestones give threshold rewards using the shared platform milestone primitive. Spending is bounded by a campaign Budget plus per-submission, per-creator and per-team Caps - all evaluated against what has been PAID, never what has been earned. Providers says where the view/like/comment/share numbers come from per platform (the title's own API key or aggregator key, addressed BY NAME in TitleSecrets - never the value itself), Moderation says what a human reviews, and AntiFraud sets the hold period before earnings mature plus the anomaly thresholds that freeze a suspicious submission. Creators, submissions, metric snapshots, accruals and the payout journal are NOT here - they are operational data in their own collections. The Community Marketing pool bucket is funded by a fee on player crypto withdrawals, configured in the Currency section (CryptoCurrencyDefinition.CommunityMarketingWithdrawalFeePercent), not here.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "CommunityMarketingDefinitions",
        "properties": {
          "Teams": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityTeamSettings"
              }
            ],
            "description": "Creator teams: whether they are enabled and how a team-level reward is divided among members."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityMarketingPresetRegistry"
              }
            ],
            "description": "Preset registry: shared blocks referenced by campaigns through their Presets bindings. null = presets unused."
          },
          "Showcase": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityShowcaseSettings"
              }
            ],
            "description": "Public showcase of the program on the game's public page (idosgames.com/app/{id}): which parts everyone can see - rules, fund, creators' works with their metrics and rewards, likes and comments. Not set = the showcase is shown for an enabled program, works are approved-only."
          },
          "AntiFraud": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityAntiFraudSettings"
              }
            ],
            "description": "Anti-fraud policy: the hold period before earnings mature, the anomaly thresholds that freeze accrual, and the clawback rules."
          },
          "Campaigns": {
            "type": [
              "null",
              "object"
            ],
            "description": "Catalog of the title's campaigns, key = CampaignID. A title may run several campaigns at once (e.g. a launch push and an always-on program), each with its own rules and its own budget.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityCampaignDefinition"
            }
          },
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Master switch for the Community Marketing module. Not set = DISABLED (unlike Chat/Tutorial): the program hands real value to people outside the game, so a title that never configured it must not discover it running. Same reasoning as Referral."
          },
          "Providers": {
            "type": [
              "null",
              "object"
            ],
            "description": "Where the numbers come from, per social platform. Key = the CommunitySocialPlatform name (e.g. \"YouTube\", \"TikTok\", \"Instagram\"). A platform with no entry is treated as disabled.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityProviderSettings"
            }
          },
          "Moderation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityModerationSettings"
              }
            ],
            "description": "Submission moderation policy: what a human reviews and what passes automatically."
          },
          "Participation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityParticipationSettings"
              }
            ],
            "description": "Who may join the program and how (open enrolment vs. application, requirements on the creator)."
          }
        },
        "description": "Configuration of the title's Community Marketing program: campaigns that reward community members for posting about the game on external social platforms (YouTube/TikTok/Instagram), the payout rules (per-metric rate cards and milestone thresholds), budgets and caps, the moderation policy, the anti-fraud policy and where the view/like/comment/share numbers are pulled from. Submissions, metric snapshots, accruals and the payout journal are NOT here - they are operational data in their own collections. The Community Marketing pool is funded by a fee on player crypto withdrawals, configured in the Currency section (CryptoCurrencyDefinition.CommunityMarketingWithdrawalFeePercent), not here."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "CommunityCaps": {
        "type": "object",
        "properties": {
          "CrossPost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityCrossPostMode"
              }
            ],
            "description": "How a copy of the same video posted on another platform (cross-post) is paid. Not set = PayEach. A copy is declared by the creator on submission or marked by the publisher in moderation; the platform does not detect copies by itself."
          },
          "PeriodDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Length of the period for the per-period caps, in days. Not set = 30. The window is rolling: counted backwards from now."
          },
          "PerSubmission": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Maximum payout for a single submission. Not set or 0 = uncapped. This is the primary safety valve: one viral clip must not consume the whole fund overnight."
          },
          "PerTeamPerPeriod": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Maximum payout to one team per period. Not set or 0 = uncapped."
          },
          "PerCreatorPerPeriod": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Maximum payout to one creator per period. Not set or 0 = uncapped."
          },
          "MaxSubmissionsPerCreatorPerPeriod": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many submissions one creator may enter into this campaign per period. Not set or 0 = unlimited."
          }
        },
        "description": "Spending caps. All caps are evaluated against PAID amounts, never earned ones."
      },
      "PresetBinding": {
        "type": "object",
        "properties": {
          "Remove": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Keys removed from the merged result. Dictionary key for dictionaries; element key for keyed lists (Rank / SlotID / RuleID). null = remove nothing. Ignored when no preset is set."
          },
          "PresetID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Preset key in the module registry (e.g. LeaderboardDefinitions.Presets.Milestones[PresetID]). Empty/null = preset unused (inline layer only)."
          }
        },
        "description": "Wiring for one preset block of an entity: a reference into the module's preset registry + optional keys to drop. Reusable Core container, one per preset-able block, held inside the entity's Presets container. Replaces the former scattered flat *PresetID / *Remove fields. Combination is data-driven, no mode (PresetResolver): no PresetID -> inline only; preset + empty inline -> preset; preset + inline -> merge (preset base + inline overrides/adds by key), Remove drops keys. For a single object (Character Equipment) there is nothing to key-merge, so inline wins when both are present."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "CommunityBudget": {
        "type": "object",
        "properties": {
          "OnExhausted": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityBudgetExhaustedBehavior"
              }
            ],
            "description": "What happens when the fund is exhausted. Not set = StopAccruing."
          },
          "TotalAmount": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Total campaign fund, in units of the payout currency. Not set or 0 = no overall fund; only the per-submission and per-creator caps limit spending."
          },
          "WarnAtSpentFraction": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Fraction of the fund (0..1) at which the publisher is warned. Not set = 0.8."
          }
        },
        "description": "The campaign's budget."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "CommunityRateCard": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "How much currency is paid per PerUnits of the metric. Not set and zero are DIFFERENT: not set falls through to the preset, zero is a final \"this metric pays nothing\" that overrides the preset."
          },
          "PerUnits": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "How many units of the metric Amount is paid for. Not set = 1000 (the industry-standard per-mille rate). Zero or negative is treated as 1000."
          },
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether this metric is paid at all. Not set = yes."
          },
          "NetworkID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Network whose Community Marketing pool bucket the payout is drawn from. Required when CurrencyKind = CryptoCurrency, ignored for virtual currency. The title's pool is tracked per (network, currency) pair and one currency may be bound to several networks, so this cannot be guessed."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies, depending on CurrencyKind."
          },
          "CurrencyKind": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityPayoutCurrencyKind"
              }
            ],
            "description": "Payout currency kind. Not set = VirtualCurrency. CryptoCurrency additionally moves value out of the title's Community Marketing pool bucket at claim time."
          },
          "MaxModeratorCoefficient": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Upper bound for the moderator coefficient. Not set = 10. Exists so a typo in the coefficient field cannot bill the campaign an order of magnitude more than intended."
          },
          "AllowModeratorCoefficient": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether a moderator may set a per-submission coefficient that multiplies this rate. Not set = yes. The coefficient itself lives on the submission, not here."
          }
        },
        "description": "Payout rate for one metric. This carries a currency and a number rather than a full ResourceGrant (which milestones use) because a rate is LINEAR: the amount scales with the metric, and there is no meaningful way to scale items or premium tier overlays by a fractional view count. Fixed rewards where an item makes sense are milestones."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "CommunityBriefItem": {
        "type": "object",
        "properties": {
          "Text": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item text shown to creators."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stable item ID - a moderator's rejection references it. Keep it when editing the text."
          }
        },
        "description": "One brief item."
      },
      "CommunityBriefLink": {
        "type": "object",
        "properties": {
          "Url": {
            "type": [
              "null",
              "string"
            ],
            "description": "Absolute http(s) URL."
          },
          "Title": {
            "type": [
              "null",
              "string"
            ],
            "description": "Link title."
          }
        },
        "description": "A link in the brief."
      },
      "CommunityMetricKind": {
        "enum": [
          "Views",
          "Likes",
          "Comments",
          "Shares"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Views",
          "Likes",
          "Comments",
          "Shares"
        ],
        "x-enum-descriptions": [
          "Views / plays / impressions, depending on what the platform calls it.",
          "Likes.",
          "Comments.",
          "Shares / reposts."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "MilestoneDefinition": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Base rewards. Always granted on a successful claim."
          },
          "SortOrder": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order in the UI (lower = higher/earlier)."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone images (icon, badge). null = unset.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "IsFeatured": {
            "type": "boolean",
            "description": "Featured milestone: special UI styling. With MilestoneClaimMode.FeaturedAfterEnd these can only be claimed after the instance ends."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for UI/CMS. null = unset."
          },
          "MilestoneID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique milestone ID within its owning entity (Mongo-safe, claim idempotency key)."
          },
          "BonusRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Bonus-window overlay: extra rewards on top of Rewards when the bonus phase is active at claim time (MilestoneRewardContext.BonusActive). Applied via MilestoneRewardResolver. null = no bonus part."
          },
          "RequiredProgress": {
            "type": "integer",
            "format": "int64",
            "description": "Threshold over ACCUMULATED progress to unlock. EventToken systems: EventTokenBalanceData.TotalEarned (not current balance). CommunityChest: shared group progress."
          },
          "SeasonTierRewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SeasonTierRewardSet"
              }
            ],
            "description": "Season-tier overlay: reward scaling by the player's season tier. Applied via MilestoneRewardResolver (SeasonTierRewardResolver.Resolve) only when MilestoneRewardContext.SeasonChainID is set. null = disabled."
          }
        },
        "description": "Unified milestone primitive for all platform systems (TimedEvent, Leaderboard, Quest, CommunityChest, DealOffer). Replaces the per-module milestone definitions. Threshold is checked against accumulated progress (RequiredProgress): EventToken systems use EventTokenBalanceData.TotalEarned; CommunityChest uses shared group progress. Reward overlays BonusRewards (bonus-window) and SeasonTierRewards (season-tier) are platform-wide optional fields applied via MilestoneRewardResolver; leave null if unused."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "SeasonTierRewardSet": {
        "type": "object",
        "properties": {
          "Bundles": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardBundle"
            },
            "description": "Structurally different rewards for specific tiers. On match, replaces the base ResourceGrant entirely (Replace)."
          },
          "Multipliers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SeasonTierRewardMultiplier"
            },
            "description": "Multipliers applied to Amount of the base ResourceGrant. Used ONLY if no Bundles entry matched."
          }
        },
        "description": "Generic container of season-tier reward scaling. Used by any platform system (leaderboards, lootboxes, shop, daily) that wants to scale a ResourceGrant by the player's current tier in a season chain. Empty/null lists = neutral."
      },
      "WalletPlayTokenGate": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Whether the requirement is active. False skips this gate (does not block)."
          },
          "NetworkID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Network this gate applies to (key from Blockchain.Networks)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "CurrencyID (cfg.Currency.CryptoCurrencies) whose balance is checked. Its binding for NetworkID provides ContractAddress (mint for Solana) and Decimals."
          },
          "MinBalance": {
            "type": "number",
            "format": "decimal",
            "description": "Minimum balance in whole units (e.g. 1000 = 1000 game tokens)."
          },
          "DenyMessage": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional custom denial message shown to the client (otherwise a default text is used)."
          },
          "BalanceSource": {
            "oneOf": [
              {
                "$ref": "#/definitions/WalletGateBalanceSource"
              }
            ],
            "description": "Where to read the balance compared against MinBalance: OnChain (wallet balance via RPC only), Combined (on-chain + in-game available balance InventoryV2.CryptoCurrencies[CurrencyID].Amount, excluding Frozen), InGame (in-game available balance only; no wallet, no RPC, NetworkID ignored). Default OnChain."
          }
        },
        "description": "One wallet-balance requirement for play access. Token contract and on-chain decimals are resolved from CryptoCurrencyDefinition.Networks by (CurrencyID, NetworkID), not duplicated here."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "CommunityPlatformRule": {
        "type": "object",
        "properties": {
          "Weight": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Multiplier applied to this platform's metrics. Not set = 1. Zero is valid and means \"submissions accepted but not paid\"."
          },
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the platform counts at all. Not set = yes."
          },
          "RateCards": {
            "type": [
              "null",
              "object"
            ],
            "description": "Per-platform rate overrides, key = CommunityMetricKind name. Merged field-by-field over the campaign rate cards: not set = inherit from the campaign, set = final (including zero, which means \"this metric is not paid on this platform\"). Not set = the platform has no own rates.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityRateCard"
            }
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Per-platform milestone overrides, grouped by metric exactly like the campaign ones. Overriding happens PER METRIC, not per threshold: thresholds of one metric form a ladder, so a per-threshold merge would splice a campaign step into a platform ladder. Metric set here = this platform's ladder replaces the campaign's for that metric (an empty ladder means \"no milestones for this counter here\"); metric not set = the campaign ladder applies.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityMetricMilestones"
            }
          }
        },
        "description": "One platform's weight inside a campaign."
      },
      "CommunityProviderMode": {
        "enum": [
          "Off",
          "Official",
          "Aggregator",
          "Manual"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Off",
          "Official",
          "Aggregator",
          "Manual"
        ],
        "x-enum-descriptions": [
          "Disabled: submissions on this platform are not accepted.",
          "The platform's own API, using the publisher's credentials.",
          "A third-party aggregator, using the publisher's vendor key.",
          "Numbers are entered by a moderator by hand. Always available and needs no credentials."
        ]
      },
      "CommunityShowcaseSort": {
        "enum": [
          "New",
          "TopViews"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "New",
          "TopViews"
        ],
        "x-enum-descriptions": [
          "Newest submissions first.",
          "Most viewed first."
        ]
      },
      "CommunityTeamSettings": {
        "type": "object",
        "properties": {
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether creator teams are enabled. Not set = no."
          },
          "SplitMode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityTeamSplitMode"
              }
            ],
            "description": "How a team-level reward is divided among members. Not set = ByContribution."
          },
          "MaxMembers": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum members per team. Not set = 10."
          },
          "CaptainSharePercent": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Fraction of a team reward taken by the captain on top of their normal share (0..1). Not set = 0."
          },
          "AllowCreatorCreatedTeams": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether a creator may create a team themselves. Not set = yes. Disabled means only the publisher creates teams."
          }
        },
        "description": "Creator teams."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "CommunityCampaignBrief": {
        "type": "object",
        "properties": {
          "Assets": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CommunityBriefLink"
            },
            "description": "Assets for creators (trailer, logos, press kit) - as links, no uploads."
          },
          "Format": {
            "type": [
              "null",
              "string"
            ],
            "description": "Format and delivery (short video, review, guide, length, orientation...)."
          },
          "Summary": {
            "type": [
              "null",
              "string"
            ],
            "description": "What to film - the main message of the brief."
          },
          "Examples": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CommunityBriefLink"
            },
            "description": "Examples of good works - as links."
          },
          "Forbidden": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CommunityBriefItem"
            },
            "description": "What is forbidden in the work. Each item has a stable ItemID."
          },
          "MustInclude": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CommunityBriefItem"
            },
            "description": "What must be in the work. Each item has a stable ItemID."
          }
        },
        "description": "The campaign brief. Items carry a stable ItemID that a moderator's rejection references; the work stores a snapshot of the failed items, so editing the brief later never rewrites an earlier decision."
      },
      "CommunityCrossPostMode": {
        "enum": [
          "PayEach",
          "Grouped",
          "OriginalOnly"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "PayEach",
          "Grouped",
          "OriginalOnly"
        ],
        "x-enum-descriptions": [
          "Every platform is its own submission and is paid separately.",
          "The original and its copies are ONE work: each is paid at its own platform's rates, and the per-submission cap applies to their total.",
          "Only the original is paid; copies are accepted and shown with their metrics but earn nothing."
        ]
      },
      "CommunityRecheckPolicy": {
        "enum": [
          "JoinOnly",
          "OnSubmission"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "JoinOnly",
          "OnSubmission"
        ],
        "x-enum-descriptions": [
          "Once, at join time - like manual approval, the decision is made once.",
          "At join and before every submission. Requires a fresh verdict; submission itself never evaluates the conditions."
        ]
      },
      "CommunityTeamSplitMode": {
        "enum": [
          "ByContribution",
          "Equal",
          "CaptainTakesAll"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ByContribution",
          "Equal",
          "CaptainTakesAll"
        ],
        "x-enum-descriptions": [
          "In proportion to each member's contribution to the metric that earned the reward.",
          "Equally between all members who had at least one approved submission in the campaign.",
          "Entirely to the captain, who distributes it outside the platform."
        ]
      },
      "SeasonTierRewardBundle": {
        "type": "object",
        "properties": {
          "Rewards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Rewards for this tier. Passed unmodified into ResourceService via a regular ResourceOperation.Grant."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this bundle to apply. Matches SeasonTierDefinition.Tier / UserSeasonState.CurrentTier."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to. Selection matches only tiers with the same SeasonChainID."
          }
        },
        "description": "Structurally different rewards for a season-chain tier. Analogous to PremiumTierBundle but the trigger is the player's season tier. Selection picks the single best match (MinSeasonTier <= playerTier); not stacked."
      },
      "CommunityMilestoneScope": {
        "enum": [
          "Submission",
          "Creator",
          "Team"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Submission",
          "Creator",
          "Team"
        ],
        "x-enum-descriptions": [
          "One submission: \"this clip passed 100K views\".",
          "All of the creator's submissions in this campaign combined.",
          "All of the team's submissions in this campaign combined. Ignored when teams are disabled."
        ]
      },
      "CommunityModerationMode": {
        "enum": [
          "Auto",
          "PreApproval",
          "PostAudit",
          "Threshold"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Auto",
          "PreApproval",
          "PostAudit",
          "Threshold"
        ],
        "x-enum-descriptions": [
          "Every submission is accepted automatically. Nothing is reviewed.",
          "Nothing accrues until a human approves the submission.",
          "Submissions accrue immediately; a human may audit and reject afterwards, which stops further accrual.",
          "Submissions accrue on their own until the metric named by ThresholdMetric crosses AutoApproveBelowMetric, then they go to human review."
        ]
      },
      "WalletGateBalanceSource": {
        "enum": [
          "OnChain",
          "Combined",
          "InGame"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "OnChain",
          "Combined",
          "InGame"
        ]
      },
      "CommunityItemRequirement": {
        "type": "object",
        "properties": {
          "Count": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "How many. Not set = 1."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item ID the player must own."
          },
          "MinLevel": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Minimum item level. Not set = any level. Only instances at or above this level count."
          }
        },
        "description": "One item ownership requirement."
      },
      "CommunityRequirementLoss": {
        "enum": [
          "Keep",
          "BlockSubmissions",
          "Suspend"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Keep",
          "BlockSubmissions",
          "Suspend"
        ],
        "x-enum-descriptions": [
          "Nothing - approval was a decision made at join time.",
          "Cannot submit NEW work; existing submissions and rewards are untouched.",
          "Status becomes Suspended until a human reviews it."
        ]
      },
      "CommunityCampaignIdentity": {
        "type": "object",
        "properties": {
          "IconPath": {
            "type": [
              "null",
              "string"
            ],
            "description": "Path to the campaign cover image."
          },
          "SortOrder": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Sort order in the campaign list. Not set = 0."
          },
          "DescriptionKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key for the description shown to creators - what to film and what gets paid."
          },
          "DisplayNameKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key for the campaign name. A literal is fine too - t() falls back to the key itself."
          }
        },
        "description": "How the campaign is presented in the creator portal."
      },
      "CommunityJoinRequirements": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Player-profile condition - the shared SegmentGate (level, country, premium, tutorial, platform, experiment variant)."
          },
          "Items": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/CommunityItemRequirement"
            },
            "description": "Items the player must own."
          },
          "Match": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityRequirementMatch"
              }
            ],
            "description": "How to combine conditions: All (default) or Any. The Gate counts as ONE condition (internally it is always AND)."
          },
          "OnLoss": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityRequirementLoss"
              }
            ],
            "description": "What happens to an ALREADY APPROVED creator who stops qualifying. Not set = BlockSubmissions. Never affects already-granted rewards."
          },
          "Recheck": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityRecheckPolicy"
              }
            ],
            "description": "When requirements are re-evaluated. Not set = JoinOnly."
          },
          "OnFailure": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityRequirementFailure"
              }
            ],
            "description": "What happens to an applicant that fails at join time. Not set = Review."
          },
          "DenyMessageKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key for the denial message. Not set = default text."
          },
          "WalletBalances": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/WalletPlayTokenGate"
            },
            "description": "Wallet balance requirements - the same WalletPlayTokenGate used by wallet login, including BalanceSource OnChain|Combined."
          },
          "MinCryptoBalances": {
            "type": [
              "null",
              "object"
            ],
            "description": "Minimum IN-GAME crypto balances: currencyID -> amount. NOT the wallet balance - see WalletBalances.",
            "additionalProperties": {
              "type": "number",
              "format": "decimal"
            }
          },
          "AllowWalletConnect": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "May the creator connect a wallet from the portal? Not set = no. Either way only a signature-verified linked wallet counts; connecting simply links one."
          },
          "MinVirtualCurrencies": {
            "type": [
              "null",
              "object"
            ],
            "description": "Minimum in-game virtual currency balances: currencyID -> amount.",
            "additionalProperties": {
              "type": "integer",
              "format": "int64"
            }
          },
          "RecheckMaxAgeMinutes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How fresh the verdict must be when Recheck = OnSubmission, in minutes. Not set = 60. Clamped to at least 1."
          }
        },
        "description": "Conditions under which the system admits a creator without a human. All fields optional; unset means the condition does not exist."
      },
      "CommunityMetricMilestones": {
        "type": "object",
        "properties": {
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Thresholds for this metric, key = MilestoneID.",
            "additionalProperties": {
              "$ref": "#/definitions/MilestoneDefinition"
            }
          }
        },
        "description": "Threshold rewards for one metric."
      },
      "CommunityProviderSettings": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityProviderMode"
              }
            ],
            "description": "How metrics are obtained for this platform. Not set = Off."
          },
          "SecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding the platform API key or the aggregator key. Required for Official and Aggregator modes."
          },
          "AggregatorBaseUrl": {
            "type": [
              "null",
              "string"
            ],
            "description": "Aggregator base URL. Used only in Aggregator mode."
          },
          "RevisionWindowDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many recent days to re-pull on every pass. Not set = 3. Platforms revise their numbers retroactively - fraud sweeps land days later."
          },
          "TrackingWindowDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "For how many days after publication a submission keeps being sampled; after that it is considered final. Not set = 90. A two-year-old clip must not be polled forever."
          },
          "SampleIntervalHours": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How often to sample metrics, in hours. Not set = 24. Every sample costs platform quota and a live campaign has thousands of submissions."
          },
          "RefreshTokenSecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding an OAuth refresh token, when the provider needs one. Not set = not required."
          }
        },
        "description": "Where one platform's numbers come from. The config carries the NAME of a secret, never its value: the value lives in the title's TitleSecrets, exactly as ad-network reporting credentials do."
      },
      "CommunityRequirementMatch": {
        "enum": [
          "All",
          "Any"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "All",
          "Any"
        ],
        "x-enum-descriptions": [
          "Every condition must hold.",
          "At least one condition must hold."
        ]
      },
      "CommunityShowcaseSettings": {
        "type": "object",
        "properties": {
          "ShowFund": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the campaigns' fund and the program's crypto pool bucket are shown. Not set = yes."
          },
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the program section is shown on the game page at all. Not set = yes (for an enabled program)."
          },
          "DefaultSort": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityShowcaseSort"
              }
            ],
            "description": "Default order of works. Not set = New."
          },
          "EmbedVideos": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the platform's player is embedded (loaded on click). Not set = yes."
          },
          "ShowMetrics": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether works' metrics are shown (views, likes, daily series). Not set = yes."
          },
          "AllowReports": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether works can be reported; the publisher reviews these reports. Not set = yes."
          },
          "ShowEarnings": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether amounts per work and per creator are shown (earned, granted, paid). Not set = yes."
          },
          "AllowComments": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether works can be commented on. Not set = yes."
          },
          "AllowReactions": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether works can be liked and disliked. Not set = yes."
          },
          "ShowCalculator": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the \"how much would I earn\" calculator is shown. Not set = yes."
          },
          "ShowLeaderboard": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the leaderboard is shown. Not set = yes."
          },
          "WorksVisibility": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityShowcaseWorksVisibility"
              }
            ],
            "description": "Which works are listed. Not set = ApprovedOnly."
          },
          "ShowCreatorIdentity": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the author of a work is shown (profile with a link) or just \"Creator\". Not set = yes."
          },
          "ShowRejectionReasons": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether rejection reasons and the failed brief items are shown (meaningful with WorksVisibility = All). Not set = no."
          }
        },
        "description": "What part of the program everyone sees on the game's public page. Hiding a work from the showcase is NOT moderating it: status, accrual and payout are unaffected."
      },
      "CommunityAntiFraudSettings": {
        "type": "object",
        "properties": {
          "HoldDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many days earnings must age before they can be claimed. Not set = 14. The cheapest and most effective anti-fraud measure: platforms strip purchased views within days, so inflated numbers never reach a payout. Zero is valid and means instant maturity."
          },
          "ClawbackUnpaid": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether unclaimed earnings shrink when a metric falls. Not set = YES. Already-paid amounts are never taken back: the difference becomes a debt netted against future earnings."
          },
          "MaxDailyMetricGain": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Maximum plausible daily gain of the primary metric for one submission; above it the submission is frozen and queued for review. Not set or 0 = velocity check disabled."
          },
          "RatioChecksMinViews": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Minimum view count before the ratio checks apply at all. Not set = 1000. Ratios are pure noise on small numbers: ten views and one like is a ratio of 0.1 and means nothing."
          },
          "MaxLikesToViewsRatio": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Maximum plausible likes-to-views ratio (0..1). Not set = 0.5. A higher ratio means the likes were inflated rather than the views."
          },
          "MinLikesToViewsRatio": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Minimum plausible likes-to-views ratio (0..1). Not set = 0.001. Purchased views come with almost no engagement, which is the most visible fingerprint of a bought campaign."
          }
        },
        "description": "Anti-fraud policy."
      },
      "CommunityParticipationMode": {
        "enum": [
          "Open",
          "Application",
          "Automatic"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Open",
          "Application",
          "Automatic"
        ],
        "x-enum-descriptions": [
          "Anyone is in, immediately. Requirements are not evaluated at all.",
          "A human approves each applicant.",
          "The system approves applicants that satisfy Requirements. Failures go to a human or are rejected, per OnFailure."
        ]
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "SeasonTierRewardMultiplier": {
        "type": "object",
        "properties": {
          "Multiplier": {
            "type": "number",
            "format": "double",
            "description": "Multiplier. 1.0 = neutral (resolver returns the base reward without copying). Rounding: (long)Math.Round(Amount * Multiplier). Entries with final Amount <= 0 are dropped."
          },
          "MinSeasonTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum player season tier required for this multiplier to apply."
          },
          "SeasonChainID": {
            "type": [
              "null",
              "string"
            ],
            "description": "SeasonChainID this tier is linked to."
          }
        },
        "description": "Multiplier applied to Amount of the base ResourceGrant for a season-chain tier. Applied to every ResourceEntry.Amount and EventTokenOperation.Amount in Standard and in PremiumTiers.Resources."
      },
      "CommunityCampaignDefinition": {
        "type": "object",
        "properties": {
          "Caps": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityCaps"
              }
            ],
            "description": "Caps per submission, per creator and per team. Caps are evaluated against what has been PAID, not what has been earned - otherwise a clawback would silently re-open a cap the creator had already hit."
          },
          "Brief": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityCampaignBrief"
              }
            ],
            "description": "The brief for creators: what to film, format, what must be on screen, what is forbidden, examples and assets. Unlike Content it is checked by a human, and a moderator's rejection references its items."
          },
          "Budget": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityBudget"
              }
            ],
            "description": "The campaign's budget and what happens when it runs out."
          },
          "Content": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityContentRequirements"
              }
            ],
            "description": "Requirements the post itself must satisfy (hashtags, mention, minimum duration, verification code)."
          },
          "Presets": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityCampaignPresetBindings"
              }
            ],
            "description": "Preset bindings for this campaign's blocks."
          },
          "Identity": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityCampaignIdentity"
              }
            ],
            "description": "Presentation: how the campaign appears in the creator portal (localization keys, icon, sort order)."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "When the campaign accepts submissions. Shared platform schedule primitive. Not set = always active."
          },
          "Platforms": {
            "type": [
              "null",
              "object"
            ],
            "description": "Which platforms count and at what weight, key = CommunitySocialPlatform name. A YouTube view and a TikTok view are not worth the same, and the weight is how the publisher says so. Not set = every platform with a configured provider counts at weight 1.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityPlatformRule"
            }
          },
          "RateCards": {
            "type": [
              "null",
              "object"
            ],
            "description": "Per-metric rate cards, key = CommunityMetricKind name (e.g. \"Views\", \"Likes\"). Not set = no linear payout, milestones only.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityRateCard"
            }
          },
          "CampaignID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Unique campaign ID within the title. May be left empty in config - the resolver substitutes the dictionary key."
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Threshold rewards grouped BY METRIC: outer key = CommunityMetricKind name (\"Views\", \"Likes\"…), inner key = MilestoneID, value = the shared platform milestone primitive. A campaign can reward \"50000 views\" and \"10000 likes\" at the same time; the scope (per submission or per creator) is set by MilestoneScope.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityMetricMilestones"
            }
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityCampaignAvailability"
              }
            ],
            "description": "Who the campaign is available to."
          },
          "MilestoneScope": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityMilestoneScope"
              }
            ],
            "description": "Whether milestone progress accumulates per submission or across all of the creator's submissions in this campaign. Not set = Submission."
          }
        },
        "description": "A single campaign: the rule set that turns a creator's post into a reward. Root carries only the ID; everything else is split into named blocks, each of which is one editor tab and one preset-able unit."
      },
      "CommunityModerationSettings": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityModerationMode"
              }
            ],
            "description": "How submissions are moderated. Not set = PreApproval (nothing accrues until a human approves)."
          },
          "ReviewSlaHours": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Target review time in hours, used to highlight overdue items in the moderation queue. Not set = 72. Affects presentation only."
          },
          "ThresholdMetric": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityMetricKind"
              }
            ],
            "description": "Which metric the Threshold mode measures. Not set = Views."
          },
          "AccrueBeforeApproval": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether metrics collected BEFORE approval count. Not set = YES: time passes between posting and review, and the creator should not lose those views because a moderator was asleep."
          },
          "AutoApproveBelowMetric": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Metric threshold for Threshold mode: a submission accrues on its own until it crosses this value, then goes to human review. Not set = 10000. The point is to avoid making a human watch a thousand clips with a hundred views each, while never paying out real money unattended."
          },
          "RequireRejectionReason": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether a moderator comment is mandatory when rejecting. Not set = YES: a rejection with no reason is one the creator can neither fix nor dispute."
          }
        },
        "description": "Submission moderation policy."
      },
      "CommunityPayoutCurrencyKind": {
        "enum": [
          "VirtualCurrency",
          "CryptoCurrency"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "VirtualCurrency",
          "CryptoCurrency"
        ],
        "x-enum-descriptions": [
          "Off-chain virtual currency from cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency from cfg.Currency.CryptoCurrencies. Claiming additionally moves value from the title's Community Marketing pool bucket into the players' bucket."
        ]
      },
      "CommunityRequirementFailure": {
        "enum": [
          "Review",
          "Reject"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Review",
          "Reject"
        ],
        "x-enum-descriptions": [
          "Leave the application for a human to review.",
          "Reject outright, telling the applicant which condition failed."
        ]
      },
      "CommunityContentRequirements": {
        "type": "object",
        "properties": {
          "RequiredMention": {
            "type": [
              "null",
              "string"
            ],
            "description": "A mention of the game's account that must appear in the description."
          },
          "RequiredHashtags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Hashtags that must appear in the post description. Case-insensitive, the leading # is optional. Not set = no requirement."
          },
          "MinDurationSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Minimum clip duration in seconds. Not set or 0 = no limit. Only enforced when the provider reports duration."
          },
          "RequireVerificationCode": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the creator's personal verification code must appear in the post description or the account bio. Not set = YES. This is the only automatic proof of authorship: without it anyone can submit somebody else's popular clip."
          }
        },
        "description": "Requirements the published post must satisfy."
      },
      "CommunityCampaignAvailability": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience condition - the shared platform SegmentGate. Every field the gate reads must be present in the projection passed to the evaluator; an unprojected field silently never passes."
          }
        },
        "description": "Who the campaign is available to."
      },
      "CommunityParticipationSettings": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityParticipationMode"
              }
            ],
            "description": "Open enrolment or by application. Not set = Application (the safer default: the publisher sees who is about to represent their game)."
          },
          "TermsKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key of the program terms the creator accepts on enrolment. Not set = no terms step."
          },
          "MinFollowers": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Minimum follower count for a social account to be linkable. Not set or 0 = no requirement. Only enforced when the provider reports the number."
          },
          "Requirements": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CommunityJoinRequirements"
              }
            ],
            "description": "Automatic-approval requirements. Only evaluated when Mode is Automatic."
          },
          "MaxLinkedAccounts": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum number of social accounts one creator may link. Not set = 5. A cap is required: the list is client-supplied and would otherwise grow without bound."
          }
        },
        "description": "Who may join the program and how."
      },
      "CommunityCampaignPresetBindings": {
        "type": "object",
        "properties": {
          "Caps": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Caps block."
          },
          "Brief": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Brief block."
          },
          "Content": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Content requirements block."
          },
          "Platforms": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Platforms dictionary."
          },
          "RateCards": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the RateCards dictionary."
          },
          "Milestones": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Milestones dictionary."
          },
          "Availability": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PresetBinding"
              }
            ],
            "description": "Preset for the Availability block."
          }
        },
        "description": "Preset bindings for a campaign's blocks."
      },
      "CommunityBudgetExhaustedBehavior": {
        "enum": [
          "StopAccruing",
          "CloseCampaign"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "StopAccruing",
          "CloseCampaign"
        ],
        "x-enum-descriptions": [
          "Stop accruing. Submissions stay visible and keep collecting metrics, but earn nothing further.",
          "Close the campaign entirely: no new submissions are accepted either."
        ]
      },
      "CommunityMarketingPresetRegistry": {
        "type": "object",
        "properties": {
          "Caps": {
            "type": [
              "null",
              "object"
            ],
            "description": "Caps presets, key = preset ID.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityCaps"
            }
          },
          "Brief": {
            "type": [
              "null",
              "object"
            ],
            "description": "Brief presets, key = preset ID.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityCampaignBrief"
            }
          },
          "Content": {
            "type": [
              "null",
              "object"
            ],
            "description": "Content-requirement presets, key = preset ID.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityContentRequirements"
            }
          },
          "Platforms": {
            "type": [
              "null",
              "object"
            ],
            "description": "Platform-weight presets, key = preset ID, value = a Platforms dictionary keyed by platform name.",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "$ref": "#/definitions/CommunityPlatformRule"
              }
            }
          },
          "RateCards": {
            "type": [
              "null",
              "object"
            ],
            "description": "Rate-card presets, key = preset ID, value = a RateCards dictionary keyed by metric name.",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "$ref": "#/definitions/CommunityRateCard"
              }
            }
          },
          "Milestones": {
            "type": [
              "null",
              "object"
            ],
            "description": "Milestone presets, key = preset ID, value = milestone groups keyed by CommunityMetricKind name.",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "$ref": "#/definitions/CommunityMetricMilestones"
              }
            }
          },
          "Availability": {
            "type": [
              "null",
              "object"
            ],
            "description": "Availability presets, key = preset ID.",
            "additionalProperties": {
              "$ref": "#/definitions/CommunityCampaignAvailability"
            }
          }
        },
        "description": "Preset registry for the Community Marketing program. Keys are preset IDs referenced from a campaign's Presets bindings."
      },
      "CommunityShowcaseWorksVisibility": {
        "enum": [
          "Hidden",
          "ApprovedOnly",
          "ApprovedAndPending",
          "All"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hidden",
          "ApprovedOnly",
          "ApprovedAndPending",
          "All"
        ],
        "x-enum-descriptions": [
          "No works are listed; rules, fund and totals are still shown.",
          "Only approved works.",
          "Approved works and works awaiting review.",
          "Every work, including rejected ones (with reasons if ShowRejectionReasons is on)."
        ]
      }
    },
    "additionalProperties": false
  }

  arguments 2815 lines copy
• get_push unknown never probed

  GET ONLY the 'Push' field of TitlePublicConfigurationModel. Push notifications - the title's settings for messages delivered to a player who is NOT in the game right now (Web Push in the browser, FCM/APNs on mobile). IsEnabled is the master switch and defaults to DISABLED: notifications spend a real person's attention and require their browser permission, so a title opts in explicitly. MaxSendsPerUserPerDay caps how many a single player receives; MaxSendsPerTitlePerDay caps the title as a whole and is the ONLY ceiling on a broadcast that exists anywhere - the publisher API quota does not see sends at all, because they run in a queue worker rather than in a request pipeline. QuietHoursStart/End suppress sends during the night in the SUBSCRIPTION's locale (the window may cross midnight); waking a person at 3am is the fastest way to lose the browser permission permanently. Mobile holds only the NAMES of TitleSecrets entries for the publisher's Firebase service account and APNs .p8 key, never the credentials. VAPID keys are NOT here and never will be - they are platform-wide environment variables shared by both backends. Subscriptions themselves are not config either: they live in the shared PushEndpoints/PushBindings collections, one row per browser or device plus one row per topic it follows.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_push unknown never probed

  PARTIAL SAVE: writes ONLY the 'Push' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Push notifications - the title's settings for messages delivered to a player who is NOT in the game right now (Web Push in the browser, FCM/APNs on mobile). IsEnabled is the master switch and defaults to DISABLED: notifications spend a real person's attention and require their browser permission, so a title opts in explicitly. MaxSendsPerUserPerDay caps how many a single player receives; MaxSendsPerTitlePerDay caps the title as a whole and is the ONLY ceiling on a broadcast that exists anywhere - the publisher API quota does not see sends at all, because they run in a queue worker rather than in a request pipeline. QuietHoursStart/End suppress sends during the night in the SUBSCRIPTION's locale (the window may cross midnight); waking a person at 3am is the fastest way to lose the browser permission permanently. Mobile holds only the NAMES of TitleSecrets entries for the publisher's Firebase service account and APNs .p8 key, never the credentials. VAPID keys are NOT here and never will be - they are platform-wide environment variables shared by both backends. Subscriptions themselves are not config either: they live in the shared PushEndpoints/PushBindings collections, one row per browser or device plus one row per topic it follows.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "PushDefinitions",
        "properties": {
          "Events": {
            "type": [
              "null",
              "object"
            ],
            "description": "Which GAME EVENTS send a notification, keyed by event id (\"chat.direct\", \"social.friend_request\"). An event that is absent is never sent, and costs zero database work. Only things ANOTHER person did are here - there is no scheduler on the platform, so \"your energy is full\" style reminders do not exist.",
            "additionalProperties": {
              "$ref": "#/definitions/PushEventDefinition"
            }
          },
          "Mobile": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PushMobileDefinition"
              }
            ],
            "description": "Mobile transports (FCM/APNs). Contains only the NAMES of TitleSecrets entries, never the credentials themselves."
          },
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Master switch. Not set = DISABLED (unlike Chat/Tutorial): notifications spend a real person's attention, so a title must opt in explicitly."
          },
          "DefaultIcon": {
            "type": [
              "null",
              "string"
            ],
            "description": "Default notification icon (absolute URL). Empty = the browser's own default."
          },
          "QuietHoursEnd": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Quiet hours end (0..23). Only meaningful together with the start."
          },
          "QuietHoursStart": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Quiet hours start (0..23), in the SUBSCRIPTION's locale. Not set = never quiet."
          },
          "MaxSendsPerUserPerDay": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Per-player daily cap. 0 = unlimited. Not set = platform default (10)."
          },
          "MaxSendsPerTitlePerDay": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Title-wide daily cap. 0 = unlimited. This is the ONLY ceiling on broadcasts: the publisher API quota does not see sends at all, because they run in a queue worker rather than in a request pipeline."
          }
        },
        "description": "Push notification settings for the title: the master switch, per-player and per-title send ceilings, quiet hours, and the NAMES of the publisher's mobile credentials in TitleSecrets. VAPID keys are NOT here - they are platform-wide environment variables. Subscriptions themselves live in the shared PushEndpoints/PushBindings collections, not in the config."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "PushEventDefinition": {
        "type": "object",
        "properties": {
          "Url": {
            "type": [
              "null",
              "string"
            ],
            "description": "Where tapping the notification leads. Empty = the game itself."
          },
          "Icon": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event icon; empty falls back to the section's DefaultIcon."
          },
          "BodyKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key of the body."
          },
          "TitleKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Localization key of the title. Empty means the event is not sent at all: a notification without a title is a blank grey box."
          },
          "IsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether this event sends a notification. Not set = disabled."
          }
        }
      },
      "PushMobileDefinition": {
        "type": "object",
        "properties": {
          "ApnsKeyId": {
            "type": [
              "null",
              "string"
            ],
            "description": "APNs key id (the 'kid' header of the provider token). Public by nature."
          },
          "ApnsTeamId": {
            "type": [
              "null",
              "string"
            ],
            "description": "Apple team id (the 'iss' claim of the provider token). Public by nature."
          },
          "ApnsBundleId": {
            "type": [
              "null",
              "string"
            ],
            "description": "App bundle id, used as the APNs topic."
          },
          "ApnsUseSandbox": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Send to Apple's sandbox host instead of production. This is an ADDRESS, not a debug flag: a token issued to a development build is rejected by the production host with BadDeviceToken and vice versa. Not set = production."
          },
          "ApnsKeySecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding the APNs .p8 private key. Never the key itself."
          },
          "FcmServiceAccountSecretName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the TitleSecrets entry holding the Firebase service-account JSON. Never the JSON itself."
          }
        }
      }
    },
    "additionalProperties": false
  }

  arguments 177 lines copy
• get_workshop unknown never probed

  GET ONLY the 'Workshop' field of TitlePublicConfigurationModel. Workshop - the catalog of content made by PLAYERS (maps, levels, skins, models, any file the game defines) and by the publisher (official content), and the LICENSES to it. Nothing is transferred: acquiring grants a license to a digital copy, so one publication is acquired by many and the author keeps it (unlike Marketplace, which escrows and moves goods). ContentTypes is the game-specific part: each type id (e.g. 'voxelcraft.world') declares its file roles (AllowedMimeTypes, MaxBytes, MaxCount, Required; the engine checks the uploaded file's signature against the declared type), whether a thumbnail is required, which AccessModes authors may use, an optional per-type PricePolicy, a PublishGate (SegmentGate: who may publish), PublishFeeOptions (PriceOption, Standard part only, never store-paid), a TagVocabulary and per-player limits. An author gives access by ANY of several options: Free, Price (a ResourceBundle validated by PricePolicy; the buyer pays, the author receives it minus Commission, which is burned or credited to the MarketplaceLedger) or Holding (hold N of a currency/item - nothing is charged; Mode WhileHeld re-checks on every download, UnlockOnce checks once and grants a permanent license; HoldingPolicy whitelists usable resources). Moderation: BlockedTerms for titles/descriptions/tags, AutoHideReportThreshold (reports that hide a publication until reviewed), RequireApproval (pre-moderation). Featured lists publisher-curated collections with their own ScheduleSpec and SegmentGate. Publications, licenses, reactions and reports are NOT here - they are operational data in their own collections; files live in a private bucket configured by the engine's WORKSHOP_BUCKET_NAME env var.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_workshop unknown never probed

  PARTIAL SAVE: writes ONLY the 'Workshop' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Workshop - the catalog of content made by PLAYERS (maps, levels, skins, models, any file the game defines) and by the publisher (official content), and the LICENSES to it. Nothing is transferred: acquiring grants a license to a digital copy, so one publication is acquired by many and the author keeps it (unlike Marketplace, which escrows and moves goods). ContentTypes is the game-specific part: each type id (e.g. 'voxelcraft.world') declares its file roles (AllowedMimeTypes, MaxBytes, MaxCount, Required; the engine checks the uploaded file's signature against the declared type), whether a thumbnail is required, which AccessModes authors may use, an optional per-type PricePolicy, a PublishGate (SegmentGate: who may publish), PublishFeeOptions (PriceOption, Standard part only, never store-paid), a TagVocabulary and per-player limits. An author gives access by ANY of several options: Free, Price (a ResourceBundle validated by PricePolicy; the buyer pays, the author receives it minus Commission, which is burned or credited to the MarketplaceLedger) or Holding (hold N of a currency/item - nothing is charged; Mode WhileHeld re-checks on every download, UnlockOnce checks once and grants a permanent license; HoldingPolicy whitelists usable resources). Moderation: BlockedTerms for titles/descriptions/tags, AutoHideReportThreshold (reports that hide a publication until reviewed), RequireApproval (pre-moderation). Featured lists publisher-curated collections with their own ScheduleSpec and SegmentGate. Publications, licenses, reactions and reports are NOT here - they are operational data in their own collections; files live in a private bucket configured by the engine's WORKSHOP_BUCKET_NAME env var.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "WorkshopDefinitions",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate: who can see the Workshop, publish and acquire. null = everyone. Downloading already acquired content is never gated."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/WorkshopLimits"
              }
            ],
            "description": "Limits for text, tags, metadata and thumbnails."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Module master switch. Default false — the Workshop must be enabled explicitly."
          },
          "Featured": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/WorkshopCollection"
            },
            "description": "Publisher-curated collections ('Editor's choice', 'Maps of the week'), each with its own schedule and gate."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "Open windows for publishing and acquiring. null = always open. Downloading already acquired content is never gated."
          },
          "Commission": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplaceCommissionPolicy"
              }
            ],
            "description": "Commission on sales. Per content type overrides go to PerCatalogOverrides with key = content type id. Snapshotted into the publication when it is published."
          },
          "Moderation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/WorkshopModerationSettings"
              }
            ],
            "description": "Moderation: blocked terms, auto-hide on reports, pre-moderation."
          },
          "PricePolicy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplacePricePolicy"
              }
            ],
            "description": "Price composition policy for paid content (a content type may override it). null = marketplace defaults (any tradable currency)."
          },
          "ContentTypes": {
            "type": [
              "null",
              "object"
            ],
            "description": "Content types of the game. Key = type id sent by the game client (e.g. 'voxelcraft.world', 'level', 'skin'). Only types from this dictionary can be published.",
            "additionalProperties": {
              "$ref": "#/definitions/WorkshopContentType"
            }
          },
          "HoldingPolicy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/WorkshopHoldingPolicy"
              }
            ],
            "description": "Which resources an author may use as a 'hold to unlock' access condition."
          }
        },
        "description": "Title Workshop configuration: a catalog of content made by players (maps, levels, skins, models) and by the publisher (official content). Unlike the Marketplace nothing is transferred: acquiring grants a LICENSE to a digital copy, so one publication is acquired by many and the author keeps it. Everything game-specific (content types, file formats and sizes, who may publish, which access modes are allowed) is configured here, no engine code per game."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CommissionSink": {
        "enum": [
          "Burn",
          "Ledger"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Burn",
          "Ledger"
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "WorkshopLimits": {
        "type": "object",
        "properties": {
          "MaxTags": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max tags per publication. null = 10."
          },
          "MaxTagLength": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max length of one tag. null = 24."
          },
          "MaxTitleLength": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max title length. null = 60."
          },
          "MaxMetadataKeys": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max metadata keys per publication. null = 16."
          },
          "MaxAccessOptions": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max access options per publication. null = 5."
          },
          "ThumbnailMaxBytes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Max thumbnail size in bytes (png/jpeg/webp). null = 1 MB."
          },
          "MaxDescriptionLength": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max description length. null = 2000."
          },
          "MaxMetadataValueLength": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Max metadata value length. null = 128."
          }
        },
        "description": "Limits for Workshop text, tags, metadata, access options and thumbnails."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "WorkshopFileRole": {
        "type": "object",
        "properties": {
          "MaxBytes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Maximum size of one file in bytes. null = 10 MB."
          },
          "MaxCount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many files of this role. null = 1."
          },
          "Required": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the role is required. null = only the 'main' role is required."
          },
          "AllowedMimeTypes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed MIME types. null/empty = application/json only. The file signature is checked against the declared type; a format without a signature (application/octet-stream) is accepted only when listed here explicitly."
          }
        },
        "description": "A file role of a publication: which formats and how many."
      },
      "EntryResourceKind": {
        "enum": [
          "VirtualCurrency",
          "Item",
          "EventToken",
          "CryptoCurrency"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "VirtualCurrency",
          "Item",
          "EventToken",
          "CryptoCurrency"
        ]
      },
      "EntryResourceRule": {
        "type": "object",
        "properties": {
          "Kind": {
            "oneOf": [
              {
                "$ref": "#/definitions/EntryResourceKind"
              }
            ],
            "description": "Resource kind this rule applies to."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item ID within the catalog (for Kind = Item). Key in cfg.Item.Catalogs[CatalogID].Items."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event ID within the system (for Kind = EventToken). null/empty = any event of that system."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog ID (for Kind = Item). Key in cfg.Item.Catalogs."
          },
          "MaxAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum amount of the entry position. 0 = no upper bound."
          },
          "MinAmount": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum amount of the entry position. 0 = no lower bound."
          },
          "TokenType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "Event-token system (for Kind = EventToken)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency ID: a virtual currency (for Kind = VirtualCurrency, key in cfg.Currency.VirtualCurrencies) or a crypto currency (for Kind = CryptoCurrency, key in cfg.Currency.CryptoCurrencies)."
          }
        },
        "description": "One entry-whitelist rule: a concrete resource (or resource family) with amount bounds. An entry position matches by Kind and identifiers; 0 in Min/Max = unbounded on that side."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "WorkshopAccessMode": {
        "enum": [
          "Free",
          "Price",
          "Holding"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Free",
          "Price",
          "Holding"
        ]
      },
      "WorkshopCollection": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who sees the collection. null = everyone."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name (a localization key or a literal)."
          },
          "Order": {
            "type": "integer",
            "format": "int32",
            "description": "Sort order among collections; lower first."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "When the collection is shown. null = always."
          },
          "ContentIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Publications in display order (ContentID). Only published ones are shown."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional description."
          },
          "CollectionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Collection identifier (unique within the section)."
          }
        },
        "description": "A publisher-curated collection of publications."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "WorkshopContentType": {
        "type": "object",
        "properties": {
          "Files": {
            "type": [
              "null",
              "object"
            ],
            "description": "File roles of a publication. Key = role ('main', 'extra', ...). null = a single required 'main' role: one JSON file up to 10 MB.",
            "additionalProperties": {
              "$ref": "#/definitions/WorkshopFileRole"
            }
          },
          "Enabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "A disabled type can't be published and is hidden from the catalog. null = enabled."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the type (a localization key or a literal)."
          },
          "PricePolicy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MarketplacePricePolicy"
              }
            ],
            "description": "Price policy of this type. null = the common WorkshopDefinitions.PricePolicy."
          },
          "PublishGate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who may publish this type ('level 10+', 'premium only'). null = everyone who passes the Workshop gate."
          },
          "TagVocabulary": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed tags. Empty/null = free-form tags (bounded by WorkshopLimits)."
          },
          "DailyPublishCap": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many new publications of this type a player may start per UTC day. null = 10, 0 = unlimited."
          },
          "PublishFeeOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Fee for the first publication. Key = PriceOption.OptionID. Only the Standard part is charged; a store-paid option is rejected. null = free.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          },
          "ThumbnailRequired": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether a thumbnail is required. null = no."
          },
          "AllowedAccessModes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/WorkshopAccessMode"
            },
            "description": "Allowed access modes. null/empty = all (Free, Price, Holding)."
          },
          "MaxPublishedPerPlayer": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many live publications of this type a player may have. null = 50, 0 = unlimited."
          }
        },
        "description": "A content type the game can publish and open."
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "WorkshopHoldingPolicy": {
        "type": "object",
        "properties": {
          "Allowed": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EntryResourceRule"
            },
            "description": "Whitelist (Kind = VirtualCurrency or Item) with MinAmount/MaxAmount bounds on the required amount. Empty/null = any currency and any item of the title."
          },
          "MaxRequirements": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many requirements one access option may have. null = 3."
          }
        },
        "description": "Which resources may be used as a 'hold to unlock' condition."
      },
      "MarketplacePricePolicy": {
        "type": "object",
        "properties": {
          "Allowed": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EntryResourceRule"
            },
            "description": "Whitelist of allowed price resources with Min/Max bounds. When non-empty it is authoritative: every price position must match a rule; the type flags are ignored."
          },
          "AllowItems": {
            "type": "boolean",
            "description": "Allow stackable items as a price position. Default false. Ignored when Allowed is non-empty."
          },
          "MaxPositions": {
            "type": "integer",
            "format": "int32",
            "description": "Max number of positions in the price bundle (Entries + EventTokens). Sanity cap. Default 5. 0 = unlimited."
          },
          "AllowEventTokens": {
            "type": "boolean",
            "description": "Allow event tokens as a price position. Default false (tokens of an ended event may become unclaimable — whitelist long-lived systems only). Ignored when Allowed is non-empty."
          },
          "AllowCryptoCurrency": {
            "type": "boolean",
            "description": "Allow the title's crypto currencies as a price position (whole tokens, no USD amount). Default false — trading crypto between players is enabled explicitly. Crypto positions carry the developer's trade fee (CryptoCurrencyDefinition.PlayerTradeFeePercent) instead of the marketplace Commission. Ignored when Allowed is non-empty."
          },
          "AllowVirtualCurrency": {
            "type": "boolean",
            "description": "Allow any virtual currency as a price position. Default true. Ignored when Allowed is non-empty."
          }
        },
        "description": "Price composition policy — mirror of the Match entry policy, reusing EntryResourceRule/EntryResourceKind. Two control levels: type flags ('any resource of this type') and the authoritative Allowed whitelist with Min/Max (when non-empty the flags are ignored). Unstackable items are always rejected as price."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "WorkshopModerationSettings": {
        "type": "object",
        "properties": {
          "BlockedTerms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Blocked terms for titles, descriptions and tags (normalized matching, same as chat)."
          },
          "RequireApproval": {
            "type": "boolean",
            "description": "Pre-moderation: a new publication becomes visible only after the publisher approves it. Default false."
          },
          "AutoHideReportThreshold": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many reports hide a publication until the publisher reviews it. null = 5, 0 = never."
          }
        },
        "description": "Workshop moderation settings."
      },
      "MarketplaceCommissionPolicy": {
        "type": "object",
        "properties": {
          "Sink": {
            "oneOf": [
              {
                "$ref": "#/definitions/CommissionSink"
              }
            ],
            "description": "Commission sink: Burn — destroyed (default), Ledger — credited to the title's MarketplaceLedger document."
          },
          "Percent": {
            "type": "number",
            "format": "double",
            "description": "Commission fraction (0.05 = 5%). Default 0.05."
          },
          "MinPerPosition": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum commission per price position (in the position's resource units). 0 = no minimum."
          },
          "LedgerAccountID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Ledger account ID (for Sink=Ledger). Empty falls back to \"default\"."
          },
          "ApplyToDirectTrades": {
            "type": "boolean",
            "description": "Whether commission applies to direct trades (the RequestedBundle at accept). Default false — gifts/trades are commission-free."
          },
          "PerCatalogOverrides": {
            "type": [
              "null",
              "object"
            ],
            "description": "Commission overrides by the GOODS catalog (key = the offer's goods CatalogID).",
            "additionalProperties": {
              "$ref": "#/definitions/MarketplaceCommissionOverride"
            }
          }
        },
        "description": "Commission policy. Computed per price position at settlement: fee = min(amount, max(ceil(amount * Percent), MinPerPosition)); the seller receives the net. The policy is snapshotted into the offer at creation."
      },
      "MarketplaceCommissionOverride": {
        "type": "object",
        "properties": {
          "Percent": {
            "type": "number",
            "format": "double",
            "description": "Commission fraction for this catalog (0.05 = 5%)."
          },
          "MinPerPosition": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum commission per price position."
          }
        },
        "description": "Commission override for a specific goods catalog."
      }
    },
    "additionalProperties": false
  }

  arguments 1636 lines copy
• get_social unknown never probed

  GET ONLY the 'Social' field of TitlePublicConfigurationModel. In-game social layer - comments, following other players and reports, on top of the engine's shared social core (the same collections the platform's own social network uses, scoped to this title). Comments are OFF by default (CommentsEnabled): they are public text written by players, so turn them on only once you are ready to moderate them; CommentableTypes limits which objects accept comments (today only Workshop items). CommentMaxLength / CommentMaxLinks / CommentsPerDay, MaxFollowing / FollowsPerDay and ReportsPerDay are anti-spam ceilings; unset fields mean the platform defaults. Friends and the player's notification inbox (attacks, raids, new friend, Workshop sales and likes) need no configuration and are not here. Likes, favorites, follows, comments and reports themselves are NOT here - they are operational data in the shared Social* collections; reviewing reports and hiding comments are admin actions, not config.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_social unknown never probed

  PARTIAL SAVE: writes ONLY the 'Social' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. In-game social layer - comments, following other players and reports, on top of the engine's shared social core (the same collections the platform's own social network uses, scoped to this title). Comments are OFF by default (CommentsEnabled): they are public text written by players, so turn them on only once you are ready to moderate them; CommentableTypes limits which objects accept comments (today only Workshop items). CommentMaxLength / CommentMaxLinks / CommentsPerDay, MaxFollowing / FollowsPerDay and ReportsPerDay are anti-spam ceilings; unset fields mean the platform defaults. Friends and the player's notification inbox (attacks, raids, new friend, Workshop sales and likes) need no configuration and are not here. Likes, favorites, follows, comments and reports themselves are NOT here - they are operational data in the shared Social* collections; reviewing reports and hiding comments are admin actions, not config.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "SocialDefinitions",
        "properties": {
          "MaxFollowing": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many players one player may follow at once. Unset = 2000."
          },
          "FollowsPerDay": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "New follows one player may make per UTC day. Unset = 200. Guards against follow/unfollow churn used to spam notifications."
          },
          "ReportsPerDay": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Reports one player may file per UTC day. Unset = 20. Protects the moderation queue from report flooding."
          },
          "CommentsPerDay": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Comments one player may post per UTC day across the title. Unset = 50."
          },
          "CommentMaxLinks": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum links in one comment. Unset = 1; 0 forbids links entirely (the most common spam vector)."
          },
          "CommentsEnabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Enables in-game comments. Default OFF: comments are public text written by players, so the publisher turns them on explicitly once they are ready to moderate them (reports queue in the dashboard)."
          },
          "CommentMaxLength": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum comment length in characters. Unset = 500. Hard ceiling 2000."
          },
          "CommentableTypes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SocialEntityType"
            },
            "description": "Which objects accept comments inside the game. Unset = Workshop items only. Allowed values: WorkshopItem."
          }
        },
        "description": "In-game social layer: comments, following players, reports. Friends and the player's notification inbox work without this section. Every field is optional; an unset field means the platform default."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "SocialEntityType": {
        "enum": [
          "User",
          "Channel",
          "Title",
          "WorkshopItem",
          "Post",
          "Comment",
          "CommunitySubmission"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "User",
          "Channel",
          "Title",
          "WorkshopItem",
          "Post",
          "Comment",
          "CommunitySubmission"
        ]
      }
    },
    "additionalProperties": false
  }

  arguments 110 lines copy
• get_platform_bridge unknown never probed

  GET ONLY the 'PlatformBridge' field of TitlePublicConfigurationModel. Platform bridge - what the game takes from the player's idosgames.com account and what it lets players show on their public profile. Profile: Off / Default (unset: the platform name and avatar until the player renames themselves in the game) / Always (every platform login overwrites them). Friends: TitleOnly (unset) / TitleAndPlatform (plus mutual follows on idosgames.com whose both sides play this game) / PlatformOnly (only those; in-game friend requests are refused) - applies to EVERY friends-based system: friends list and leaderboard, gifts, attack targets, friends-only Workshop items, recommendations. Notifications: which in-game notifications (Attack, Raid, FriendAdded, WorkshopSale) also reach the idosgames.com notification bell; empty = none. Guests never get platform data; the economy never crosses the bridge; turning the bridge off deletes nothing.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_platform_bridge unknown never probed

  PARTIAL SAVE: writes ONLY the 'PlatformBridge' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Platform bridge - what the game takes from the player's idosgames.com account and what it lets players show on their public profile. Profile: Off / Default (unset: the platform name and avatar until the player renames themselves in the game) / Always (every platform login overwrites them). Friends: TitleOnly (unset) / TitleAndPlatform (plus mutual follows on idosgames.com whose both sides play this game) / PlatformOnly (only those; in-game friend requests are refused) - applies to EVERY friends-based system: friends list and leaderboard, gifts, attack targets, friends-only Workshop items, recommendations. Notifications: which in-game notifications (Attack, Raid, FriendAdded, WorkshopSale) also reach the idosgames.com notification bell; empty = none. Guests never get platform data; the economy never crosses the bridge; turning the bridge off deletes nothing.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "PlatformBridgeDefinitions",
        "properties": {
          "Friends": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PlatformFriendsMode"
              }
            ],
            "description": "Where 'friends' come from for EVERY game system (friends list, friends leaderboard, gifts, attack targets, friends-only Workshop items, recommendations). TitleOnly (unset) = in-game friendships; TitleAndPlatform = plus mutual follows on idosgames.com whose both sides play this game; PlatformOnly = only those, and in-game friend requests are refused with FRIENDS_FROM_PLATFORM."
          },
          "Profile": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/PlatformProfileMode"
              }
            ],
            "description": "Where the in-game name and avatar of a player with a platform account come from. Off = game only; Default (unset) = the platform ones until the player renames themselves in the game, after which the game choice is kept; Always = every platform login overwrites them."
          },
          "Notifications": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/SocialInboxVerb"
            },
            "description": "Which in-game notifications are also delivered to the notification bell on idosgames.com for players with a platform account. Unset/empty = none. Allowed: Attack, Raid, FriendAdded, WorkshopSale."
          }
        },
        "description": "Platform bridge: what the game takes from the player's idosgames.com account and what it lets the player show on their public profile. Everything is off by default except the profile. What the PLAYER shares about themselves on the platform (the Played and Workshop tabs of their profile) is not the publisher's decision and is not configured here. Guests (no platform account) never get platform data. The economy never crosses the bridge."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "SocialInboxVerb": {
        "enum": [
          "Attack",
          "Raid",
          "FriendAdded",
          "WorkshopSale",
          "Followed",
          "Liked",
          "Commented",
          "Replied",
          "Mentioned",
          "ChannelCreated",
          "TipReceived"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Attack",
          "Raid",
          "FriendAdded",
          "WorkshopSale",
          "Followed",
          "Liked",
          "Commented",
          "Replied",
          "Mentioned",
          "ChannelCreated",
          "TipReceived"
        ]
      },
      "PlatformFriendsMode": {
        "enum": [
          "TitleOnly",
          "TitleAndPlatform",
          "PlatformOnly"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TitleOnly",
          "TitleAndPlatform",
          "PlatformOnly"
        ]
      },
      "PlatformProfileMode": {
        "enum": [
          "Off",
          "Default",
          "Always"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Off",
          "Default",
          "Always"
        ]
      }
    },
    "additionalProperties": false
  }

  arguments 113 lines copy
• get_multiplayer unknown never probed

  GET ONLY the 'Multiplayer' field of TitlePublicConfigurationModel. Realtime multiplayer (WebRTC peer-to-peer) - the engine is only the signaling server: it creates rooms, relays WebRTC offer/answer/ICE between room members and optionally relays lobby chat; game traffic then flows directly between players' browsers and never touches the server. The section is ABSENT by default, which means multiplayer is DISABLED: add it (SystemState.Enabled = true) to turn the Multiplayer module on. DefaultTopology: Mesh (everyone connects to everyone, 2-4 players) or Host (star: every player connects to the host, which runs the authoritative game simulation - required by host-authoritative games such as VoxelCraft). MaxPlayersPerRoom is a hard cap (default 8). MemberTimeoutMs is also how long a silent host keeps the host role before another member may take it over. IceServers are PUBLIC: list only STUN servers there; short-lived TURN credentials are issued by the engine to room members on create/join.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_multiplayer unknown never probed

  PARTIAL SAVE: writes ONLY the 'Multiplayer' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Realtime multiplayer (WebRTC peer-to-peer) - the engine is only the signaling server: it creates rooms, relays WebRTC offer/answer/ICE between room members and optionally relays lobby chat; game traffic then flows directly between players' browsers and never touches the server. The section is ABSENT by default, which means multiplayer is DISABLED: add it (SystemState.Enabled = true) to turn the Multiplayer module on. DefaultTopology: Mesh (everyone connects to everyone, 2-4 players) or Host (star: every player connects to the host, which runs the authoritative game simulation - required by host-authoritative games such as VoxelCraft). MaxPlayersPerRoom is a hard cap (default 8). MemberTimeoutMs is also how long a silent host keeps the host role before another member may take it over. IceServers are PUBLIC: list only STUN servers there; short-lived TURN credentials are issued by the engine to room members on create/join.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "MultiplayerDefinitions",
        "properties": {
          "IceServers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/IceServer"
            },
            "description": "Extra ICE servers returned to the client verbatim. PUBLIC data: put only STUN servers here (or a TURN server whose credentials you are fine publishing). Short-lived TURN credentials are issued by the engine itself to room members. Empty = default public STUN servers."
          },
          "RoomLogCap": {
            "type": "integer",
            "format": "int32",
            "description": "How many most-recent broadcast envelopes to keep in the room log (tail trimming)."
          },
          "SystemState": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MultiplayerSystemState"
              }
            ],
            "description": "Global multiplayer feature switch."
          },
          "RoomTtlSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Room key TTL in Redis (seconds). Renewed on every interaction; the room disappears after this many idle seconds."
          },
          "DefaultChatMode": {
            "oneOf": [
              {
                "$ref": "#/definitions/MultiplayerChatMode"
              }
            ],
            "description": "Default chat mode: ServerRelay (chat goes through the server, works in the lobby) or P2P (chat goes over the players' own DataChannel, the server does not relay it)."
          },
          "DefaultTopology": {
            "oneOf": [
              {
                "$ref": "#/definitions/MultiplayerTopology"
              }
            ],
            "description": "Default p2p connection topology for rooms: Mesh (everyone connects to everyone, small rooms) or Host (star: every player connects only to the host, which runs the authoritative simulation)."
          },
          "MemberTimeoutMs": {
            "type": "integer",
            "format": "int32",
            "description": "Threshold (ms) since the last heartbeat after which a member is treated as offline. Also the threshold after which another member may take over the host role of a room whose host stopped responding."
          },
          "MaxChatTextLength": {
            "type": "integer",
            "format": "int32",
            "description": "Max chat message text length (characters)."
          },
          "MaxPlayersPerRoom": {
            "type": "integer",
            "format": "int32",
            "description": "Max players per room (hard cap; the creator may request fewer)."
          },
          "HeartbeatIntervalMs": {
            "type": "integer",
            "format": "int32",
            "description": "Recommended client poll interval (ms) while players are connecting."
          },
          "MaxSignalPayloadBytes": {
            "type": "integer",
            "format": "int32",
            "description": "Max size of a single WebRTC signal payload (bytes). Guards against Redis bloat."
          },
          "MaxRoomLifetimeSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Hard room lifetime in seconds since creation. Unlike RoomTtlSeconds, activity does NOT renew it. When it passes the room is closed (members receive RoomClosed with Kind \"expired\"). Read from the current config. 0 = no limit."
          },
          "AllowCreatorChatOverride": {
            "type": "boolean",
            "description": "Whether the room creator may override the chat mode at creation time."
          },
          "AllowCreatorTopologyOverride": {
            "type": "boolean",
            "description": "Whether the room creator may override the topology at creation time."
          }
        },
        "description": "V2 definition of the title's realtime multiplayer (WebRTC signaling). Public-only data: feature switch, topology/chat defaults, limits, ICE servers."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "IceServer": {
        "type": "object",
        "properties": {
          "Urls": {
            "type": [
              "null",
              "string"
            ]
          },
          "Username": {
            "type": [
              "null",
              "string"
            ]
          },
          "Credential": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "description": "A single ICE server (maps to RTCIceServer on the client)."
      },
      "MultiplayerChatMode": {
        "enum": [
          "ServerRelay",
          "P2P"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ServerRelay",
          "P2P"
        ]
      },
      "MultiplayerTopology": {
        "enum": [
          "Mesh",
          "Host"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Mesh",
          "Host"
        ]
      },
      "MultiplayerSystemState": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean"
          }
        },
        "description": "Global multiplayer feature switch."
      }
    },
    "additionalProperties": false
  }

  arguments 165 lines copy
• get_ai unknown never probed

  GET ONLY the 'AI' field of TitlePublicConfigurationModel. InApp AI generation features of the title - what a PLAYER can generate at runtime through the engine (text/NPC chat, images, video, speech, music, 3D). Enabled is the master switch; Features maps a stable FeatureKey (no '.' or '$') to one feature: its Modality, a Model = the id of a MODE (Text: an AI Coder mode such as "standard") or a TIER (media: an asset generation tier such as "image-balanced") - list the usable ones, with what the publisher's plan allows, with the dashboard action GetInAppAIModels (Text features that AllowImages need a mode that AcceptsImages), Behavior defaults per modality (no platform caps: MaxTokens is bounded only by what the mode's model can produce), Safety prompt checks, an audience Gate (SegmentGate), a Schedule (ScheduleSpec), per-player Limits (LimitSpec) and the in-game PriceOptions the PLAYER pays (in-game resources and/or ONE store purchase per generation - a Purchase entry in the option's base price; never inside PremiumTiers, never two per option). Each generation is charged to the PUBLISHER's credits by the engine at the model's price; per-title spend caps (in credits) live in the PRIVATE config (InAppAIBudget), not here. Server-only section: never sent to the game client or the CDN.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_ai unknown never probed

  PARTIAL SAVE: writes ONLY the 'AI' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. InApp AI generation features of the title - what a PLAYER can generate at runtime through the engine (text/NPC chat, images, video, speech, music, 3D). Enabled is the master switch; Features maps a stable FeatureKey (no '.' or '$') to one feature: its Modality, a Model = the id of a MODE (Text: an AI Coder mode such as "standard") or a TIER (media: an asset generation tier such as "image-balanced") - list the usable ones, with what the publisher's plan allows, with the dashboard action GetInAppAIModels (Text features that AllowImages need a mode that AcceptsImages), Behavior defaults per modality (no platform caps: MaxTokens is bounded only by what the mode's model can produce), Safety prompt checks, an audience Gate (SegmentGate), a Schedule (ScheduleSpec), per-player Limits (LimitSpec) and the in-game PriceOptions the PLAYER pays (in-game resources and/or ONE store purchase per generation - a Purchase entry in the option's base price; never inside PremiumTiers, never two per option). Each generation is charged to the PUBLISHER's credits by the engine at the model's price; per-title spend caps (in credits) live in the PRIVATE config (InAppAIBudget), not here. Server-only section: never sent to the game client or the CDN.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "AIDefinitions",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Master switch. false / missing cfg.AI = InApp AI generation is disabled (every generate request fails)."
          },
          "Features": {
            "type": [
              "null",
              "object"
            ],
            "description": "AI feature catalog: key = stable FeatureKey (\"npc-chat\", \"voxel-world\", \"skin-gen\"). The key becomes a path in the player document, so '.' and '$' are not allowed. A missing key means the feature does not exist.",
            "additionalProperties": {
              "$ref": "#/definitions/AIFeatureDefinition"
            }
          }
        },
        "description": "InApp AI generation features of the title. Bound to cfg.AI. A PLAYER triggers generation at runtime through the engine; models and prices come from the platform model registry, the provider is OpenRouter (3D: Meshy), keys are platform keys. Each generation is charged to the PUBLISHER's credits at the model's price in the same request; the player additionally pays per feature (PriceOptions: in-game resources and/or one store purchase). Server-only section: never projected to the client config or the CDN."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "LimitSpec": {
        "type": "object",
        "properties": {
          "DailyCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap on triggers/actions per calendar day (UTC). 0 = no limit."
          },
          "TotalCap": {
            "type": "integer",
            "format": "int32",
            "description": "Lifetime cap per user. 0 = no limit."
          },
          "MaxPerWindow": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding window: max triggers within WindowSeconds. 0 = disabled."
          },
          "WindowSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Sliding-window length (seconds). Used only when MaxPerWindow > 0."
          },
          "DailyWeightCap": {
            "type": "integer",
            "format": "int64",
            "description": "Cap on weight (e.g. token amount) per calendar day (UTC). 0 = no limit."
          },
          "CooldownSeconds": {
            "type": "integer",
            "format": "int32",
            "description": "Cooldown between triggers (seconds). 0 = no cooldown."
          },
          "PerActivationCap": {
            "type": "integer",
            "format": "int32",
            "description": "Cap within a single activation/session. 0 = no limit."
          }
        },
        "description": "Unified anti-farm limits (\"how much / how often\"). Replaces TriggerLimits (Scheduling), DealNodeLimitsDefinition (DealOffer), StoreOfferRules caps (Store) and ClaimRewardDefinition sliding fields (Reward). 0 on an axis = no limit. Superset of axes with DIFFERENT enforcement semantics: DailyCap/DailyWeightCap = calendar UTC day; MaxPerWindow/WindowSeconds = sliding window. Usually one set is filled per system, the rest = 0. Counters are stored/enforced by each system; this is config thresholds only."
      },
      "AIModality": {
        "enum": [
          "Text",
          "Image",
          "Video",
          "Audio",
          "ThreeD",
          "Music"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Text",
          "Image",
          "Video",
          "Audio",
          "ThreeD",
          "Music"
        ],
        "x-enum-descriptions": [
          "Text (optionally with input images).",
          "Image generation / editing.",
          "Video (asynchronous: submit + poll).",
          "Speech from text (TTS).",
          "3D models (asynchronous: submit + poll), provider Meshy.",
          "Music."
        ]
      },
      "PriceOption": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceConsume"
              }
            ],
            "description": "What is charged for this option. Standard is the base; PremiumDiscounts / PremiumTiers behave as everywhere else. An entry of type Purchase means the option is paid in a store rather than with a player resource: the payment is verified before ResourceService and never enters the resource operation. No initializer on purpose — \"unset\" must differ from \"set to empty\"; an unset Cost means the option is free."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the option (\"For gold\", \"$0.99\"). A localization key or a literal — resolved client-side by the rule own table → fallback table → the key itself."
          },
          "OptionID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Payment-option identifier. If empty, the dictionary key is substituted (PriceOptionResolver) — the client selects an option by this ID, so an option without one would be unselectable."
          },
          "AssetPaths": {
            "type": [
              "null",
              "object"
            ],
            "description": "Option assets (currency icon, discount badge). Key = asset slug.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "AllowedPlatforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms this option is available on. Empty/null = all of them. Do not list Unknown: a client that did not report its platform only gets options with no platform restriction, i.e. those safe everywhere."
          }
        },
        "description": "A single way to pay for an entity. Platform-wide standard: everything with a configured price describes it as a PriceOptions dictionary whose key is the OptionID. Options exist because ResourceConsume.Standard is charged as a whole (AND), while a price across platforms is a choice (OR): a store SKU on mobile, a token on web. Platform duties split as \"the client renders, the server allows\": title config ships as one immutable artifact per (version, field set), so it cannot be filtered per request — the client hides options by AllowedPlatforms, while PriceOptionSelector.Select refuses a charge whose option is not available on the caller's platform."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ScheduleMode": {
        "enum": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "AlwaysOn",
          "Scheduled",
          "Chained",
          "Triggered",
          "Cyclic",
          "Relative"
        ],
        "x-enum-descriptions": [
          "Active whenever enabled, no time gate (eternal leaderboard, manual boost).",
          "Single fixed window [StartUtc..EndUtc] (see ScheduledWindow).",
          "Recurring ordered list of phases (see ScheduleChain).",
          "Activated/granted when a source fires (see ScheduleSpec.ActivationTriggers).",
          "Calendar-aligned cycles with reset (see CyclicSchedule).",
          "Window defined RELATIVE to the parent instance's start (see RelativeWindow). Resolved only when a parent is passed to ScheduleResolver.ResolveActive. Enables staged unlocking of sub-entities inside a recurring event (e.g. \"Day N opens (N-1)x24h after the current cycle instance start\"), so one config auto-repeats without absolute dates."
        ]
      },
      "ScheduleSpec": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleMode"
              }
            ],
            "description": "Activation mode. Determines which sub-field is used."
          },
          "Chain": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleChain"
              }
            ],
            "description": "Chain config. Required and used only when Mode = Chained."
          },
          "Cyclic": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/CyclicSchedule"
              }
            ],
            "description": "Calendar-cycle config. Required and used only when Mode = Cyclic."
          },
          "IsActive": {
            "type": "boolean",
            "description": "Unified global on/off. false = entity paused without deleting config (replaces scattered IsActive/Enabled)."
          },
          "Relative": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/RelativeWindow"
              }
            ],
            "description": "Relative-window config. Required and used only when Mode = Relative."
          },
          "Scheduled": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduledWindow"
              }
            ],
            "description": "Single-window config. Required and used only when Mode = Scheduled."
          },
          "ActivationTriggers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TriggerSource"
            },
            "description": "Sources that cause activation/grant. Required and used only when Mode = Triggered. Matched via TriggerMatcher."
          }
        },
        "description": "\"How an entity activates\" container, embedded into each system's definition. Exactly one sub-field is filled for the chosen Mode (plus ActivationTriggers for Triggered). Resolved via ScheduleResolver."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ResourceGrant": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to grant to all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different rewards for premium players (different ItemID/Target/...). Governed by global cfg.Reward.TierRewards.RewardMode (Additive/Replace) and RewardStackLowerTiers."
          },
          "PremiumBonuses": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBonus"
            },
            "description": "Percentage uplift on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 + Bonus)). Wiped under Mode=Replace if any PremiumTier matches."
          }
        },
        "description": "Grant direction container for ResourceOperation. Two independent premium mechanisms over Standard: PremiumBonuses applies a percentage uplift to Standard (single best tier wins, no stack), and PremiumTiers provides structurally different rewards governed by cfg.Reward.TierRewards (Additive or Replace mode; in Replace the bonused Standard is wiped). Both mechanisms can be used together or independently."
      },
      "ScheduleChain": {
        "type": "object",
        "properties": {
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor date (UTC). The first phase of the first cycle starts here; all subsequent dates are computed from the anchor + phase durations + pauses. null = no anchor → the chain is unconfigured and never resolves."
          },
          "MaxCycles": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum number of full cycles. 0 = infinite."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between full cycles (seconds). 0 = no pause."
          },
          "PauseBetweenPhasesSec": {
            "type": "integer",
            "format": "int32",
            "description": "Pause between phases inside one cycle (seconds). 0 = no pause."
          }
        },
        "description": "Recurring phase chain. Holds ONLY chain timing — the phase list lives on the module (a phase composes ScheduleChainPhase + its payload), so the resolver takes a projected IReadOnlyList<ScheduleChainPhase>. Unified replacement of the schedule parts of EventChainDefinition / LeaderboardChainConfig / BoostChainDefinition / CoopEventChainDefinition / SeasonChainDefinition."
      },
      "TriggerSource": {
        "type": "object",
        "properties": {
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Anti-farm limits of the source — unified LimitSpec (per-day weight cap DailyWeightCap, per-day trigger cap DailyCap, CooldownSeconds). null = no limits (e.g. leaderboards intentionally apply none)."
          },
          "Params": {
            "type": [
              "null",
              "object"
            ],
            "description": "Context parameters for filtering/identifying the source. CustomAction: {\"ActionName\":\"watch_ad\"}. QuestComplete: {\"QuestID\":\"win_5_raids\"} and/or {\"CycleID\":\"daily\"}. StorePurchase: {\"OfferID\":\"starter_pack\"}. MarketplaceSell/MarketplaceBuy: CatalogID / ItemID / OfferType. An unset or empty parameter means \"any\". Keys not listed here are not checked by the matcher.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "BaseWeight": {
            "type": "integer",
            "format": "int64",
            "description": "Base \"weight\" per trigger: token amount (TimedEvent) or score (Leaderboard). Unifies the former BaseAmount/BaseScore. Unused for TimedBoost triggers (a boost has no quantity)."
          },
          "SourceType": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenSourceType"
              }
            ],
            "description": "Source type. Identifies which game event fires."
          },
          "OutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardAttack / BoardRaid / BoardBuild. Whitelist of outcomes. Empty/null = any. BoardAttack: [\"HIT\"]/[\"BLOCKED\"]; BoardRaid: [\"FINISHED_SMALL\"]/[\"FINISHED_MEDIUM\"]/[\"FINISHED_BIG\"]; BoardBuild: [\"BUILD\"]/[\"STAGE_COMPLETE\"]."
          },
          "TileTypeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile types (BoardTileType names or CustomTypeID) that fire on landing. Case-insensitive. Empty/null = any tile (not recommended)."
          },
          "TileIndexFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "integer",
              "format": "int32"
            },
            "description": "Only for SourceType = BoardTileLanding. Whitelist of tile indices. Empty/null = any index. Works in AND with TileTypeFilter."
          },
          "ChanceOutcomeFilter": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Only for SourceType = BoardTileLanding on Chance tiles. Whitelist of ChanceOutcome.OutcomeID values. Case-insensitive. Works in AND with TileTypeFilter/TileIndexFilter. Empty/null = not applied."
          },
          "ScaleWithRollMultiplier": {
            "type": "boolean",
            "description": "Whether BaseWeight scales with the player's RollMultiplier. true: Weight = BaseWeight x M_roll. false: fixed amount."
          }
        },
        "description": "Unified trigger source: which game event grants progress/grant and under which filters. Replaces EventTokenSource (TimedEvent), LeaderboardScoreSource (Leaderboard) and BoostTriggerSource (TimedBoost). SourceType reuses the existing EventTokenSourceType. Matched via TriggerMatcher."
      },
      "AIOutputFormat": {
        "enum": [
          "Text",
          "Json"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Text",
          "Json"
        ]
      },
      "AIOutputSchema": {
        "type": "object",
        "properties": {
          "Enum": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed literal values."
          },
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/AIOutputSchemaType"
              }
            ],
            "description": "Root value type."
          },
          "Items": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AIOutputSchema"
              }
            ],
            "description": "Type = Array: item schema."
          },
          "Maximum": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Type = Number: maximum (inclusive)."
          },
          "Minimum": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Type = Number: minimum (inclusive)."
          },
          "Required": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Type = Object: required keys of Properties."
          },
          "MaxLength": {
            "type": "integer",
            "format": "int32",
            "description": "Type = String: maximum length. 0 = no limit."
          },
          "Properties": {
            "type": [
              "null",
              "object"
            ],
            "description": "Type = Object: object properties.",
            "additionalProperties": {
              "$ref": "#/definitions/AIOutputSchema"
            }
          }
        },
        "description": "A JSON Schema subset used to validate the model's structured response."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "CyclicSchedule": {
        "type": "object",
        "properties": {
          "Reset": {
            "oneOf": [
              {
                "$ref": "#/definitions/ScheduleResetPeriod"
              }
            ],
            "description": "Cycle reset frequency."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "FixedInterval only: anchor instant (coerced to UTC, used as-is including time-of-day) from which IntervalSeconds windows are counted; the anchor defines alignment. null/unset = 2026-01-01 00:00 UTC. Ignored for calendar resets."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after cycle end to claim previous-cycle rewards. 0 = current cycle only."
          },
          "IntervalSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: window length in SECONDS (e.g. 86400 = 1 day, 21600 = 6 hours, 864000 = 10 days). default = 86400 (1 day). Ignored for calendar resets."
          },
          "PauseBetweenCyclesSec": {
            "type": "integer",
            "format": "int64",
            "description": "FixedInterval only: pause (SECONDS) between active windows. 0 = back-to-back. When >0 the cycle 'pulses': active for IntervalSeconds, then a pause of this length (inactive during the pause — CanEarn=false/IsInPause), then the next window. Full period = IntervalSeconds + PauseBetweenCyclesSec. Ignored for calendar resets (they are gapless by definition)."
          }
        },
        "description": "Calendar-aligned cycles with reset. Unified replacement of LeaderboardScheduleMode.Cyclic + LeaderboardCycleReset."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "RelativeWindow": {
        "type": "object",
        "properties": {
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after the window ends for claiming rewards. Default 0."
          },
          "DurationSeconds": {
            "type": "integer",
            "format": "int64",
            "description": "Window length in SECONDS. 0 (or less) = the window lasts until the parent's end (typical for \"stage opens and stays until the event ends\"). >0 = lasts exactly that long (but never longer than the parent)."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after the window ends (until grace ends). Default false."
          },
          "OffsetSecondsFromParentStart": {
            "type": "integer",
            "format": "int64",
            "description": "Window start offset in SECONDS from the parent instance start. 0 = open immediately with the parent. E.g. \"Day N\" = (N-1) * 86400."
          }
        },
        "description": "Window defined RELATIVE to the parent instance's start (see ScheduleMode.Relative). Window start = parent.StartUtc + OffsetSecondsFromParentStart. End = start + DurationSeconds, or (if DurationSeconds <= 0) the parent's end; never extends past the parent's end. Lets one config auto-repeat: sub-entity dates are computed from the current parent instance instead of being written absolutely."
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "ResourceConsume": {
        "type": "object",
        "properties": {
          "Standard": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Base — what to charge all players including F2P."
          },
          "PremiumTiers": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierBundle"
            },
            "description": "Structurally different price for premium players (different ItemID/CurrencyID/Target). Always Replace, single best matching tier wins. If matched, Standard is fully replaced and PremiumDiscounts is ignored; otherwise fallback to Standard + PremiumDiscounts."
          },
          "PremiumDiscounts": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/PremiumTierDiscount"
            },
            "description": "Percentage discount on Standard for premium players. Single best matching tier wins (no stacking): Amount = ceil(Amount * (1 - Discount)). Ignored if any PremiumTier matched — Replace takes over."
          }
        },
        "description": "Consume direction container for ResourceOperation. Two mutually exclusive premium mechanisms over Standard: PremiumTiers (priority) replaces Standard with the best matching tier's Resources via Replace, and PremiumDiscounts (fallback) applies a percentage discount to Standard only when no PremiumTier matched. Best matching tier wins, no stacking."
      },
      "ScheduledWindow": {
        "type": "object",
        "properties": {
          "EndUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window end (UTC). After this, earning stops unless AllowEarningAfterEnd. null = unset -> the window is unconfigured and never active."
          },
          "StartUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Window start (UTC). The entity is active from this moment. null = unset -> the window is unconfigured and never active (BOTH bounds are required)."
          },
          "ClaimGraceHours": {
            "type": "integer",
            "format": "int32",
            "description": "Grace window (hours) after EndUtc for claiming rewards. Default 48."
          },
          "AllowEarningAfterEnd": {
            "type": "boolean",
            "description": "Whether progress can still be earned after EndUtc (until grace ends). Default false."
          }
        },
        "description": "Single fixed-date window. Unified replacement of the schedule parts of ScheduledEventDefinition / LeaderboardScheduledConfig / ScheduledBoostDefinition."
      },
      "AISafetySettings": {
        "type": "object",
        "properties": {
          "BlockedTerms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Forbidden substrings (case-insensitive). A match rejects the request before anything is charged."
          },
          "LockBehavior": {
            "type": "boolean",
            "description": "Forbid the client from overriding behavior (size, voice, image count, etc.): generation runs strictly with feature defaults."
          },
          "MaxPromptChars": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum client prompt length in characters (history included). 0 = no limit."
          },
          "AllowFreePrompt": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the client may send free prompt text when the feature has a PromptTemplate. null = true. false: the client may only send Variables — a free Prompt is rejected."
          }
        },
        "description": "Prompt checks. All optional; absence = no check."
      },
      "PremiumTierBonus": {
        "type": "object",
        "properties": {
          "Bonus": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Bonus as a SHARE: 0.1 = +10%, 1.0 = double (x2). Empty or 0 = no bonus. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage bonus on ResourceGrant.Standard for a premium tier. All Standard Amounts are multiplied by (1 + Bonus) with Math.Ceiling rounding. Applies only to Standard; in Replace mode the bonused Standard is wiped when any PremiumTier matches. Best matching tier wins, bonuses do not stack. Symmetric to PremiumTierDiscount."
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "PremiumTierBundle": {
        "type": "object",
        "properties": {
          "Resources": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Items, currencies and tokens of this tier. Entries with Amount=0 are valid and mean 'skip'. Empty/null Resources in Consume.PremiumTiers means 'premium pays nothing' (equivalent to Discounts: 1.0)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Per-tier bundle describing a structurally different set of resources (different ItemIDs/tokens/currencies) available only to subscribers. Used in both ResourceGrant.PremiumTiers (rewards) and ResourceConsume.PremiumTiers (price). Differs from PremiumTierBonus/PremiumTierDiscount which only modify Standard Amounts by percentage."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "AIBehaviorSettings": {
        "type": "object",
        "properties": {
          "Voice": {
            "type": [
              "null",
              "string"
            ],
            "description": "Audio (TTS): voice identifier of the model."
          },
          "ArtStyle": {
            "type": [
              "null",
              "string"
            ],
            "description": "ThreeD: art style, e.g. \"realistic\" / \"sculpture\"."
          },
          "AllowEdit": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Image: allow the EditImage action on this feature (source images + prompt). Masks are not supported by the gateway."
          },
          "ImageSize": {
            "type": [
              "null",
              "string"
            ],
            "description": "Image: size, e.g. \"1024x1024\"."
          },
          "MaxImages": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Image: maximum images per request (caps the client N). null/0 = 1. No platform cap: as many as the model returns."
          },
          "MaxTokens": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Text: upper bound of response tokens. No platform cap: any value up to what the registry model can produce (its MaxOutputTokens, when known). null = 1024. The publisher's credits are reserved for this bound before the call and the difference is returned after it; a reasoning model spends part of it on thinking."
          },
          "VideoSize": {
            "type": [
              "null",
              "string"
            ],
            "description": "Video: size, e.g. \"1280x720\". The price resolution tier is taken from the smaller side (720x1280 = 720p)."
          },
          "AllowImages": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Text: allow input images (image + description -> text). The registry model must accept image input."
          },
          "AudioFormat": {
            "type": [
              "null",
              "string"
            ],
            "description": "Audio (TTS): output format, e.g. \"mp3\" / \"wav\" / \"opus\"."
          },
          "ImageFormat": {
            "type": [
              "null",
              "string"
            ],
            "description": "Image: output format, e.g. \"png\" / \"jpeg\" / \"webp\"."
          },
          "MusicFormat": {
            "type": [
              "null",
              "string"
            ],
            "description": "Music: output format, \"mp3\" or \"wav\"."
          },
          "ImageQuality": {
            "type": [
              "null",
              "string"
            ],
            "description": "Image: quality, e.g. \"low\" / \"medium\" / \"high\"."
          },
          "OutputFormat": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AIOutputFormat"
              }
            ],
            "description": "Model output format: plain text, or structured JSON validated against OutputSchema. null = Text."
          },
          "OutputSchema": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AIOutputSchema"
              }
            ],
            "description": "Expected JSON response schema (a JSON Schema subset). Required when OutputFormat = Json. A schema instruction is appended to the system prompt automatically; response_format is NOT sent to the provider (incompatible with OpenRouter's require_parameters) — validation happens on our side. A response that fails the schema is a failed generation (owner decision 2026-09-17); money rules are the same as an empty response."
          },
          "ThreeDFormat": {
            "type": [
              "null",
              "string"
            ],
            "description": "ThreeD: model format, e.g. \"glb\" / \"fbx\" / \"obj\" / \"usdz\"."
          },
          "VideoSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Video: duration in seconds (the set of allowed values is defined by the model)."
          },
          "MaxInputImages": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Text / image edit: maximum number of input images per request. No platform cap: as many as the model accepts. null = 1."
          },
          "PromptTemplate": {
            "type": [
              "null",
              "string"
            ],
            "description": "Prompt text with {{var.Name}} placeholders, where Name is a key from PromptVariables. null = the client's free text as before. Substitution happens BEFORE AISafetySettings checks (MaxPromptChars/BlockedTerms validate the FINAL rendered prompt)."
          },
          "HistoryMessages": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Text: how many last history messages the client may pass. 0 = no history (one-shot)."
          },
          "ImageBackground": {
            "type": [
              "null",
              "string"
            ],
            "description": "Image: background, e.g. \"transparent\" / \"opaque\" / \"auto\"."
          },
          "PromptVariables": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/AIPromptVariableDefinition"
            },
            "description": "Variables of PromptTemplate that the client (or a script) must/may supply."
          },
          "ThreeDOperation": {
            "type": [
              "null",
              "string"
            ],
            "description": "ThreeD: operation, \"text-to-3d\" (default) or \"image-to-3d\"."
          },
          "AllowedImageTypes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed MIME types of input images. null = image/png, image/jpeg, image/webp. Checked against the actual file signature, not the declared type."
          },
          "MaxInputImageBytes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum size of one input image in bytes. No platform cap. null = 4194304 (4 MB)."
          },
          "SystemInstructions": {
            "type": [
              "null",
              "string"
            ],
            "description": "Text: system instruction (NPC persona, answer format, rules). Never returned to the player."
          },
          "AllowReferenceImage": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Video: allow a reference image from the client."
          }
        },
        "description": "Generation behavior. A SINGLE container for all modalities, filled per modality. Values are feature defaults; the client may override some (size, voice, image count) unless Safety.LockBehavior is set."
      },
      "AIOutputSchemaType": {
        "enum": [
          "Object",
          "Array",
          "String",
          "Number",
          "Boolean"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Object",
          "Array",
          "String",
          "Number",
          "Boolean"
        ]
      },
      "AIFeatureDefinition": {
        "type": "object",
        "properties": {
          "Gate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who the feature is available to. null/empty = everyone. Unified platform gate (SegmentGateEvaluator.Passes)."
          },
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "UI tags for grouping. Do not affect server logic."
          },
          "Model": {
            "type": [
              "null",
              "string"
            ],
            "description": "Id of a MODE (Text: an AI Coder mode, e.g. \"standard\") or a TIER (media: an asset generation tier, e.g. \"image-balanced\") from v2/title/GetInAppAIModels. Required. The engine resolves it to the model at generation time. The client can never choose the model: generation is paid by the publisher."
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/LimitSpec"
              }
            ],
            "description": "Per-player anti-farm limits (daily / total / cooldown). Counters live in UserDataDocument.AI. 0 on an axis = no limit."
          },
          "Reward": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceGrant"
              }
            ],
            "description": "Fixed reward granted to the player exactly ONCE when the generation reaches 'completed'. null = no reward. A reward that depends on the AI's actual output is computed and granted by a CloudCode handler instead (see Integrations), via server.ApplyResourceOperation. Same type as a quest reward (resolved against the player's premium bonuses/tiers) — EXCEPT when it contains a crypto currency entry: then PremiumBonuses/PremiumTiers must be empty, so the pool debit amount is deterministic."
          },
          "Safety": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AISafetySettings"
              }
            ],
            "description": "Prompt checks applied before generation."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Per-feature switch. false = the feature is configured but requests fail."
          },
          "Behavior": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AIBehaviorSettings"
              }
            ],
            "description": "Generation behavior (single container, fields are filled per modality)."
          },
          "Modality": {
            "oneOf": [
              {
                "$ref": "#/definitions/AIModality"
              }
            ],
            "description": "Generation modality. Determines the client action and the relevant Behavior section."
          },
          "Schedule": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ScheduleSpec"
              }
            ],
            "description": "When the feature is available. null = always. Resolved by ScheduleResolver."
          },
          "ServerStart": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AIServerStartSettings"
              }
            ],
            "description": "Allows and configures starting THIS feature from CloudCode (server.StartAIGeneration). null/Enabled=false: scripts cannot start it (the client path is unaffected)."
          },
          "Integrations": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/AIFeatureIntegrations"
              }
            ],
            "description": "Links generation outcomes to other platform modules: quest progress, analytics, a CloudCode handler."
          },
          "PriceOptions": {
            "type": [
              "null",
              "object"
            ],
            "description": "Price of one generation FOR THE PLAYER. Key = PriceOption.OptionID. null/empty = free for the player. An option is priced in in-game resources (the publisher's game economy) and/or ONE store purchase (a Purchase entry in Cost.Standard): one purchase pays for exactly one generation; the client sends the receipt as Payment and finishes the store transaction only when the generation reports PaymentSettled = true (a failed generation keeps the receipt valid for a retry). A store purchase inside PremiumTiers, or more than one per option, is not allowed.",
            "additionalProperties": {
              "$ref": "#/definitions/PriceOption"
            }
          }
        },
        "description": "A single InApp AI feature: what is generated, by which registry model, how, for whom, when, with which limits and at what in-game price for the player."
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "PremiumTierDiscount": {
        "type": "object",
        "properties": {
          "Discount": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Discount as a SHARE: 0.1 = -10%, 1.0 = free. Empty or 0 = no discount. The unit is the same across the whole platform — never a 0..100 percent."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum tier required to qualify for this modifier."
          },
          "RequiredPremiumID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional specific subscription ID. null = any subscription matching MinPremiumTier."
          }
        },
        "description": "Percentage discount on ResourceConsume.Standard for a premium tier. All Standard Amounts are multiplied by (1 - Discount) with Math.Ceiling rounding in player's favor. Applies only to Standard; ignored if PremiumTiers matches. Best matching tier wins, discounts do not stack. Symmetric to PremiumTierBonus."
      },
      "ScheduleResetPeriod": {
        "enum": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Hourly",
          "Daily",
          "Weekly",
          "Monthly",
          "Yearly",
          "FixedInterval",
          "Never"
        ],
        "x-enum-descriptions": [
          null,
          null,
          null,
          null,
          null,
          "Every CyclicSchedule.IntervalSeconds seconds from CyclicSchedule.AnchorUtc — a fixed interval, not calendar-aligned (e.g. \"every 6 hours\" or \"every 10 days\"). Alignment is defined by the anchor.",
          "No reset — eternal (all-time) instance."
        ]
      },
      "AIPromptVariableType": {
        "enum": [
          "String",
          "Number",
          "Enum"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "String",
          "Number",
          "Enum"
        ],
        "x-enum-descriptions": [
          null,
          null,
          "Like String, but the VALUE must be one of AIPromptVariableDefinition.Enum."
        ]
      },
      "AIServerStartPricing": {
        "enum": [
          "ScriptDecides",
          "Free",
          "FeaturePrice"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "ScriptDecides",
          "Free",
          "FeaturePrice"
        ],
        "x-enum-descriptions": [
          "The script passes ChargePlayer/SelectedOptionID per call.",
          "The player pays nothing (only the publisher's credits and title caps apply).",
          "The player pays exactly as on a normal client-triggered generation (PriceOptions, except IAP options — there is no receipt)."
        ]
      },
      "EventTokenSourceType": {
        "enum": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "BoardTileLanding",
          "BoardPassStart",
          "BoardAttack",
          "BoardRaid",
          "BoardBuild",
          "BoardStageComplete",
          "BoardSpecialComplete",
          "QuestComplete",
          "StorePurchase",
          "DailyLogin",
          "ReferralInvite",
          "MilestoneReward",
          "CustomAction",
          "LeaderboardRankReward",
          "MarketplaceSell",
          "MarketplaceBuy",
          "CurrencySpent",
          "LootboxOpened",
          "IapPurchase",
          "CryptoDeposit",
          "CryptoWithdraw",
          "CryptoSpent",
          "CurrencyEarned",
          "CryptoEarned"
        ],
        "x-enum-descriptions": [
          "Landing on an EventToken tile on the board.",
          "Passing start (GO) on the board.",
          "Successful board attack.",
          "Successful board raid.",
          "Building or repairing a structure on the board.",
          "Completing a board stage.",
          "Completing a board Special mode — either via Instant choice or via Claim after the Timed window. Post-resolution source (mirrors BoardAttack/BoardRaid): fires at the final Special reward grant, separately from BoardTileLanding (which fires on the actual tile landing during Roll).",
          "Completing a quest.",
          "Store purchase.",
          "Daily login.",
          "Referral invite.",
          "Token grant as a reward for a milestone or streak in another event. Server-only source — the client cannot invoke it directly.",
          "Arbitrary action — the developer calls the server API with ActionName in Params.",
          null,
          "Marketplace (v2) sale — deal settlement on the seller side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "Marketplace (v2) purchase — deal settlement on the buyer side. Server-only source. Filter Params: CatalogID / ItemID / OfferType.",
          "In-game currency spend — any scenario where a resource operation actually consumed currency. Server-only source. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "Opening a lootbox/chest. Server-only source. The multiplier equals how many boxes were opened in the call. Filter Params: LootboxID.",
          "Real-money store purchase (IAP). Server-only source: fired in PurchaseV2 AFTER the receipt is verified and rewards are granted. The multiplier equals the number of product units granted. Filter Params: ProductID, Store. Deliberately separate from StorePurchase, which covers in-game currency spending.",
          "Crypto deposit credited to the in-game balance. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Crypto withdrawal CONFIRMED on chain. Multiplier is 1 (one operation). Filter Params: CurrencyID, NetworkID.",
          "Spending crypto currency in-game. The multiplier equals the amount spent. Filter Params: CurrencyID.",
          "In-game currency GRANT — mirror of CurrencySpent. The multiplier equals the amount granted, so ScaleWithRollMultiplier picks the meaning: \"earn N currency\" or \"receive currency N times\". Filter Params: CurrencyID and Origin (\"Gameplay\" | \"RewardClaim\"), the latter separating gameplay earnings from reward payouts — without it a goal like \"earn N\" would be closed by another quest's reward.",
          "CRYPTO currency GRANT in-game (wallet deposits are NOT included — that is CryptoDeposit). The multiplier equals the amount granted. Filter Params: CurrencyID, Origin."
        ]
      },
      "AIFeatureIntegrations": {
        "type": "object",
        "properties": {
          "TriggerOnFailed": {
            "type": [
              "null",
              "string"
            ],
            "description": "CloudCode handler on failure (the error is in args; the player was already refunded before this call)."
          },
          "TriggerOnCompleted": {
            "type": [
              "null",
              "string"
            ],
            "description": "CloudCode handler on success — handlers.<name> of the active revision. Receives the result's text/JSON/assets and may call server.ApplyResourceOperation (a reward that depends on the AI's actual output), write to a data collection, chain another generation, etc."
          },
          "AnalyticsEventOnFailed": {
            "type": [
              "null",
              "string"
            ],
            "description": "Custom analytics event fired when the generation fails."
          },
          "QuestMetricOnCompleted": {
            "type": [
              "null",
              "string"
            ],
            "description": "Quest progress: an objective with Source = ServerApi and this MetricID advances by 1 for the generating player when the generation completes successfully."
          },
          "AnalyticsEventOnCompleted": {
            "type": [
              "null",
              "string"
            ],
            "description": "Custom analytics event fired when the generation completes successfully."
          }
        },
        "description": "Links a generation's outcome to other platform modules. Side-effect work AFTER the outcome is already committed (money charged/refunded) — one consumer's failure never undoes what happened or blocks the others."
      },
      "AIServerStartSettings": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Master switch for starting this feature from CloudCode."
          },
          "Pricing": {
            "oneOf": [
              {
                "$ref": "#/definitions/AIServerStartPricing"
              }
            ],
            "description": "Who pays the PLAYER-facing price (the publisher's credits and title caps always apply regardless of this field — it only decides what the PLAYER sees charged). Default: the script decides per call."
          },
          "ApplyGate": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the feature's audience Gate applies to a server-started generation. null = true."
          },
          "ApplyPlayerLimits": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the player's per-feature limits (daily/total/cooldown) apply to a server-started generation. null = true."
          }
        },
        "description": "Who pays when the feature is started from CloudCode, and which checks apply."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "AIPromptVariableDefinition": {
        "type": "object",
        "properties": {
          "Enum": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed values (checked as strings after coercion, for any Type)."
          },
          "Name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name without '.'/'$' — referenced as {{var.Name}} in the template."
          },
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/AIPromptVariableType"
              }
            ],
            "description": "Value type."
          },
          "Required": {
            "type": "boolean",
            "description": "Whether the caller must supply this variable."
          },
          "MaxLength": {
            "type": "integer",
            "format": "int32",
            "description": "String type only. 0 = no limit."
          }
        },
        "description": "A single prompt template variable."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      }
    },
    "additionalProperties": false
  }

  arguments 1740 lines copy
• get_analytics unknown never probed

  GET ONLY the 'Analytics' field of TitlePublicConfigurationModel. Custom events - Firebase Analytics parity. The game sends its own events (logEvent(name, params, value)); the engine stores them per player per UTC day and the dashboard reports counts, unique players, value sums and breakdowns by platform, app version, OS, device, language, country, new/returning and acquisition source; A/B experiment goals and custom funnel steps can use these events. Enabled is the master switch and defaults to OFF. EventNaming: "Open" (any valid name is accepted and joins the title's event catalog up to the PLAN limit) or "Declared" (only names listed in Events). Events maps an event name (^[A-Za-z][A-Za-z0-9_]{0,39}$; prefixes idos_/firebase_/google_/ga_ are reserved, except the automatic idos_* events) to a display name, description and a Blocked flag. Dimensions registers event parameters as reporting dimensions (like GA4 custom dimensions) - the count is capped by the plan; unregistered parameters are accepted but not stored. RetentionDays is how long per-player event data is kept (default 90, capped by the plan); daily title summaries are kept forever. AutomaticEvents (default on) accepts the SDK's automatic events: idos_first_open, idos_session_start, idos_app_update, idos_os_update, idos_screen_view.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_analytics unknown never probed

  PARTIAL SAVE: writes ONLY the 'Analytics' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Custom events - Firebase Analytics parity. The game sends its own events (logEvent(name, params, value)); the engine stores them per player per UTC day and the dashboard reports counts, unique players, value sums and breakdowns by platform, app version, OS, device, language, country, new/returning and acquisition source; A/B experiment goals and custom funnel steps can use these events. Enabled is the master switch and defaults to OFF. EventNaming: "Open" (any valid name is accepted and joins the title's event catalog up to the PLAN limit) or "Declared" (only names listed in Events). Events maps an event name (^[A-Za-z][A-Za-z0-9_]{0,39}$; prefixes idos_/firebase_/google_/ga_ are reserved, except the automatic idos_* events) to a display name, description and a Blocked flag. Dimensions registers event parameters as reporting dimensions (like GA4 custom dimensions) - the count is capped by the plan; unregistered parameters are accepted but not stored. RetentionDays is how long per-player event data is kept (default 90, capped by the plan); daily title summaries are kept forever. AutomaticEvents (default on) accepts the SDK's automatic events: idos_first_open, idos_session_start, idos_app_update, idos_os_update, idos_screen_view.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "AnalyticsDefinitions",
        "properties": {
          "Events": {
            "type": [
              "null",
              "object"
            ],
            "description": "Described events keyed by event name. In Declared mode the only accepted names; in Open mode — display names and blocks.",
            "additionalProperties": {
              "$ref": "#/definitions/AnalyticsEventDefinition"
            }
          },
          "Enabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Master switch. Unset = off: events are dropped without touching the database, and the SDK does not send them."
          },
          "Dimensions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/AnalyticsDimensionDefinition"
            },
            "description": "Event parameters registered as dimensions (like GA4 custom dimensions): reports can break events down by them. Unregistered parameters are accepted but not stored. Count is capped by the plan."
          },
          "EventNaming": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event naming mode: \"Open\" (default — any valid name is accepted and joins the title's event catalog up to the plan limit) or \"Declared\" (only names listed in Events are accepted)."
          },
          "RetentionDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Retention of per-player event data, days. Unset = 90 (or the plan maximum if lower). Clamped to the plan maximum. Daily title summaries are kept forever."
          },
          "AutomaticEvents": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Automatic SDK events (idos_first_open, idos_session_start, idos_app_update, idos_os_update, idos_screen_view). Unset = on: DAU and sessions by version/platform/device are computed from them."
          }
        },
        "description": "Custom events (Firebase Analytics parity). Everything here is chosen by the publisher within their plan's analytics limits. Absent section or Enabled != true = events are not stored and cost no database access."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "AnalyticsEventDefinition": {
        "type": "object",
        "properties": {
          "Blocked": {
            "type": "boolean",
            "description": "Blocked: events with this name are dropped in any naming mode."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "What the event means and when the game sends it."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for the dashboard."
          }
        },
        "description": "A described custom event."
      },
      "AnalyticsDimensionDefinition": {
        "type": "object",
        "properties": {
          "ParamName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Parameter name as the game sends it (^[A-Za-z][A-Za-z0-9_]{0,39}$)."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name for the dashboard."
          }
        },
        "description": "An event parameter registered as a reporting dimension."
      }
    },
    "additionalProperties": false
  }

  arguments 116 lines copy
• get_data_collections unknown never probed

  GET ONLY the 'DataCollections' field of TitlePublicConfigurationModel. Data collections - the creator's own data structures, a Firebase/Supabase-like store inside the platform for games, apps and sites. USE A READY PLATFORM MODULE FIRST (currencies, items, store, lootboxes, quests, leaderboards, chat, social, workshop, match, season, tutorial, localization, push, analytics); declare a collection only for what no module provides (guilds, auctions, orders, catalogs, articles, saved levels, feeds, mail) or for extra data attached to module entities. NEVER store currencies or items inside a record: reference them with a Ref field (Kind Item/Currency/User/…) and move value with Economy (Cost/Grant in engine resource format, charged in the same transaction as the write). Collections maps a collection id (letters, digits, '_', '-', ':' up to 64; a front-end module prefixes its namespace, e.g. 'guild-system:guilds') to: Kind (UserOwned: each record belongs to one user; Shared: records used by many users; Temporary: short-lived, mandatory TTL up to 30 days; Log: append-only, read by time); Mode (Strict = only declared fields); Fields (String, Text = searchable by words, Int, Number, Bool, Date, Json, Array with ItemType, Ref with Ref.Kind, File) with Required/Default (JSON literal)/Min/Max/MaxLength/MaxItems/Enum/Unique/Indexed/Visibility (Everyone/Owner/Server)/ClientWritable=false for server-only fields/Immutable; SortKeys (id + 1..4 components, each a scalar field or createdAt/updatedAt, optionally Descending) - every ordered query uses one, and equality filters on its leading components narrow the range; Access with Read/Create/Update/Delete lists of rules OR-ed together (Anyone - Read only, Authenticated, Owner, Members with MembersField = an Array of Ref(User), Role with a role id from Roles, Server); Limits (MaxItemBytes, MaxItemsPerOwner, TtlSeconds); OnOwnerDeleted (Delete/Anonymize/Keep); Counters (Count or Sum, optional GroupBy - maintained atomically, not allowed for expiring records); Integrations (QuestMetricOnCreate/Update/Delete advance quest objectives with Source ServerApi, AnalyticsEventOn*, TriggerOn* run a CloudCode handler asynchronously); Moderation.BlockedTerms; WriteGate (SegmentGate); PublicViews (published to the CDN for anonymous/site reads: SortKey, optional PartitionField, PageSize, MaxItems, PublishItems) and AnonymousSearch. Queries from a game may filter ONLY by Indexed fields and sort ONLY by declared SortKeys - there are no table scans on the shared cluster. Roles lists title user roles; they are assigned only by CloudCode (server.SetUserRoles) and the dashboard. The count of collections, searchable fields, sort keys, record size and storage are capped by the plan. Records themselves are NOT here - they live in the engine's DataCollection* collections; CloudCode reads and writes them with server.GetDataItem/QueryDataItems/CreateDataItem/UpdateDataItem/DeleteDataItem/BatchDataItems/GetDataCounter.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_data_collections unknown never probed

  PARTIAL SAVE: writes ONLY the 'DataCollections' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Data collections - the creator's own data structures, a Firebase/Supabase-like store inside the platform for games, apps and sites. USE A READY PLATFORM MODULE FIRST (currencies, items, store, lootboxes, quests, leaderboards, chat, social, workshop, match, season, tutorial, localization, push, analytics); declare a collection only for what no module provides (guilds, auctions, orders, catalogs, articles, saved levels, feeds, mail) or for extra data attached to module entities. NEVER store currencies or items inside a record: reference them with a Ref field (Kind Item/Currency/User/…) and move value with Economy (Cost/Grant in engine resource format, charged in the same transaction as the write). Collections maps a collection id (letters, digits, '_', '-', ':' up to 64; a front-end module prefixes its namespace, e.g. 'guild-system:guilds') to: Kind (UserOwned: each record belongs to one user; Shared: records used by many users; Temporary: short-lived, mandatory TTL up to 30 days; Log: append-only, read by time); Mode (Strict = only declared fields); Fields (String, Text = searchable by words, Int, Number, Bool, Date, Json, Array with ItemType, Ref with Ref.Kind, File) with Required/Default (JSON literal)/Min/Max/MaxLength/MaxItems/Enum/Unique/Indexed/Visibility (Everyone/Owner/Server)/ClientWritable=false for server-only fields/Immutable; SortKeys (id + 1..4 components, each a scalar field or createdAt/updatedAt, optionally Descending) - every ordered query uses one, and equality filters on its leading components narrow the range; Access with Read/Create/Update/Delete lists of rules OR-ed together (Anyone - Read only, Authenticated, Owner, Members with MembersField = an Array of Ref(User), Role with a role id from Roles, Server); Limits (MaxItemBytes, MaxItemsPerOwner, TtlSeconds); OnOwnerDeleted (Delete/Anonymize/Keep); Counters (Count or Sum, optional GroupBy - maintained atomically, not allowed for expiring records); Integrations (QuestMetricOnCreate/Update/Delete advance quest objectives with Source ServerApi, AnalyticsEventOn*, TriggerOn* run a CloudCode handler asynchronously); Moderation.BlockedTerms; WriteGate (SegmentGate); PublicViews (published to the CDN for anonymous/site reads: SortKey, optional PartitionField, PageSize, MaxItems, PublishItems) and AnonymousSearch. Queries from a game may filter ONLY by Indexed fields and sort ONLY by declared SortKeys - there are no table scans on the shared cluster. Roles lists title user roles; they are assigned only by CloudCode (server.SetUserRoles) and the dashboard. The count of collections, searchable fields, sort keys, record size and storage are capped by the plan. Records themselves are NOT here - they live in the engine's DataCollection* collections; CloudCode reads and writes them with server.GetDataItem/QueryDataItems/CreateDataItem/UpdateDataItem/DeleteDataItem/BatchDataItems/GetDataCounter.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "DataCollectionsDefinitions",
        "properties": {
          "Roles": {
            "type": [
              "null",
              "object"
            ],
            "description": "Title user roles (admin, editor, moderator…) referenced by 'Role' access rules. Key = role id. Roles are assigned only by the server (CloudCode) and the dashboard, never by the client.",
            "additionalProperties": {
              "$ref": "#/definitions/DataCollectionRoleDefinition"
            }
          },
          "Enabled": {
            "type": "boolean",
            "description": "Master switch. Default false — data collections must be enabled explicitly."
          },
          "Collections": {
            "type": [
              "null",
              "object"
            ],
            "description": "Collections of the title. Key = collection id ('guilds', 'orders'; a front-end module prefixes its namespace: 'guild-system:guilds'). Allowed: letters, digits, '_', '-', ':' up to 64 chars. No '.' or '$'.",
            "additionalProperties": {
              "$ref": "#/definitions/DataCollectionDefinition"
            }
          }
        },
        "description": "Title data collections: a Firebase/Supabase-like store inside the platform. The creator declares structures (collections) with typed fields, searchable fields, sort keys, access rules and limits; the platform enforces tenant isolation, access, indexes, limits, deletion and billing. Use a ready platform module first (currency, items, store, quests, leaderboards, chat, workshop…); use collections only for what no module provides, or for extra data attached to module entities. Never store currencies/items in a collection — reference them and move value through the engine economy (Cost/Grant)."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "DataRefKind": {
        "enum": [
          "DataItem",
          "User",
          "Item",
          "Currency",
          "ItemInstance",
          "StoreOffer",
          "Leaderboard",
          "Quest",
          "WorkshopContent"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "DataItem",
          "User",
          "Item",
          "Currency",
          "ItemInstance",
          "StoreOffer",
          "Leaderboard",
          "Quest",
          "WorkshopContent"
        ],
        "x-enum-descriptions": [
          "A record of a data collection (Ref.Collection).",
          "A user of this title (user id).",
          "An item definition of the title's Item config (\"CatalogID/ItemID\" or a unique ItemID).",
          "A currency of the title's Currency config (virtual or crypto currency id).",
          "A player's item instance id (non-stackable item).",
          "A store offer id.",
          "A leaderboard id.",
          "A quest id.",
          "A workshop publication id."
        ]
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "DataFieldType": {
        "enum": [
          "String",
          "Text",
          "Int",
          "Number",
          "Bool",
          "Date",
          "Json",
          "Array",
          "Ref",
          "File"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "String",
          "Text",
          "Int",
          "Number",
          "Bool",
          "Date",
          "Json",
          "Array",
          "Ref",
          "File"
        ],
        "x-enum-descriptions": [
          "A string (up to MaxLength characters, default 256).",
          "Long text searched by words and word prefixes (up to MaxLength characters, default 4000).",
          "A 64-bit integer.",
          "A floating point number.",
          "true / false.",
          "A date-time in UTC (ISO-8601 string or unix ms on input).",
          "Any JSON value (not searchable). Size limited by MaxLength bytes.",
          "An array. Element type is ItemType. Arrays of scalars are searchable with array-contains.",
          "A reference to another entity: a record of a collection, a user, an item, a currency, an item instance, a store offer, a leaderboard, a quest, a workshop publication. Validated on write, expandable on read.",
          "A file stored in the platform's private bucket; the record keeps a reference and clients get signed URLs."
        ]
      },
      "DataRefTarget": {
        "type": "object",
        "properties": {
          "Kind": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataRefKind"
              }
            ],
            "description": "What the reference points to."
          },
          "Validate": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Check that the target exists on write. null = yes."
          },
          "Collection": {
            "type": [
              "null",
              "string"
            ],
            "description": "For DataItem: the target collection id."
          }
        },
        "description": "Reference target."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "DataAccessMode": {
        "enum": [
          "Anyone",
          "Authenticated",
          "Owner",
          "Members",
          "Role",
          "Server"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Anyone",
          "Authenticated",
          "Owner",
          "Members",
          "Role",
          "Server"
        ],
        "x-enum-descriptions": [
          "Anyone, including visitors without a session (Read only; served from the CDN / cache, never straight from the database).",
          "Any signed-in user of the title.",
          "The owner of the record.",
          "A user listed in the record's MembersField.",
          "A user who has the Role.",
          "Server only (CloudCode, dashboard)."
        ]
      },
      "DataAccessRule": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataAccessMode"
              }
            ],
            "description": "Who the rule admits."
          },
          "Role": {
            "type": [
              "null",
              "string"
            ],
            "description": "For Role: the role id from DataCollections.Roles."
          },
          "MembersField": {
            "type": [
              "null",
              "string"
            ],
            "description": "For Members: the name of an Array field of Ref(User) listing the members."
          }
        },
        "description": "One access rule."
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "DataCounterKind": {
        "enum": [
          "Count",
          "Sum"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Count",
          "Sum"
        ],
        "x-enum-descriptions": [
          "Number of records.",
          "Sum of a numeric field."
        ]
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "DataSortComponent": {
        "type": "object",
        "properties": {
          "Field": {
            "type": [
              "null",
              "string"
            ],
            "description": "Field name, or the built-in 'createdAt' / 'updatedAt'."
          },
          "Descending": {
            "type": "boolean",
            "description": "Descending order for this component."
          }
        },
        "description": "One component of a sort key."
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "DataCollectionKind": {
        "enum": [
          "UserOwned",
          "Shared",
          "Temporary",
          "Log"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "UserOwned",
          "Shared",
          "Temporary",
          "Log"
        ],
        "x-enum-descriptions": [
          "Each record belongs to one user (saves, builds, orders, documents, settings).",
          "Records shared by many users (guilds, auctions, catalog, articles, world shards, tournaments).",
          "Short-lived records with a mandatory TTL (invites, requests, lobbies, carts, codes).",
          "Append-only records read by time (battle history, feed, order journal, messages, audit). No updates."
        ]
      },
      "DataFieldDefinition": {
        "type": "object",
        "properties": {
          "Max": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Maximum (numbers and dates as unix ms)."
          },
          "Min": {
            "type": [
              "null",
              "number"
            ],
            "format": "double",
            "description": "Minimum (numbers and dates as unix ms)."
          },
          "Ref": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataRefTarget"
              }
            ],
            "description": "Reference target for Ref fields (and arrays of Ref)."
          },
          "Enum": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed values for String fields."
          },
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataFieldType"
              }
            ],
            "description": "Field type."
          },
          "Unique": {
            "type": "boolean",
            "description": "Value must be unique within the collection (email, slug, nickname). Enforced by the database inside the write transaction."
          },
          "Default": {
            "type": [
              "null",
              "string"
            ],
            "description": "Default value as a JSON literal (1, \"EU\", true, []). Applied on create when the field is absent."
          },
          "Indexed": {
            "type": "boolean",
            "description": "The field can be used in query filters (equality, in, range, array-contains, prefix). Queries from a game/app may filter ONLY by searchable fields. Text fields are searched by words and word prefixes."
          },
          "ItemType": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataFieldType"
              }
            ],
            "description": "Element type for Array fields (a scalar type or Ref). null = Json elements."
          },
          "MaxItems": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum number of elements for Array fields."
          },
          "Required": {
            "type": "boolean",
            "description": "The field must be present on create."
          },
          "Immutable": {
            "type": "boolean",
            "description": "The field cannot be changed after creation."
          },
          "MaxLength": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum length: characters for String/Text, UTF-8 bytes for Json."
          },
          "Visibility": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataFieldVisibility"
              }
            ],
            "description": "Who can see the field: Everyone (default), Owner (the record owner only), Server (CloudCode and dashboard only)."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Developer-facing description of the field."
          },
          "MaxFileBytes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "File fields: maximum file size in bytes. null = 10 MB; at most 100 MB. Files live in the platform's private bucket, count toward the publisher's storage and are read through short-lived signed links."
          },
          "ClientWritable": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "false = only the server (CloudCode, dashboard) writes this field — scores, guild level, order status. Client writes to it are rejected. null = client-writable."
          },
          "AllowedMimeTypes": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "File fields: allowed content types (image/png, image/jpeg, image/webp, image/gif, application/json, model/gltf+json, model/gltf-binary, application/zip, text/plain, application/octet-stream). null = any of them. The server checks the real file signature against the declared type."
          },
          "UniqueIgnoreCase": {
            "type": "boolean",
            "description": "Uniqueness ignores letter case (only for String fields with Unique)."
          }
        },
        "description": "A record field."
      },
      "DataFieldVisibility": {
        "enum": [
          "Everyone",
          "Owner",
          "Server"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Everyone",
          "Owner",
          "Server"
        ],
        "x-enum-descriptions": [
          "Visible to everyone who can read the record.",
          "Visible only to the record owner.",
          "Never returned to clients: CloudCode and dashboard only."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "DataCollectionAccess": {
        "type": "object",
        "properties": {
          "Read": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DataAccessRule"
            },
            "description": "Who can read records."
          },
          "Create": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DataAccessRule"
            },
            "description": "Who can create records. For UserOwned the creator becomes the owner; for Shared the creator becomes the owner when the rule is Authenticated/Owner."
          },
          "Delete": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DataAccessRule"
            },
            "description": "Who can delete records."
          },
          "Update": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DataAccessRule"
            },
            "description": "Who can update records."
          }
        },
        "description": "Access rules. Each operation takes a list of rules combined with OR. null/empty list = Server only. The server (CloudCode, dashboard) is never restricted by these rules."
      },
      "DataCollectionLimits": {
        "type": "object",
        "properties": {
          "TtlSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Record lifetime in seconds. Mandatory for Temporary (max 30 days). For Log it is the retention (capped by the plan). null for UserOwned/Shared = permanent."
          },
          "MaxItemBytes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum record size in bytes (serialized data). null = 16384, capped by the plan."
          },
          "MaxItemsPerOwner": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Maximum records one user may own in this collection. null = unlimited (within the title limit)."
          }
        },
        "description": "Collection limits. Every value is additionally capped by the title's plan."
      },
      "DataOperationEconomy": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "What is charged (engine resources)."
          },
          "Grant": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "What is granted (engine resources)."
          }
        },
        "description": "Cost and grant of one operation."
      },
      "DataCollectionEconomy": {
        "type": "object",
        "properties": {
          "OnCreate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataOperationEconomy"
              }
            ],
            "description": "Create: Cost is charged from the creator, Grant is given to the creator."
          },
          "OnDelete": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataOperationEconomy"
              }
            ],
            "description": "Delete by a client: Cost and Grant (e.g. a refund) for the caller."
          },
          "OnUpdate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataOperationEconomy"
              }
            ],
            "description": "Update by a client: Cost and Grant for the caller."
          }
        },
        "description": "Economy of client operations. Charged/granted in the same transaction as the write, idempotent per record operation."
      },
      "DataCounterDefinition": {
        "type": "object",
        "properties": {
          "ID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Counter id (letters, digits, '_')."
          },
          "Kind": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataCounterKind"
              }
            ],
            "description": "Count: number of records. Sum: sum of SumField."
          },
          "GroupBy": {
            "type": [
              "null",
              "string"
            ],
            "description": "Group by the value of a scalar field (e.g. members per guild, orders per status). null = one total per collection."
          },
          "SumField": {
            "type": [
              "null",
              "string"
            ],
            "description": "For Sum: an Int or Number field."
          },
          "Visibility": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataFieldVisibility"
              }
            ],
            "description": "Who can read the counter: Everyone (default) or Server."
          }
        },
        "description": "A declared aggregate maintained on every write."
      },
      "DataSortKeyDefinition": {
        "type": "object",
        "properties": {
          "ID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Sort key id (letters, digits, '_')."
          },
          "Components": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DataSortComponent"
            },
            "description": "Components in order. Each is a scalar field (String, Int, Number, Bool, Date) or the built-in 'createdAt' / 'updatedAt'."
          }
        },
        "description": "A declared sort key: one or more components. Queries order by a sort key; equality filters on its leading components select the range ('region = EU, by score')."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "DataOwnerDeletedPolicy": {
        "enum": [
          "Delete",
          "Anonymize",
          "Keep"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Delete",
          "Anonymize",
          "Keep"
        ],
        "x-enum-descriptions": [
          "Records owned by the user are deleted (default).",
          "The owner is removed, the record stays (e.g. a guild outlives its founder).",
          "Records are kept as they are. The new owner of the same user id still does NOT inherit them (ownership is checked against the registration date)."
        ]
      },
      "DataCollectionDefinition": {
        "type": "object",
        "properties": {
          "Kind": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataCollectionKind"
              }
            ],
            "description": "Data class — decides physical storage, indexes and lifetime. UserOwned: each record belongs to one user (saves, orders, builds). Shared: records shared by many users (guilds, auctions, catalog, articles). Temporary: short-lived records with a mandatory TTL (invites, lobbies, carts). Log: append-only records read by time (history, feed, messages, audit)."
          },
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataCollectionSchemaMode"
              }
            ],
            "description": "Strict: only declared fields are accepted. Loose: declared fields are validated, undeclared ones are accepted as free-form JSON (not searchable)."
          },
          "Tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Free-form tags (grouping and search in the dashboard)."
          },
          "Access": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataCollectionAccess"
              }
            ],
            "description": "Access rules for Read / Create / Update / Delete."
          },
          "Fields": {
            "type": [
              "null",
              "object"
            ],
            "description": "Record fields. Key = field name (letters, digits, '_' up to 64 chars).",
            "additionalProperties": {
              "$ref": "#/definitions/DataFieldDefinition"
            }
          },
          "Limits": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataCollectionLimits"
              }
            ],
            "description": "Limits: record size, records per owner, TTL."
          },
          "Economy": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataCollectionEconomy"
              }
            ],
            "description": "Economy of client operations in engine resource format: Cost is charged and Grant is given in the SAME transaction as the write ('create a guild = 500 gold'). Value always moves through the engine economy, never inside a record."
          },
          "Enabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "A disabled collection is neither readable nor writable. null = enabled."
          },
          "Counters": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DataCounterDefinition"
            },
            "description": "Declared aggregates maintained atomically on every write (count of records per field value, sum of a numeric field). Read them instead of scanning."
          },
          "SortKeys": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DataSortKeyDefinition"
            },
            "description": "Declared sort keys, including composite ones ('region' then 'score' descending). Every ordered query must use one of them. Equality filters on the leading parts narrow the range."
          },
          "Namespace": {
            "type": [
              "null",
              "string"
            ],
            "description": "Creator's own namespace (grouping in the dashboard and for the AI coder). Does not affect storage."
          },
          "WriteGate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Audience gate for client writes. null = everyone allowed by the access rules."
          },
          "Moderation": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataCollectionModeration"
              }
            ],
            "description": "Moderation of user-written text fields (blocked terms)."
          },
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "What this collection stores (documentation for the dashboard and the AI coder)."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name (a localization key or a literal)."
          },
          "PublicViews": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/DataPublicViewDefinition"
            },
            "description": "Public views published as static files to the CDN (R2) for anonymous and logged-in reads without touching the database. Requires Access.Read to include Anyone. Only fields visible to Everyone are published. Freshness is seconds, not instant."
          },
          "Integrations": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/DataCollectionIntegrations"
              }
            ],
            "description": "Integration with other platform modules: quest progress, analytics events, leaderboard score, push notifications, CloudCode triggers."
          },
          "SchemaVersion": {
            "type": "integer",
            "format": "int32",
            "description": "Schema version, stamped on each record. After a field type change old records are re-validated lazily on their next write."
          },
          "OnOwnerDeleted": {
            "oneOf": [
              {
                "$ref": "#/definitions/DataOwnerDeletedPolicy"
              }
            ],
            "description": "What happens to a user's records when the account is deleted: Delete (default), Anonymize (owner removed, record stays), Keep."
          },
          "AnonymousSearch": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Allow live anonymous search by declared searchable fields (site search). Answers are cached in Redis for 30 s and limited per network. Default false. Requires Access.Read to include Anyone."
          }
        },
        "description": "A data collection declared by the creator."
      },
      "DataCollectionModeration": {
        "type": "object",
        "properties": {
          "BlockedTerms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Blocked terms checked in every String/Text field written by a client. A match rejects the write."
          }
        },
        "description": "Moderation of user-written text."
      },
      "DataCollectionSchemaMode": {
        "enum": [
          "Strict",
          "Loose"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Strict",
          "Loose"
        ],
        "x-enum-descriptions": [
          "Only declared fields are accepted.",
          "Declared fields are validated, undeclared ones are accepted as free-form JSON (not searchable, not sortable)."
        ]
      },
      "DataPublicViewDefinition": {
        "type": "object",
        "properties": {
          "ID": {
            "type": [
              "null",
              "string"
            ],
            "description": "View id (letters, digits, '_')."
          },
          "SortKey": {
            "type": [
              "null",
              "string"
            ],
            "description": "Sort key id the pages are ordered by."
          },
          "MaxItems": {
            "type": "integer",
            "format": "int32",
            "description": "Maximum records published per partition (default 1000, max 5000)."
          },
          "PageSize": {
            "type": "integer",
            "format": "int32",
            "description": "Records per page (1..200, default 50)."
          },
          "PublishItems": {
            "type": "boolean",
            "description": "Also publish one file per record (items/{id}.json)."
          },
          "PartitionField": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional: a separate page set per value of this searchable field (category, region). Must be the leading component of SortKey."
          }
        },
        "description": "A public view published to the CDN as static pages."
      },
      "DataCollectionIntegrations": {
        "type": "object",
        "properties": {
          "TriggerOnCreate": {
            "type": [
              "null",
              "string"
            ],
            "description": "CloudCode handler run asynchronously (queue, retries) after a record is created. args = { Trigger, Collection, ItemID, Item, Previous }."
          },
          "TriggerOnDelete": {
            "type": [
              "null",
              "string"
            ],
            "description": "CloudCode handler run asynchronously after a record is deleted."
          },
          "TriggerOnUpdate": {
            "type": [
              "null",
              "string"
            ],
            "description": "CloudCode handler run asynchronously after a record is updated."
          },
          "QuestMetricOnCreate": {
            "type": [
              "null",
              "string"
            ],
            "description": "Quest progress: objectives with Source = ServerApi and this MetricID advance by 1 for the acting user when a record is created."
          },
          "QuestMetricOnDelete": {
            "type": [
              "null",
              "string"
            ],
            "description": "Quest metric advanced when a record is deleted by a client."
          },
          "QuestMetricOnUpdate": {
            "type": [
              "null",
              "string"
            ],
            "description": "Quest metric advanced when a record is updated by a client."
          },
          "AnalyticsEventOnCreate": {
            "type": [
              "null",
              "string"
            ],
            "description": "Custom analytics event logged for the acting user on create (server-side, same rules as server.LogEvent). Params: collection, itemId."
          },
          "AnalyticsEventOnDelete": {
            "type": [
              "null",
              "string"
            ],
            "description": "Custom analytics event on delete."
          },
          "AnalyticsEventOnUpdate": {
            "type": [
              "null",
              "string"
            ],
            "description": "Custom analytics event on update."
          }
        },
        "description": "Integration with other platform modules."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "DataCollectionRoleDefinition": {
        "type": "object",
        "properties": {
          "Description": {
            "type": [
              "null",
              "string"
            ],
            "description": "What the role is for (documentation only)."
          },
          "DisplayName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Display name of the role."
          }
        },
        "description": "A title user role."
      }
    },
    "additionalProperties": false
  }

  arguments 1381 lines copy
• get_mailbox unknown never probed

  GET ONLY the 'Mailbox' field of TitlePublicConfigurationModel. Mailbox - an in-game mailbox that holds VALUE the player claims (not notifications - those are Push). Enabled is the master switch, default OFF. Capacity (default 100) caps visible letters; on overflow the oldest letters WITHOUT unclaimed rewards are removed. RewardLetterDays (30) / PlainLetterDays (14) are letter lifetimes (an unclaimed reward is lost when it expires), ClaimedRetentionDays (7) keeps claimed letters visible. DefaultLanguage (en) is the text fallback. Templates maps a TemplateID to per-language Texts {Subject, Body with {Param} placeholders}, Category (System/Reward/Gift/Social tab), Icon, Banner, Link {FeatureID+Args to open a game screen, or an https Url}, SenderName, ExpirationDays; keys 'system.*' override built-in letters of modules (system.gift, system.transfer, system.transfer_return, system.leaderboard_reward, system.coop_grand_prize, system.coop_object_reward, system.season_unclaimed, system.referral_reward). Gifts.Social maps a GiftID to a friend gift (Grant of items/virtual currencies minted on claim; optional Cost the sender pays per friend, burned; one per friend per period; the period is IntervalSeconds (default 86400) counted from AnchorUtc (default 2026-01-01 00:00 UTC) like fixed-interval cycles of other systems; SendLimit/ReceiveLimit per period, default 20; SenderGate). Gifts.Transfer lets friends send their OWN resources: AllowedResources whitelist (VirtualCurrency or STACKABLE items; MaxAmountPerGift is a CAP - any amount from 1 up to it, entries separately or together), MaxEntriesPerGift (5), IntervalSeconds/AnchorUtc (same period model), SendLimit/ReceiveLimit per period (5), FeePercent (0-90, withheld from what the friend receives, the fee per entry rounds up) and FeeCost (fixed fee on top); both burn only when the friend claims - a declined or expired transfer returns everything charged, MinFriendshipHours (24, against alt-account funnelling), ExpirationDays (7, then returned to the sender). Integrations {Leaderboard, CoopEvent, Season, Referral} (empty = on) bring unclaimed rewards of those modules to the mailbox. Letters and broadcasts themselves are NOT config: they are sent from the dashboard (player letters, segment broadcasts with a SegmentGate and a schedule) or by CloudCode server.SendMail; letters with rewards require the player-admin plan right.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• save_mailbox unknown never probed

  PARTIAL SAVE: writes ONLY the 'Mailbox' field of TitlePublicConfigurationModel; all other v1/v2 fields stay untouched. Mailbox - an in-game mailbox that holds VALUE the player claims (not notifications - those are Push). Enabled is the master switch, default OFF. Capacity (default 100) caps visible letters; on overflow the oldest letters WITHOUT unclaimed rewards are removed. RewardLetterDays (30) / PlainLetterDays (14) are letter lifetimes (an unclaimed reward is lost when it expires), ClaimedRetentionDays (7) keeps claimed letters visible. DefaultLanguage (en) is the text fallback. Templates maps a TemplateID to per-language Texts {Subject, Body with {Param} placeholders}, Category (System/Reward/Gift/Social tab), Icon, Banner, Link {FeatureID+Args to open a game screen, or an https Url}, SenderName, ExpirationDays; keys 'system.*' override built-in letters of modules (system.gift, system.transfer, system.transfer_return, system.leaderboard_reward, system.coop_grand_prize, system.coop_object_reward, system.season_unclaimed, system.referral_reward). Gifts.Social maps a GiftID to a friend gift (Grant of items/virtual currencies minted on claim; optional Cost the sender pays per friend, burned; one per friend per period; the period is IntervalSeconds (default 86400) counted from AnchorUtc (default 2026-01-01 00:00 UTC) like fixed-interval cycles of other systems; SendLimit/ReceiveLimit per period, default 20; SenderGate). Gifts.Transfer lets friends send their OWN resources: AllowedResources whitelist (VirtualCurrency or STACKABLE items; MaxAmountPerGift is a CAP - any amount from 1 up to it, entries separately or together), MaxEntriesPerGift (5), IntervalSeconds/AnchorUtc (same period model), SendLimit/ReceiveLimit per period (5), FeePercent (0-90, withheld from what the friend receives, the fee per entry rounds up) and FeeCost (fixed fee on top); both burn only when the friend claims - a declined or expired transfer returns everything charged, MinFriendshipHours (24, against alt-account funnelling), ExpirationDays (7, then returned to the sender). Integrations {Leaderboard, CoopEvent, Season, Referral} (empty = on) bring unclaimed rewards of those modules to the mailbox. Letters and broadcasts themselves are NOT config: they are sent from the dashboard (player letters, segment broadcasts with a SegmentGate and a schedule) or by CloudCode server.SendMail; letters with rewards require the player-admin plan right.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932

  {
    "type": "object",
    "required": [
      "title_id",
      "value"
    ],
    "properties": {
      "value": {
        "type": "object",
        "title": "MailboxDefinitions",
        "properties": {
          "Gifts": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MailboxGiftDefinitions"
              }
            ],
            "description": "Gifts between friends. null = no gifts."
          },
          "Enabled": {
            "type": "boolean",
            "description": "Module master switch. Default false — the mailbox must be enabled explicitly."
          },
          "Capacity": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many visible letters a mailbox keeps. On overflow the oldest letters without unclaimed rewards are removed. Empty = 100."
          },
          "Templates": {
            "type": [
              "null",
              "object"
            ],
            "description": "Letter templates keyed by TemplateID. Referenced by broadcasts, dashboard letters and CloudCode. Keys 'system.*' override the built-in letters of other modules.",
            "additionalProperties": {
              "$ref": "#/definitions/MailTemplateDefinition"
            }
          },
          "Integrations": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MailboxIntegrationDefinitions"
              }
            ],
            "description": "Which modules bring their unclaimed rewards to the mailbox. null = all of them."
          },
          "DefaultLanguage": {
            "type": [
              "null",
              "string"
            ],
            "description": "Fallback language when a letter has no text in the player's language. Empty = \"en\"."
          },
          "PlainLetterDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Lifetime of a letter WITHOUT rewards, in days. Empty = 14."
          },
          "RewardLetterDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Lifetime of a letter WITH rewards, in days. An unclaimed reward is lost when it expires. Empty = 30."
          },
          "ClaimedRetentionDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many days a letter stays in the mailbox after its reward was claimed. Empty = 7."
          }
        },
        "description": "Title mailbox: letters with rewards, publisher broadcasts, friend gifts and unclaimed rewards of other modules. An in-game mailbox that holds VALUE the player claims — not notifications (those are Push) and not the social activity inbox."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого сохраняются данные."
      }
    },
    "definitions": {
      "MailLink": {
        "type": "object",
        "properties": {
          "Url": {
            "type": [
              "null",
              "string"
            ],
            "description": "Absolute https URL to open instead of a feature."
          },
          "Args": {
            "type": [
              "null",
              "object"
            ],
            "description": "Arguments for the feature, e.g. {\"offerID\": \"starter\"}.",
            "additionalProperties": {
              "type": "string"
            }
          },
          "Label": {
            "type": [
              "null",
              "string"
            ],
            "description": "Button label (or a localization key)."
          },
          "FeatureID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Feature (system) to open in the game, e.g. \"store\". CLIENT contract: the game SDK opens it (ctx.features.open); the engine only stores and returns it."
          }
        },
        "description": "Button inside a letter: open a game screen (FeatureID, like ctx.features.open) or a URL. One of the two."
      },
      "MailText": {
        "type": "object",
        "properties": {
          "Body": {
            "type": [
              "null",
              "string"
            ],
            "description": "Body, up to 2000 characters."
          },
          "Subject": {
            "type": [
              "null",
              "string"
            ],
            "description": "Subject, up to 200 characters."
          }
        },
        "description": "Letter subject and body in one language."
      },
      "SegmentGate": {
        "type": "object",
        "properties": {
          "MaxLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Maximum Board Rank. 0 = no upper bound."
          },
          "MinLevel": {
            "type": "integer",
            "format": "int64",
            "description": "Minimum Board Rank (matches PublicData.BoardRank). 0 = no lower bound."
          },
          "Segments": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed economy segments (matches PlayerEconomyTuningState.Segment: \"F2P\",\"Dolphin\",\"Whale\",\"VIP\"). Empty = any."
          },
          "Tutorial": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TutorialGateCondition"
              }
            ],
            "description": "Tutorial condition: the gate passes only if the player is in the required progression state (TutorialGateCondition). null = not applied. By the same trick as Experiment, this gives \"after onboarding\" gating in every module already using SegmentGate, with no edits to them. To close a whole module there is a cheaper path — TutorialGlobalSettings.Blocking: one check in ClientRun instead of a condition on every entity."
          },
          "Countries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Country filter (ISO 3166-1 alpha-2; matches PublicData.Country, else RegistrationCountry). Empty = all countries."
          },
          "Platforms": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ClientPlatform"
            },
            "description": "Platforms the entity is available on. Empty/null = all. Unlike the other axes this one comes from the request platform (IGSService.ClientPlatform), not from the player document, and is passed to SegmentGateEvaluator.Passes as a separate REQUIRED argument. The axis is skipped when the platform is Unknown — deliberately soft, because it governs what is shown, not what is charged: payments are guarded by PriceOptionSelector.IsAvailableOn, where Unknown does not pass a non-empty platform list. Not needed to hide entities that simply cannot be paid for on a platform: storefronts already drop whatever has no available price option."
          },
          "Experiment": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ExperimentVariantCondition"
              }
            ],
            "description": "A/B experiment condition: the gate passes only if the player is assigned to the required variant (ExperimentVariantCondition). null = not applied. A/B variants thus reuse the whole SegmentGate stack: two configs, each gated to its variant. Assignment is read from UserDataDocument.Experiments (sticky, stable-hash — see ExperimentAssigner)."
          },
          "MinPremiumTier": {
            "type": "integer",
            "format": "int32",
            "description": "Minimum active premium tier (matches Premium.MaxActiveTier). 0 = no requirement."
          },
          "ActiveWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Active within the last X days (matches Usage.LastActiveAt). 0 = no restriction."
          },
          "RequiredPremiumIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Required active premium IDs (ANY of the list is enough, via PremiumHelpers.GetActivePremiumIDs). Empty = no requirement."
          },
          "RegisteredWithinDays": {
            "type": "integer",
            "format": "int32",
            "description": "Registered no earlier than X days ago (new players; matches RegistrationDate). 0 = no restriction."
          }
        },
        "description": "Unified \"who it is available/applies to\" gate. Replaces BoostSegmentGate (TimedBoost), MailboxSegmentDefinition filters and StoreOfferRules premium fields. All conditions are AND-ed. An empty/unset field = no constraint on that axis; an empty/null gate = available to everyone. Resolved by SegmentGateEvaluator.Passes."
      },
      "ResourceEntry": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "Resource type. Determines which fields must be populated: Item (catalog item), VirtualCurrency (off-chain), CryptoCurrency (on-chain), or Purchase (real-money payment in a store)."
          },
          "Amount": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Amount of the resource. Used by every type except Purchase, where the quantity is decided by the store itself and this field is ignored. Amount=0 is valid in Consume.PremiumTiers and means 'do not charge'."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item identifier within the catalog. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs[Catalog].Items."
          },
          "AmountUsd": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "CryptoCurrency only: the amount in USD instead of a token count. At the moment of the operation the engine converts it to tokens at the LIVE market price of the token (charge: rounded up to a whole token; grant: rounded down). When set, Amount is ignored; the operation result carries the converted Amount."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog identifier. Used only when Type is Item. Corresponds to a key in cfg.Item.Catalogs (e.g. \"main\", \"season\")."
          },
          "ProductID": {
            "type": [
              "null",
              "string"
            ],
            "description": "IAP product identifier. Used only when Type is Purchase. Corresponds to a key in cfg.Purchase.Products — OUR stable product ID, not the store SKU (per-store SKUs live in IapProductDefinition.StoreProductIDs)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency identifier. Used only when Type is VirtualCurrency or CryptoCurrency. Corresponds to a key in cfg.Currency.VirtualCurrencies or cfg.Currency.CryptoCurrencies."
          }
        },
        "description": "Universal container for a single entry in a resource bundle (item or currency). The set of populated fields depends on Type: Item uses CatalogID/ItemID/Amount; VirtualCurrency or CryptoCurrency uses CurrencyID/Amount; Purchase uses only ProductID (paid in a store)."
      },
      "ClientPlatform": {
        "enum": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Unknown",
          "Web",
          "Android",
          "Ios"
        ],
        "x-enum-descriptions": [
          "Platform was not reported, or the reported one contradicts the request fingerprint.",
          "Browser: web build, WebGL, or a messenger mini-app.",
          "Android build (Google Play Billing).",
          "iOS / iPadOS build (App Store, StoreKit)."
        ]
      },
      "EventTokenType": {
        "enum": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "TimedEvent",
          "Leaderboard",
          "CoopEvent",
          "Season",
          "Quest",
          "DealOffer"
        ]
      },
      "ResourceBundle": {
        "type": "object",
        "properties": {
          "Entries": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/ResourceEntry"
            },
            "description": "Items and currencies."
          },
          "EventTokens": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/EventTokenOperation"
            },
            "description": "Event tokens."
          }
        },
        "description": "Set of items, currencies and tokens for a single operation direction (grant only or consume only)."
      },
      "MailboxCategory": {
        "enum": [
          "System",
          "Reward",
          "Gift",
          "Social"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "System",
          "Reward",
          "Gift",
          "Social"
        ],
        "x-enum-descriptions": [
          "System messages and announcements.",
          "Letters that carry rewards.",
          "Gifts from friends.",
          "Social notifications."
        ]
      },
      "TutorialGateMode": {
        "enum": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Completed",
          "Started",
          "StepReached"
        ],
        "x-enum-descriptions": [
          "The flow is finished. Default.",
          "The flow is started (in progress or already finished).",
          "A specific step has been reached (TutorialGateCondition.StepID)."
        ]
      },
      "EventTokenAddress": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/EventTokenType"
              }
            ],
            "description": "System the tokens belong to."
          },
          "EntityID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Event identifier within the system. In TITLE CONFIG (rewards written by a designer or an AI agent) scheduled systems use the SHORT form — the cycle number is unknowable at config time: \"{TimedEventID}\" / \"{LeaderboardID}\" = whichever instance is active at grant time, or \"{ID}:{ChainedEventID}\" = that chain phase in the current cycle. The engine (EventTokenAddressResolver in ResourceService) expands it before granting; a grant with no active instance is dropped. At RUNTIME the bucket address is always the full form \"{EntityID}:{InstanceKey}\": TimedEvent Scheduled → \"{TimedEventID}:s{yyyyMMddHHmm}\"; TimedEvent Chain → \"{chainID}:{cycleIndex}:{chainedEventID}\"; Leaderboard → \"{leaderboardID}:{instanceKey}\"; CoopEvent → CoopChainID; Season → SeasonChainID."
          }
        },
        "description": "Universal event-token address. Uniquely identifies the system and event the tokens belong to."
      },
      "ResourceEntryType": {
        "enum": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "type": "string",
        "description": "",
        "x-enumNames": [
          "Item",
          "VirtualCurrency",
          "CryptoCurrency",
          "Purchase",
          "RewardedVideoCredit"
        ],
        "x-enum-descriptions": [
          "Catalog item. Requires CatalogID, ItemID and Amount.",
          "In-game (off-chain) virtual currency. Requires CurrencyID and Amount. Looked up in cfg.Currency.VirtualCurrencies.",
          "On-chain cryptocurrency. Requires CurrencyID and Amount. Looked up in cfg.Currency.CryptoCurrencies.",
          "Real-money payment in a store. Requires only ProductID (a product from cfg.Purchase.Products); the amount and currency are decided by the store from the SKU price tier. NOT a storable resource and never passes through ResourceService — the money is paid outside before the server learns about it, so the entry is consumed by the receipt check (ExternalPaymentGate) and stripped before the resource operation. Allowed only in Consume and only for Consumable products.",
          "Rewarded-video credit. One credit equals one verified ad view that can be spent in systems requiring rewarded video (lootbox open, reward double, re-roll, booster). Granted +1 per server-verified view, or as N from milestones/quests/premium perks; spent -1 per gated action."
        ]
      },
      "EventTokenOperation": {
        "type": "object",
        "properties": {
          "Amount": {
            "type": "integer",
            "format": "int64",
            "description": "Token amount — how many to grant or consume."
          },
          "Source": {
            "type": [
              "null",
              "string"
            ],
            "description": "Operation source (sourceKey used for analytics and limits)."
          },
          "Address": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/EventTokenAddress"
              }
            ],
            "description": "Event token address — where to grant or consume."
          }
        },
        "description": "Information about granted event tokens. Returned in Board_Roll, QuestComplete and other responses. All multipliers (Roll/Premium/BonusWindow/ProgressiveTier/SeasonBuffs) are applied via ModifierService before ResourceService; this carries the final amount. Use ModifierApplyResult alongside ResourceOperation if UI needs multiplier breakdown."
      },
      "SocialGiftDefinition": {
        "type": "object",
        "properties": {
          "Cost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Price the SENDER pays per friend, charged in the same transaction as the letter (not enough = the gift is not sent). Burned; the friend still receives Grant. Items and virtual currencies only. Empty = free."
          },
          "Grant": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "What the friend receives. Items and virtual currencies only; minted when the friend claims it."
          },
          "Enabled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Switch of this gift kind. Empty = enabled."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor of the windows (UTC, time of day included): windows run every IntervalSeconds from it, both ways. It sets the alignment, e.g. 03:00 UTC makes days start at 03:00. Empty = 2026-01-01 00:00 UTC (as cycles of other systems)."
          },
          "SendLimit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many gifts of this kind a player may send per period. Empty = 20."
          },
          "SenderGate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who may send this gift. null = everyone."
          },
          "TemplateID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Template of the recipient's letter. Empty = built-in 'system.gift'."
          },
          "ReceiveLimit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many gifts of this kind a player may receive per period. Empty = 20."
          },
          "ExpirationDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Gift letter lifetime in days. Empty = the reward letter lifetime."
          },
          "IntervalSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Period length in SECONDS (60 to one year): 'once per friend' and the limits are counted in windows of this length from AnchorUtc - the same fixed-interval cycles as other systems (CyclicSchedule.IntervalSeconds). 21600 = 6 hours, 86400 = a day, 604800 = a week. Empty = 86400."
          }
        },
        "description": "A kind of free gift."
      },
      "TransferableResource": {
        "type": "object",
        "properties": {
          "Type": {
            "oneOf": [
              {
                "$ref": "#/definitions/ResourceEntryType"
              }
            ],
            "description": "VirtualCurrency or Item."
          },
          "ItemID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Stackable item ID (Type = Item)."
          },
          "CatalogID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Item catalog (Type = Item)."
          },
          "CurrencyID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Currency ID (Type = VirtualCurrency)."
          },
          "MaxAmountPerGift": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "CAP per transfer, not a fixed amount: a player sends any amount from 1 up to the cap (and not more than they own). Resources of the list go separately or together - how many per transfer is MaxEntriesPerGift. Empty = no cap."
          }
        },
        "description": "A resource allowed in transfers."
      },
      "TutorialGateCondition": {
        "type": "object",
        "properties": {
          "Mode": {
            "oneOf": [
              {
                "$ref": "#/definitions/TutorialGateMode"
              }
            ],
            "description": "What exactly must hold for those flows. Default Completed."
          },
          "Negate": {
            "type": "boolean",
            "description": "Invert the condition. Needed for the reverse case — \"show this starter offer ONLY to players still in the tutorial\". Default false."
          },
          "StepID": {
            "type": [
              "null",
              "string"
            ],
            "description": "The step that must be reached. Read only when Mode = StepReached, and applied to every flow in FlowIDs."
          },
          "FlowIDs": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Flows whose state is checked. Empty = the condition is not applied (the gate passes). Multiple entries are AND-ed: \"after the intro AND after the raid tutorial\"."
          },
          "SkippedCountsAsCompleted": {
            "type": "boolean",
            "description": "Whether a Skipped flow counts as finished under Mode = Completed. Default true: if the publisher allowed skipping, the skipper must get the same game as the completer."
          }
        },
        "description": "\"The player finished the tutorial\" condition — embedded in SegmentGate.Tutorial exactly as ExperimentVariantCondition is embedded in SegmentGate.Experiment. Thanks to that, tutorial gating works for free in EVERY module already using SegmentGate (Store / DealOffer / Quest / Reward / Leaderboard / ...). This is the per-entity gating level; to close a whole module use TutorialBlockingPolicy, which is cheaper."
      },
      "MailTemplateDefinition": {
        "type": "object",
        "properties": {
          "Icon": {
            "type": [
              "null",
              "string"
            ],
            "description": "Envelope icon (path or URL)."
          },
          "Link": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MailLink"
              }
            ],
            "description": "Call-to-action button of the letter."
          },
          "Texts": {
            "type": [
              "null",
              "object"
            ],
            "description": "Texts per language. Key = language code (\"en\", \"ru\"). Subject/Body may contain {Param} placeholders filled from TemplateParams by the client.",
            "additionalProperties": {
              "$ref": "#/definitions/MailText"
            }
          },
          "Banner": {
            "type": [
              "null",
              "string"
            ],
            "description": "Banner inside the letter (path or URL)."
          },
          "Category": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/MailboxCategory"
              }
            ],
            "description": "Mailbox tab. Empty = derived from the letter source."
          },
          "SenderName": {
            "type": [
              "null",
              "string"
            ],
            "description": "Sender name shown on a system letter (e.g. \"Game team\")."
          },
          "ExpirationDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Letter lifetime in days. Empty = the section default; 0 = never expires (only for letters without rewards)."
          }
        },
        "description": "Letter template: texts, look and lifetime."
      },
      "MailboxGiftDefinitions": {
        "type": "object",
        "properties": {
          "Social": {
            "type": [
              "null",
              "object"
            ],
            "description": "Free gifts (like 'lives' in casual games), keyed by GiftID. The sender loses nothing; one gift of a kind per friend per UTC day.",
            "additionalProperties": {
              "$ref": "#/definitions/SocialGiftDefinition"
            }
          },
          "Transfer": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/TransferGiftDefinition"
              }
            ],
            "description": "Transfer of the player's own resources to a friend. null = disabled."
          }
        },
        "description": "Gifts to friends: free social gifts and transfers of the player's own resources."
      },
      "TransferGiftDefinition": {
        "type": "object",
        "properties": {
          "Enabled": {
            "type": "boolean",
            "description": "Switch. Default false."
          },
          "FeeCost": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/ResourceBundle"
              }
            ],
            "description": "Fixed fee per transfer: charged from the sender on top of what is sent. Burned only when the friend claims; returned with the transfer if declined or expired. Items and virtual currencies only. Empty = no fee."
          },
          "AnchorUtc": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time",
            "description": "Anchor of the windows (UTC, time of day included): windows run every IntervalSeconds from it, both ways. It sets the alignment, e.g. 03:00 UTC makes days start at 03:00. Empty = 2026-01-01 00:00 UTC (as cycles of other systems)."
          },
          "SendLimit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Transfers per period from one player. Empty = 5."
          },
          "FeePercent": {
            "type": [
              "null",
              "number"
            ],
            "format": "decimal",
            "description": "Commission in percent (0-90): withheld from what the friend receives, per entry (the fee rounds up by the platform convention, the friend gets the rest). Burned only when the friend claims; a declined or expired transfer returns EVERYTHING charged, fee included. Empty = 0."
          },
          "SenderGate": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/definitions/SegmentGate"
              }
            ],
            "description": "Who may transfer. null = everyone."
          },
          "TemplateID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Template of the recipient's letter. Empty = built-in 'system.transfer'."
          },
          "ReceiveLimit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Transfers per period to one player. Empty = 5."
          },
          "ExpirationDays": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many days a transfer waits for the recipient before it returns to the sender. Empty = 7."
          },
          "IntervalSeconds": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Period length in SECONDS (60 to one year): 'once per friend' and the limits are counted in windows of this length from AnchorUtc - the same fixed-interval cycles as other systems (CyclicSchedule.IntervalSeconds). 21600 = 6 hours, 86400 = a day, 604800 = a week. Empty = 86400."
          },
          "AllowedResources": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/definitions/TransferableResource"
            },
            "description": "What may be transferred and how much per gift. Virtual currencies and STACKABLE items only; unique item instances go through the marketplace."
          },
          "MaxEntriesPerGift": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Entries per transfer. Empty = 5."
          },
          "MinFriendshipHours": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "How many hours two players must have been friends before a transfer (against alt-account funnelling). Empty = 24."
          }
        },
        "description": "Transfer of own resources to a friend. Resources are taken immediately and wait in the letter; returned to the sender if declined or expired."
      },
      "ExperimentVariantCondition": {
        "type": "object",
        "properties": {
          "Variants": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Allowed variants (any-of). Empty = being assigned to any variant is enough (enrolled). A player with no assignment for this experiment does NOT pass."
          },
          "ExperimentID": {
            "type": [
              "null",
              "string"
            ],
            "description": "Experiment ID whose assignment is checked."
          }
        },
        "description": "Experiment-variant membership condition — embedded in SegmentGate.Experiment. The gate passes if the player is assigned to one of Variants of experiment ExperimentID (empty list = just enrolled). A/B variants thus reuse the whole SegmentGate stack: make two configs (offer A, offer B), each gated to its variant."
      },
      "MailboxIntegrationDefinitions": {
        "type": "object",
        "properties": {
          "Season": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Season: tier rewards left unclaimed when the season ended."
          },
          "Referral": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Referral: rewards for invited friends."
          },
          "CoopEvent": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Coop event: grand prize and object rewards of completed groups."
          },
          "Leaderboard": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Leaderboard: rewards of finished cycles."
          }
        },
        "description": "Which modules bring unclaimed rewards to the mailbox. An empty field = enabled."
      }
    },
    "additionalProperties": false
  }

  arguments 932 lines copy
• generate_video unknown never probed

  Generate a video clip for the title. Duration is the main cost driver, and some models bill a minimum length even when the clip is shorter — estimate first. ASYNC: returns a job with an id and status — poll get_video for the result.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536

  {
    "type": "object",
    "required": [
      "prompt"
    ],
    "properties": {
      "tier": {
        "type": "string",
        "description": "Quality/price tier, e.g. image-cheap or video-premium. Call list_ai_tiers for the current list. Omit it to use this title's default tier."
      },
      "model": {
        "type": "string",
        "description": "Model name, if you insist on a specific one (optional). ⚠ Setting it cancels the tier COMPLETELY — together with its provider and its settings — so params may stop applying. Prefer `tier`."
      },
      "params": {
        "type": "object",
        "description": "Model settings, as declared by the vendor for the chosen tier — for example {\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\",\"duration\":\"4\"}. Call list_ai_tiers to see which keys this tier accepts, their allowed values and defaults. Values are strings. Unknown keys are ignored rather than rejected.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "prompt": {
        "type": "string",
        "description": "What to generate."
      },
      "provider": {
        "type": "string",
        "description": "Provider key, if you insist on one (optional). Cancels the tier the same way."
      },
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game."
      }
    },
    "additionalProperties": false
  }

  arguments 36 lines copy
• generate_audio unknown never probed

  Generate speech (text-to-speech) for the title. Billed per character. The voice comes from the tier's model unless you pass one in params. Runs as a job: the call waits up to about two minutes and returns the result; if it is not ready by then it returns the generation with status queued/running — poll get_generation with its id.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536

  {
    "type": "object",
    "required": [
      "text"
    ],
    "properties": {
      "text": {
        "type": "string",
        "description": "The words to say out loud. They are read verbatim, so do not put instructions here."
      },
      "tier": {
        "type": "string",
        "description": "Quality/price tier, e.g. image-cheap or video-premium. Call list_ai_tiers for the current list. Omit it to use this title's default tier."
      },
      "model": {
        "type": "string",
        "description": "Model name, if you insist on a specific one (optional). ⚠ Setting it cancels the tier COMPLETELY — together with its provider and its settings — so params may stop applying. Prefer `tier`."
      },
      "params": {
        "type": "object",
        "description": "Model settings, as declared by the vendor for the chosen tier — for example {\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\",\"duration\":\"4\"}. Call list_ai_tiers to see which keys this tier accepts, their allowed values and defaults. Values are strings. Unknown keys are ignored rather than rejected.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "provider": {
        "type": "string",
        "description": "Provider key, if you insist on one (optional). Cancels the tier the same way."
      },
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game."
      }
    },
    "additionalProperties": false
  }

  arguments 36 lines copy
• generate_music unknown never probed

  Generate music (a loop or a short track) for the title. A different vendor path and a different price from generate_audio, which is speech. Runs as a job: the call waits up to about two minutes and returns the result; if it is not ready by then it returns the generation with status queued/running — poll get_generation with its id.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536

  {
    "type": "object",
    "required": [
      "prompt"
    ],
    "properties": {
      "tier": {
        "type": "string",
        "description": "Quality/price tier, e.g. image-cheap or video-premium. Call list_ai_tiers for the current list. Omit it to use this title's default tier."
      },
      "model": {
        "type": "string",
        "description": "Model name, if you insist on a specific one (optional). ⚠ Setting it cancels the tier COMPLETELY — together with its provider and its settings — so params may stop applying. Prefer `tier`."
      },
      "params": {
        "type": "object",
        "description": "Model settings, as declared by the vendor for the chosen tier — for example {\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\",\"duration\":\"4\"}. Call list_ai_tiers to see which keys this tier accepts, their allowed values and defaults. Values are strings. Unknown keys are ignored rather than rejected.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "prompt": {
        "type": "string",
        "description": "What to generate."
      },
      "provider": {
        "type": "string",
        "description": "Provider key, if you insist on one (optional). Cancels the tier the same way."
      },
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game."
      }
    },
    "additionalProperties": false
  }

  arguments 36 lines copy
• generate_three_d unknown never probed

  Generate a 3D asset (mesh) for the title. ASYNC: returns a job with an id and status — poll get_three_d for the result.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152

  {
    "type": "object",
    "required": [
      "operation"
    ],
    "properties": {
      "tier": {
        "type": "string",
        "description": "Quality/price tier, e.g. image-cheap or video-premium. Call list_ai_tiers for the current list. Omit it to use this title's default tier."
      },
      "model": {
        "type": "string",
        "description": "Model name, if you insist on a specific one (optional). ⚠ Setting it cancels the tier COMPLETELY — together with its provider and its settings — so params may stop applying. Prefer `tier`."
      },
      "params": {
        "type": "object",
        "description": "Model settings, as declared by the vendor for the chosen tier — for example {\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\",\"duration\":\"4\"}. Call list_ai_tiers to see which keys this tier accepts, their allowed values and defaults. Values are strings. Unknown keys are ignored rather than rejected.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "prompt": {
        "type": "string",
        "description": "What to generate."
      },
      "provider": {
        "type": "string",
        "description": "Provider key, if you insist on one (optional). Cancels the tier the same way."
      },
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game."
      },
      "image_url": {
        "type": "string",
        "description": "Source image URL — image-to-3d (optional)."
      },
      "model_url": {
        "type": "string",
        "description": "Source model URL — texture, remesh, rig (optional)."
      },
      "operation": {
        "type": "string",
        "description": "What to do: text-to-3d | image-to-3d | text-to-texture | remesh | rig."
      },
      "input_task_id": {
        "type": "string",
        "description": "Previous job id — texture, remesh, rig (optional)."
      }
    },
    "additionalProperties": false
  }

  arguments 52 lines copy
• get_video unknown never probed

  Poll a video job by id. While it runs the status says so; when it is done the CDN URL is in Assets.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "required": [
      "video_id"
    ],
    "properties": {
      "variant": {
        "type": "string",
        "description": "Variant to fetch, e.g. 720p (optional)."
      },
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game."
      },
      "video_id": {
        "type": "string",
        "description": "Job id returned by generate_video."
      },
      "content_type": {
        "type": "string",
        "description": "Desired content type, e.g. video/mp4 (optional)."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• get_three_d unknown never probed

  Poll a 3D job by id. When it is done the model CDN URL is in Assets.

  mcp-tool

  1234567891011121314151617

  {
    "type": "object",
    "required": [
      "three_d_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game."
      },
      "three_d_id": {
        "type": "string",
        "description": "Job id returned by generate_three_d."
      }
    },
    "additionalProperties": false
  }

  arguments 17 lines copy
• list_ai_tiers unknown never probed

  List the quality/price tiers available on this publisher's plan for every kind of media, and — for each tier — the settings its model accepts: field keys, allowed values, defaults and what they do. That list is the reference for the `params` argument of the generate_* tools. Read-only and free.

  mcp-tool

  1234567891011

  {
    "type": "object",
    "required": [],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "Not needed — tiers depend on the publisher's plan (optional, ignored)."
      }
    },
    "additionalProperties": false
  }

  arguments 11 lines copy
• estimate_media_cost unknown never probed

  Estimate what a generation will cost in credits before running it. Read-only and free. exact=true means computed from the model's price list; approximate=true means the vendor names the final sum itself (video and music) and the number is a best guess; both false means there is nothing to estimate from — and zero credits does NOT mean free.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132

  {
    "type": "object",
    "required": [
      "modality"
    ],
    "properties": {
      "text": {
        "type": "string",
        "description": "The words to say — speech only, their length drives the price (optional)."
      },
      "tier": {
        "type": "string",
        "description": "Tier to price. Omit to use the default tier of that modality."
      },
      "params": {
        "type": "object",
        "description": "Model settings, as declared by the vendor for the chosen tier — for example {\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\",\"duration\":\"4\"}. Call list_ai_tiers to see which keys this tier accepts, their allowed values and defaults. Values are strings. Unknown keys are ignored rather than rejected.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "modality": {
        "type": "string",
        "description": "What is going to be generated: image | video | audio | music | 3d"
      },
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label, optional (see the generate_* tools)."
      }
    },
    "additionalProperties": false
  }

  arguments 32 lines copy
• get_generation unknown never probed

  Read a generation by id: its status (queued | running | completed | failed), the CDN URLs in Assets or the text in OutputText when it is done, the error when it failed. Poll it for generations that returned queued/running. Read-only and free.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "generation_id"
    ],
    "properties": {
      "generation_id": {
        "type": "string",
        "description": "Id returned by a generate_* tool."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• generate_text unknown never probed

  Generate text via AI (copy, item descriptions, dialogue). Runs as a job: the call waits up to about two minutes and returns the generated text; if it is not ready by then it returns the generation with status queued/running — poll get_generation with its id. Credits are the publisher's; title_id is an optional label for the report.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637

  {
    "type": "object",
    "required": [
      "prompt"
    ],
    "properties": {
      "model": {
        "type": "string",
        "description": "Model override (optional)."
      },
      "prompt": {
        "type": "string",
        "description": "Prompt for the model."
      },
      "provider": {
        "type": "string",
        "description": "Provider override, e.g. anthropic (optional)."
      },
      "title_id": {
        "type": "string",
        "description": "Which game this text is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for copy that belongs to no game."
      },
      "max_tokens": {
        "type": "integer",
        "description": "Max output tokens (optional)."
      },
      "temperature": {
        "type": "number",
        "description": "Sampling temperature (optional)."
      },
      "system_instructions": {
        "type": "string",
        "description": "System instructions (optional)."
      }
    },
    "additionalProperties": false
  }

  arguments 37 lines copy
• get_title_data unknown never probed

  Read the TITLE's key-value data store — values shared by ALL players (event state, global counters, server-side thresholds, feature toggles). Returns two scopes: "Static" (authored configuration, written with save_title_data) and "Runtime" (live state that only CloudCode scripts write), each split into "Public" (readable by game clients) and "Private" (server/CloudCode only). Values are always strings. Per-player data is NOT here — it lives in each player's UserCustomData.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_localization_keys unknown never probed

  List the title's localization KEYS with their text in the DEFAULT language, plus the configured locales. Call it before writing any user-visible string so you reuse an existing key instead of inventing a second one for the same label. Filter with "prefix" ("shop.", "quest."); long tables are truncated and say so. The client resolves text as t(x) = player's table -> fallback table -> x itself, which is why a plain literal still renders — a literal is simply a key with no translation.

  mcp-tool

  1234567891011121314151617

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "prefix": {
        "type": "string",
        "description": "Optional key prefix filter."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID."
      }
    },
    "additionalProperties": false
  }

  arguments 17 lines copy
• save_localization_keys unknown never probed

  Create or update localization keys in the title's DEFAULT language. PARTIAL: only the keys you send are written, the rest of the table is untouched — people translate the same table, and replacing it wholesale would erase their work. Write ONLY the default language: other locales are filled by translators or by the dashboard's machine translation, and a string that exists only in a target language never appears in the coverage report. Keys are free-form; a dotted namespace ("shop.button.buy") keeps a large table readable.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "required": [
      "title_id",
      "keys"
    ],
    "properties": {
      "keys": {
        "type": "object",
        "description": "Object of localization key → text in the DEFAULT language. Only these keys are written."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID."
      }
    },
    "additionalProperties": false
  }

  arguments 18 lines copy
• list_title_secrets unknown never probed

  List the NAMES of the title's integration variables and secrets, plus the outbound-HTTP allow list. Secret VALUES are never returned by any tool — reference a secret inside a CloudCode script as {{secret:NAME}} in a server.HttpRequest call and the platform substitutes it server-side. Use this to discover which credentials a title already has before writing an integration.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "TitleID, для которого читаются данные."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• publish_cloud_code unknown never probed

  Publish server-side game logic (CloudCode) and make it live. This is the only way to run custom code on the server, and the only way to write protected data: the ReadOnly/Internal buckets of a player's UserCustomData and the Runtime scope of the title's data store. The script is plain JavaScript filling a global 'handlers' object, e.g. handlers.claimDailyBonus = function (args, context) { … }. Inside a handler: log.Info/Warning/Error, context.UserID, and server.* (ReadUserData, GetTitleConfig, GetUserCustomData, SetUserCustomData, DeleteUserCustomData, BatchSetUserCustomData, BatchDeleteUserCustomData, GetPublicUserCustomDataOf, GetTitleCustomData, SetTitleCustomData, IncrementTitleCustomData, DeleteTitleCustomData, BatchSetTitleCustomData, BatchDeleteTitleCustomData, GetIntegrationVariable, HttpRequest) — each returns { Success, Error, Data }. No async/await, no imports; 10 seconds wall-clock per call and a per-execution cap on server.* calls. The only way out to the network is server.HttpRequest({ Method, Url, Headers, Body }) — there is no fetch and no XMLHttpRequest; it reaches only publisher-allow-listed hosts over https, and credentials go in as {{secret:NAME}} placeholders (see list_title_secrets), never as literal values. The code REPLACES the previous revision entirely — read get_cloud_code first and send back the full script. Games call handlers through the SDK's client.cloudCode.execute(name, args).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142

  {
    "type": "object",
    "required": [
      "title_id",
      "code"
    ],
    "properties": {
      "code": {
        "type": "string",
        "description": "Full JavaScript source of the revision."
      },
      "comment": {
        "type": "string",
        "description": "Short note about what changed."
      },
      "handlers": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "Name"
          ],
          "properties": {
            "Name": {
              "type": "string",
              "description": "Handler name as defined in the script."
            },
            "Description": {
              "type": "string",
              "description": "What the handler does."
            }
          }
        },
        "description": "Optional whitelist of callable handlers; anything not listed is rejected by the server."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID."
      }
    },
    "additionalProperties": false
  }

  arguments 42 lines copy
• list_kanban_projects unknown never probed

  List the publisher's task boards (projects) with their names and progress. Start here: every other kanban tool needs a project_id.

  mcp-tool

  123456

  {
    "type": "object",
    "required": [],
    "properties": {},
    "additionalProperties": false
  }

  arguments 6 lines copy
• get_kanban_board unknown never probed

  Read a board: its columns and the cards in them. Cards come back COMPACT — key, title, priority, assignee, due date, labels and counters, without descriptions or checklists. Call get_kanban_card for the full text of one card.

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "project_id"
    ],
    "properties": {
      "project_id": {
        "type": "string",
        "description": "Board to read (from list_kanban_projects)."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• get_kanban_card unknown never probed

  Read ONE card in full: description, checklist, links, watchers, estimate and which column it sits in. Address it either by card_id or by its human key like OPUS-451.

  mcp-tool

  123456789101112131415161718192021

  {
    "type": "object",
    "required": [
      "project_id"
    ],
    "properties": {
      "card_id": {
        "type": "string",
        "description": "Card id (optional if card_key is given)."
      },
      "card_key": {
        "type": "string",
        "description": "Human key of the task, e.g. OPUS-451 (optional if card_id is given)."
      },
      "project_id": {
        "type": "string",
        "description": "Board the card belongs to."
      }
    },
    "additionalProperties": false
  }

  arguments 21 lines copy
• search_kanban_cards unknown never probed

  Find cards ACROSS all the publisher's boards by a substring of the title or by the task key. Two characters minimum; archived boards are excluded.

  mcp-tool

  1234567891011121314151617

  {
    "type": "object",
    "required": [
      "query"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "description": "How many to return (default 20)."
      },
      "query": {
        "type": "string",
        "description": "What to look for: part of a card title, or a task key like OPUS-451."
      }
    },
    "additionalProperties": false
  }

  arguments 17 lines copy
• get_my_kanban_tasks unknown never probed

  Cards assigned to a person across all boards, soonest deadline first. Defaults to the publisher who owns this connection — pass assignee_id for a teammate.

  mcp-tool

  123456789101112131415

  {
    "type": "object",
    "required": [],
    "properties": {
      "assignee_id": {
        "type": "string",
        "description": "Whose tasks (optional). Ids come from list_kanban_members."
      },
      "include_done": {
        "type": "boolean",
        "description": "Include cards already in a done column (default false)."
      }
    },
    "additionalProperties": false
  }

  arguments 15 lines copy
• get_kanban_comments unknown never probed

  Read the comment thread of a card, oldest first.

  mcp-tool

  12345678910111213141516171819202122

  {
    "type": "object",
    "required": [
      "project_id",
      "card_id"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "description": "How many comments (default 100)."
      },
      "card_id": {
        "type": "string",
        "description": "Card whose thread to read."
      },
      "project_id": {
        "type": "string",
        "description": "Board the card belongs to."
      }
    },
    "additionalProperties": false
  }

  arguments 22 lines copy
• list_kanban_members unknown never probed

  Who can be assigned a card, watch it or be mentioned: the publisher and the teammates with kanban access. Returns ids and emails — use the id for set_kanban_assignee.

  mcp-tool

  123456

  {
    "type": "object",
    "required": [],
    "properties": {},
    "additionalProperties": false
  }

  arguments 6 lines copy
• create_kanban_card unknown never probed

  Add a card to a column. The server assigns the human key (OPUS-451) — it is in the reply.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839

  {
    "type": "object",
    "required": [
      "project_id",
      "column_id",
      "title"
    ],
    "properties": {
      "title": {
        "type": "string",
        "description": "Card title — what has to be done."
      },
      "card_id": {
        "type": "string",
        "description": "Id to give the card (optional). Pass your own to make a retry safe: adding the same id twice is a no-op instead of a duplicate."
      },
      "due_date": {
        "type": "string",
        "description": "Deadline, ISO-8601 like 2026-09-30 (optional)."
      },
      "priority": {
        "type": "string",
        "description": "None | Low | Medium | High | Critical (optional, default Medium)."
      },
      "column_id": {
        "type": "string",
        "description": "Column to add to (ids come from get_kanban_board)."
      },
      "project_id": {
        "type": "string",
        "description": "Board to add to."
      },
      "description": {
        "type": "string",
        "description": "Details (optional)."
      }
    },
    "additionalProperties": false
  }

  arguments 39 lines copy
• update_kanban_card unknown never probed

  Change a card's title, description, priority or deadline. Fields you leave out stay as they are — this is a patch, not a replacement.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738

  {
    "type": "object",
    "required": [
      "project_id",
      "card_id"
    ],
    "properties": {
      "title": {
        "type": "string",
        "description": "New title (optional)."
      },
      "card_id": {
        "type": "string",
        "description": "Card to change."
      },
      "due_date": {
        "type": "string",
        "description": "New deadline, ISO-8601 (optional)."
      },
      "priority": {
        "type": "string",
        "description": "None | Low | Medium | High | Critical (optional)."
      },
      "project_id": {
        "type": "string",
        "description": "Board the card belongs to."
      },
      "description": {
        "type": "string",
        "description": "New description (optional)."
      },
      "clear_due_date": {
        "type": "boolean",
        "description": "Remove the deadline (optional). Leaving due_date out keeps it."
      }
    },
    "additionalProperties": false
  }

  arguments 38 lines copy
• move_kanban_card unknown never probed

  Move a card to another column (or to another position in the same one). Moving it into a done column also completes the task and awards its XP; moving it back out clears the completion mark. The reply says which happened.

  mcp-tool

  123456789101112131415161718192021222324252627

  {
    "type": "object",
    "required": [
      "project_id",
      "card_id",
      "to_column_id"
    ],
    "properties": {
      "card_id": {
        "type": "string",
        "description": "Card to move."
      },
      "to_index": {
        "type": "integer",
        "description": "Position inside that column, 0 = top (default 0)."
      },
      "project_id": {
        "type": "string",
        "description": "Board the card belongs to."
      },
      "to_column_id": {
        "type": "string",
        "description": "Destination column."
      }
    },
    "additionalProperties": false
  }

  arguments 27 lines copy
• set_kanban_assignee unknown never probed

  Assign a card to someone, or clear the assignee. The person is notified.

  mcp-tool

  12345678910111213141516171819202122

  {
    "type": "object",
    "required": [
      "project_id",
      "card_id"
    ],
    "properties": {
      "card_id": {
        "type": "string",
        "description": "Card to assign."
      },
      "project_id": {
        "type": "string",
        "description": "Board the card belongs to."
      },
      "assignee_id": {
        "type": "string",
        "description": "Who to assign it to (from list_kanban_members). Omit to clear."
      }
    },
    "additionalProperties": false
  }

  arguments 22 lines copy
• delete_kanban_card unknown never probed

  Delete a card. IRREVERSIBLE, and its task key is never reused — ask the publisher before calling this. To take a card off the board without losing it, move it instead.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "required": [
      "project_id",
      "card_id"
    ],
    "properties": {
      "card_id": {
        "type": "string",
        "description": "Card to delete."
      },
      "project_id": {
        "type": "string",
        "description": "Board the card belongs to."
      }
    },
    "additionalProperties": false
  }

  arguments 18 lines copy
• add_kanban_comment unknown never probed

  Post a comment on a card. It appears under the publisher's own name, so write as the assistant, not as them. Mentioned people are notified.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334

  {
    "type": "object",
    "required": [
      "project_id",
      "card_id",
      "body"
    ],
    "properties": {
      "body": {
        "type": "string",
        "description": "Comment text."
      },
      "card_id": {
        "type": "string",
        "description": "Card to comment on."
      },
      "project_id": {
        "type": "string",
        "description": "Board the card belongs to."
      },
      "mention_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "People to notify, ids from list_kanban_members (optional)."
      },
      "parent_comment_id": {
        "type": "string",
        "description": "Reply to this comment (optional)."
      }
    },
    "additionalProperties": false
  }

  arguments 34 lines copy
• delete_kanban_column unknown never probed

  Delete a column TOGETHER WITH EVERY CARD IN IT. IRREVERSIBLE — ask the publisher first, and move the cards out with move_kanban_card if they should survive.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "required": [
      "project_id",
      "column_id"
    ],
    "properties": {
      "column_id": {
        "type": "string",
        "description": "Column to delete."
      },
      "project_id": {
        "type": "string",
        "description": "Board the column belongs to."
      }
    },
    "additionalProperties": false
  }

  arguments 18 lines copy
• reorder_kanban_columns unknown never probed

  Set the left-to-right order of the columns. Pass every column id of the board.

  mcp-tool

  123456789101112131415161718192021

  {
    "type": "object",
    "required": [
      "project_id",
      "column_ids"
    ],
    "properties": {
      "column_ids": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "All column ids, in the order they should appear."
      },
      "project_id": {
        "type": "string",
        "description": "Board to reorder."
      }
    },
    "additionalProperties": false
  }

  arguments 21 lines copy
• begin_build_upload unknown never probed

  Start uploading a READY web build of the game (static files: index.html + assets — e.g. Vite dist/, Unity WebGL) to a Title. Returns build_id, a one-hour upload_url and asset_base. Build the game with asset_base as its base path (or a relative './'), zip the CONTENTS of the output folder so index.html is at the zip root, upload it with `curl -T build.zip "<upload_url>"` (a plain HTTP PUT of the file, no headers), then call finish_build_upload. Needs a shell to run the upload — a browser-only client cannot upload files. Free: only the storage it takes counts toward the publisher's quota. The build must be the GAME ITSELF, hosted here: on the Title's idosgames.com page the game may embed (iframe) only platform hosts, never another website, so a wrapper that frames the publisher's own site shows "Content unavailable" there instead of the game. Network requests (fetch/WebSocket) from the embedded game reach platform hosts plus the Title's Blockchain.IframeConnectHosts (save_blockchain; wallet-connection hosts are always refused).

  mcp-tool

  12345678910111213

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "title_id": {
        "type": "string",
        "description": "Live TitleID (not the -DEV copy)."
      }
    },
    "additionalProperties": false
  }

  arguments 13 lines copy
• finish_build_upload unknown never probed

  Finish an upload started with begin_build_upload: unpacks the zip into a new version of the Title (it appears in the dashboard's version history) and waits up to ~100 s. Returns the version with a TestUrl to try it before players see it. deploy=true also puts it live for players on the Title's address and its idosgames.com page. If it is still unpacking when the call returns, poll get_build. Calling it again with the same build_id returns the same version (with deploy=true it deploys a version that is ready).

  mcp-tool

  1234567891011121314151617181920212223242526

  {
    "type": "object",
    "required": [
      "title_id",
      "build_id"
    ],
    "properties": {
      "label": {
        "type": "string",
        "description": "Optional short name of the version shown in the history (\"Added the shop\")."
      },
      "deploy": {
        "type": "boolean",
        "description": "true = put this version live for players as soon as it is unpacked. Default false: only a test version."
      },
      "build_id": {
        "type": "string",
        "description": "build_id returned by begin_build_upload."
      },
      "title_id": {
        "type": "string",
        "description": "Live TitleID (the same one passed to begin_build_upload)."
      }
    },
    "additionalProperties": false
  }

  arguments 26 lines copy
• get_build unknown never probed

  State of one version of the Title's game: status (Queued, Building, Staged = ready to deploy, Live, Failed), errors, test and live links. Use it to poll finish_build_upload.

  mcp-tool

  123456789101112131415161718

  {
    "type": "object",
    "required": [
      "title_id",
      "build_id"
    ],
    "properties": {
      "build_id": {
        "type": "string",
        "description": "build_id of the version."
      },
      "title_id": {
        "type": "string",
        "description": "Live TitleID."
      }
    },
    "additionalProperties": false
  }

  arguments 18 lines copy
• list_builds unknown never probed

  Recent versions of the Title's game, newest first — uploaded ones and ones built by the AI Coder — with which one players get now.

  mcp-tool

  1234567891011121314151617

  {
    "type": "object",
    "required": [
      "title_id"
    ],
    "properties": {
      "limit": {
        "type": "integer",
        "description": "How many versions to return (default 10, max 30)."
      },
      "title_id": {
        "type": "string",
        "description": "Live TitleID."
      }
    },
    "additionalProperties": false
  }

  arguments 17 lines copy
• remix_video unknown never probed

  Remix an existing video job with new instructions. Starts a new job — poll get_video. ASYNC: returns a job with an id and status — poll get_video for the result.

  mcp-tool

  12345678910111213141516171819202122

  {
    "type": "object",
    "required": [
      "video_id",
      "prompt"
    ],
    "properties": {
      "prompt": {
        "type": "string",
        "description": "What to change."
      },
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game."
      },
      "video_id": {
        "type": "string",
        "description": "Source job id to remix."
      }
    },
    "additionalProperties": false
  }

  arguments 22 lines copy
• save_title_data unknown never probed

  Write the authored (Static) part of the title's key-value data store. REPLACES the whole bucket: read it with get_title_data first and send it back extended, or omitted keys are deleted. The Runtime scope CANNOT be written here — mutable title state is owned by CloudCode scripts, so their counters are never overwritten behind their back. Register keys in the TitleCustomData config section (save_title_custom_data) for type validation, limits, TTL and defaults.

  mcp-tool

  123456789101112131415161718192021222324252627

  {
    "type": "object",
    "required": [
      "title_id",
      "bucket",
      "values"
    ],
    "properties": {
      "bucket": {
        "enum": [
          "Public",
          "Private"
        ],
        "type": "string",
        "description": "Public = readable by game clients; Private = server/CloudCode only."
      },
      "values": {
        "type": "object",
        "description": "Object of key → string value. Replaces the whole bucket. JSON-encode structured values yourself."
      },
      "title_id": {
        "type": "string",
        "description": "TitleID."
      }
    },
    "additionalProperties": false
  }

  arguments 27 lines copy
• create_kanban_project unknown never probed

  Create a board. It comes with a default set of columns, so you can add cards right away.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "required": [
      "name"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Board name."
      },
      "color": {
        "type": "string",
        "description": "Accent colour, hex like #3B82F6 (optional)."
      },
      "emoji": {
        "type": "string",
        "description": "Icon, a single emoji (optional)."
      },
      "description": {
        "type": "string",
        "description": "What this board is for (optional)."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• create_kanban_column unknown never probed

  Add a column to a board.

  mcp-tool

  12345678910111213141516171819202122

  {
    "type": "object",
    "required": [
      "project_id",
      "name"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "Column name."
      },
      "color": {
        "type": "string",
        "description": "Accent colour, hex (optional)."
      },
      "project_id": {
        "type": "string",
        "description": "Board to add the column to."
      }
    },
    "additionalProperties": false
  }

  arguments 22 lines copy
• update_kanban_column unknown never probed

  Rename a column, recolour it, or mark it as the done column. Cards entering a done column count as completed and award XP.

  mcp-tool

  123456789101112131415161718192021222324252627282930

  {
    "type": "object",
    "required": [
      "project_id",
      "column_id"
    ],
    "properties": {
      "name": {
        "type": "string",
        "description": "New name (optional)."
      },
      "color": {
        "type": "string",
        "description": "New accent colour (optional)."
      },
      "is_done": {
        "type": "boolean",
        "description": "Whether this is the done column (optional)."
      },
      "column_id": {
        "type": "string",
        "description": "Column to change."
      },
      "project_id": {
        "type": "string",
        "description": "Board the column belongs to."
      }
    },
    "additionalProperties": false
  }

  arguments 30 lines copy
• generate_image unknown never probed

  Generate an image (icon, sprite, art) for the title. The result has a CDN URL in Assets — reference that URL from the title config or code. Runs as a job: the call waits up to about two minutes and returns the result; if it is not ready by then it returns the generation with status queued/running — poll get_generation with its id.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536

  {
    "type": "object",
    "required": [
      "prompt"
    ],
    "properties": {
      "tier": {
        "type": "string",
        "description": "Quality/price tier, e.g. image-cheap or video-premium. Call list_ai_tiers for the current list. Omit it to use this title's default tier."
      },
      "model": {
        "type": "string",
        "description": "Model name, if you insist on a specific one (optional). ⚠ Setting it cancels the tier COMPLETELY — together with its provider and its settings — so params may stop applying. Prefer `tier`."
      },
      "params": {
        "type": "object",
        "description": "Model settings, as declared by the vendor for the chosen tier — for example {\"aspect_ratio\":\"16:9\",\"resolution\":\"720p\",\"duration\":\"4\"}. Call list_ai_tiers to see which keys this tier accepts, their allowed values and defaults. Values are strings. Unknown keys are ignored rather than rejected.",
        "additionalProperties": {
          "type": "string"
        }
      },
      "prompt": {
        "type": "string",
        "description": "What to generate."
      },
      "provider": {
        "type": "string",
        "description": "Provider key, if you insist on one (optional). Cancels the tier the same way."
      },
      "title_id": {
        "type": "string",
        "description": "Which game this is for — a label for the report, optional. Credits are always the publisher's, so leaving it out is normal for assets that belong to no game."
      }
    },
    "additionalProperties": false
  }

  arguments 36 lines copy