iDos Games

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.

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).

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

Add a column to a board.

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

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.

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.

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.

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.

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).

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.

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.

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.

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.

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

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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).

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.

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.

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).

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.

Get the base every NEW project starts from — the host shell with sign-in and the lobby (index.html, main.tsx, src/app.config.ts, the wallet files, an empty src/modules.ts, config; the lobby and sign-in come from @idosgames/app-shell). Write these files to the project root, install the versions from get_manifest, then add modules with get_module: the systems with inBase, the game(s) with the modules each game 'uses', and any other system the app needs. Read-only; takes no title_id.

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.

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.

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.

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.

Read the comment thread of a card, oldest first.

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.

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.

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.

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.

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.