Operate the live game
universeOperate on a published Roblox experience via Open Cloud: restart live servers, message players, manage bans, inspect logs, read analytics, and schedule events.
Instructions
Acts on the PUBLISHED experience and the people in it — not on the place open in Studio.
restart rolls live servers onto the version you just published. Publishing on its own changes nothing for anyone already playing: they stay on their server, running the old code, until it empties. This is the step people forget. By default it bleeds off over 10 minutes — matchmaking stops and players finish what they are doing — rather than shutting servers down under them, which is what Roblox's own default does.
message publishes to MessagingService, reaching every live server at once. Only servers with a SubscribeAsync listener on that exact topic receive it, and nothing reports whether anything was listening, so success here does not mean delivery.
ban and unban set a player's game-join restriction. A ban with no durationSeconds is PERMANENT. displayReason is shown to the player; privateReason is for your records. Scope it to one place with placeId, or leave that out to cover the whole experience. bans lists who is currently restricted.
user looks up a user id — the name-to-id step most other calls need. inventory reports what someone owns: passes, badges, assets.
servers lists the place's live servers — players, uptime, frame rate, memory, version — and logs reads one server's errors and warnings by its jobId, with stack traces and structured-log context. That is where a player's bug report actually happened; Studio only shows your own test. Roblox keeps warnings and errors only, and they arrive about three minutes after they are written.
products lists the game's developer products and game passes with their ids and prices — the ids a purchase script needs. sell creates one, or changes one given itemId. Creating checks the name first, so a retried create cannot leave two "100 Coins" products.
analytics reads the game's own numbers over a date range: players, revenue, retention, crashes, frame rate, as a time series, optionally split by a breakdown such as Platform or Country. Common metrics: DailyActiveUsers, Visits, DailyRevenue, PayingUsers, ForwardD1Retention, AverageSessionLengthMinutes, PeakConcurrentPlayers, ClientCrashCount, ClientFpsP50. Give days for the last N whole UTC days, or startTime and endTime.
events lists the game's scheduled events, or reads one by eventId. schedule creates one (title, startTime, endTime) or changes one given eventId; cancel deletes it. Players see these on the experience's page.
Everything here needs an Open Cloud key and a universe id. The user sets both once with cloud in the Studio panel.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | 'restart' rolls servers onto the new version, 'message' publishes to MessagingService, 'ban'/'unban'/'bans' manage player access, 'user' and 'inventory' look someone up, 'servers' and 'logs' read live servers, 'products' and 'sell' manage products and passes, 'analytics' reads metrics, 'events'/'schedule'/'cancel' manage scheduled events. | |
| days | No | analytics only: the last N whole UTC days, not counting today. Default 7. | |
| kind | No | products/sell: 'product' is a developer product (bought again and again: currency, boosts), 'pass' a game pass (bought once: VIP, perks). products lists both when omitted; sell needs it. | |
| name | No | sell only: the item's name. Required to create. | |
| image | No | sell only: path to a local .png/.jpg/.bmp/.tga icon. | |
| jobId | No | logs only: the server, as listed by `servers`. | |
| limit | No | bans/inventory/servers/logs/events: how many rows to return. analytics: most breakdown series. | |
| price | No | sell only: price in Robux. | |
| title | No | schedule only: the event's title. | |
| topic | No | message only: the MessagingService topic. | |
| filter | No | inventory: an Open Cloud filter, e.g. `gamePassIds=123` or `assetIds=456`, to ask about specific items rather than listing everything. servers: a CEL filter over the server fields, e.g. `occupancy > 0`. analytics: Dimension=a,b;Dimension=c, e.g. `Platform=Phone,Tablet;Country=US`. | |
| itemId | No | sell only: the product or pass to change. Omit to create a new one. | |
| metric | No | analytics only: the metric, e.g. DailyActiveUsers. | |
| search | No | logs only: case-insensitive text to find in the message, stack trace or context. | |
| userId | No | ban/unban/user/inventory: the player's user id. | |
| confirm | No | Required for restart, message, ban, unban, sell, schedule and cancel. Each of these is visible to players the moment it runs and none can be undone from here. | |
| endTime | No | analytics/schedule: ISO 8601 UTC end. analytics: exclusive. | |
| eventId | No | events/schedule/cancel: the event, as listed by `events`. | |
| forSale | No | sell only: whether players can buy it. Say it explicitly when creating. | |
| message | No | message only: the payload, as a string. | |
| placeId | No | ban/unban: restrict to this place only, instead of the whole experience. restart: only restart this place's servers. servers/logs: which place, defaulting to `cloud place`. | |
| severity | No | logs only: just this level. Omit for both. | |
| subtitle | No | schedule only: a line under the title. | |
| breakdown | No | analytics only: dimensions to split by, e.g. ["Platform"]. | |
| startTime | No | analytics/schedule: ISO 8601 UTC start, e.g. 2026-11-07T18:00:00Z. analytics: inclusive. | |
| universeId | No | Which game. Omit to use the one set with `cloud universe <id>`. | |
| visibility | No | schedule only: e.g. public. | |
| description | No | sell/schedule: the item's or event's description. | |
| granularity | No | analytics only: size of each time bucket. Default OneDay. Which a metric allows varies. | |
| displayReason | No | ban only: shown to the player when they are turned away. | |
| privateReason | No | ban only: your own record. The player never sees it. | |
| bleedOffMinutes | No | restart only: minutes to let existing servers drain. 0 shuts them down immediately, moving players mid-game. Defaults to 10. | |
| durationSeconds | No | ban only: how long, in seconds. OMIT THIS AND THE BAN IS PERMANENT — say so to the user before you do it. | |
| excludeAltAccounts | No | ban only: if true, the ban applies to this account alone rather than to alts Roblox links to it. Defaults to false. |