Short answers to the questions members and developers ask most. Each answer comes first; open the folded part for the detail behind it. Each links to the page that explains it in full.
Signing in and roles
How do I sign in to the panel?
With GitHub, as an active member of the BlockoutGames GitHub organization. There is no other way in. See Sign-in and access.
What sign-in asks of your GitHub account
The studio's app asks only to read your organization memberships (read:org). Your name, login
and avatar are taken from GitHub at every sign-in, and GitHub's organization owners sign in as
panel owners.
Why can't I sign in?
Only active members of the BlockoutGames organization can: a pending invitation or an outside collaborator is refused and sent to the public website. Ask an owner to invite you on GitHub, then accept the invitation. See Sign-in and access.
Refused several times, or another error
After 3 refusals from one address in 15 minutes, that address goes straight to the notice until the 15 minutes pass. Other failures land on the sign-in page with a reason: GitHub unavailable, Not trusted, Interrupted (over ten minutes, or a second sign-in started), Cancelled or Too many attempts. Each can be retried.
Why was I signed out?
Your session reached its limit, or your role or membership changed on GitHub. See Sign-in and access.
Every reason a session ends
A session lasts 30 days from its last extension and never more than 90 days from sign-in. It also ends when you sign in again in the same browser, sign out elsewhere, end it on Settings, Sessions, an owner ends it, or GitHub says you left the organization or changed role. If GitHub cannot be reached for more than 30 minutes, the panel asks you to sign in again.
How do I become an owner?
Only by being made an owner of the BlockoutGames GitHub organization; nobody edits roles in the panel. See Roles.
When the new role takes effect
The studio notices the change within about 5 minutes and ends every session of yours, so your next sign-in carries the new role.
What can an owner do that a member cannot?
Open the Admin pages, register Roblox groups and their keys, set a game's release state, remove a game from the studio, and edit any game's details and contract. See Roles.
What an owner still cannot do
An owner cannot change an approved contract, and does not sign the contract of a game they are not a developer on. Roles come from GitHub, so an owner cannot make someone else an owner in the panel.
Projects, contracts and releases
How do I register a new game?
On the Studio Games page, choose Register a game, name it, tick its developers and pick its Roblox group's game or No Roblox game yet. See Projects.
Limits and refusals when registering
A name up to 80 characters, a description up to 500, and 1 to 10 developers who have signed in. A group's game must be owned by a registered group, and a game that already has a project is refused.
How is a game split between its developers?
Developers keep 60% for one developer, 70% for two, 80% for three; the rest is a pool of 10% shares sold to the studio. See How a game is split.
How the developers' part is divided
Each developer holds at least 10%, and the parts must add up to exactly the developers' part. The draft starts equal, the odd basis point to the first named. Four or more developers is an assumption the founder has not confirmed.
How do I sign a contract?
On the game's Contract tab, press Sign, read the PDF, draw or type your signature, tick the agreement and press Sign the contract. See Signing a contract.
Why a signature can be refused
The contract must be submitted, you must be named on it, and you must sign the version that is current: if it changed since you opened it, read the new version and sign that.
Can a contract be changed after it is approved?
No. After the last signature nothing changes it, not even an owner. See Contracts.
Changes before approval
Before submission, the draft changes freely. After submission, any change to names or parts makes a new version with a new PDF and clears every signature.
How do I remove a developer from a project?
Take them off the developers on the game's Contract tab. They become a leaver, and the contract cannot be approved until they sign it. See Contracts.
Removing yourself
A developer who removes themselves, or lowers their own part, needs no extra consent and does not become a leaver.
When does my game count as released?
When its contract is approved and the collector first reads it public on Roblox afterwards. See Games and releases.
How quickly the release is recorded
The release job runs every 5 minutes. It records the release time and week once, writes the developers' points in the same step, and opens the share sale. A game still private at approval is released when it is first read public.
Points and shares
How many points do I get when my game is released?
One point for every studio member who did not work on the game. In a studio of five, a solo developer earns 4. See Points.
Who counts as a member for points
Everyone the GitHub organization admitted who has signed in to the panel. The count is taken once, at release. If the third member buys a share, each developer also earns a bonus point.
When do my points expire?
A point can be spent in the week it was earned and the two after. From Monday 00:00 UTC of the third week after, it has expired. See Points.
Which point is spent first
Always your oldest point that can still be spent: the earliest week, then the earliest earned. In a point's last week you get a notification that it expires.
How do I buy a share of a game?
Open the game's Shares tab during its sale and press Buy a share. It costs one point, your oldest. See Shares and the share sale.
Where to find games on sale
The Points page lists the games on sale to you now, and you are notified when a game goes on sale and in its last week.
Why can't I buy a share?
The Shares tab says why. See Shares and the share sale.
Every reason a purchase is refused
The game is not released yet, you worked on it, you already hold one, the sale has closed, it has no pool, every share is bought, or you have no point left to spend.
What happens to shares nobody buys?
When the sale closes, unsold shares return to the developers in proportion to their parts. See Shares and the share sale.
How the return is worked out
Nothing is written when the sale closes: ownership is worked out from the contract, the purchases and the date, in whole basis points, with rounding going to the largest remainders.
Does owning a share pay me money?
No. The panel records ownership only; it does not pay out or track money owed. See Shares and the share sale.
Where revenue is shown
Revenue is what Roblox reports for the studio's games, on Studio revenue. It is not divided by the split, and the old finance ledger is retired.
When does a studio week start?
Monday 00:00 UTC, which may be Sunday evening where you live. See Studio weeks.
What runs on studio weeks
Contracts, releases, points and the share sale. Code pages count in GitHub's weeks, which start on Sunday, and the two are never compared.
The market and the numbers
How often are player counts updated?
Every 5 minutes for hot games, down to once a week for dead ones, by the game's tier. See Collector and data freshness.
The tiers and how fast data reaches the panel
Hot every 5 minutes, active every 15, warm every hour, cold every day, dead every week. New data reaches the panel within about 30 seconds of being stored. See Tier.
Why is a number shown as a dash?
Nobody has read it yet, or there is not enough history. An empty number is never a zero, and the dash says why. See Freshness and empty numbers.
When a dash turns into a number
When the collector next reads the game, or once enough history exists for a change to be worked out.
How do I start tracking a game the studio does not know?
Open its page in the panel, /games/<universe id>. The panel looks it up on Roblox and tracks it from then on. See Market.
What opening an untracked game costs
It is one of the few reads of Roblox a page makes, and it counts against the collector's Roblox budget. See The Roblox budget.
How do I get told when a game breaks out?
Watch it: press Watch on its page. You are notified when its breakout score reaches 60, among other things. See Watching games.
Turning watchlist notifications on or off
Each kind of notification has its own switch on Settings, Notifications, in the Watchlist group.
How do I get notifications on my phone?
Turn them on for the device in Settings, Notifications. On an iPhone, add the panel to your Home Screen from Safari first. See Notifications.
iPhone and Android
On an iPhone, notifications need iOS 16.4 or later and work only from the Home Screen app. On Android, Chrome shows them from a browser tab too. See The panel on a phone.
Where does studio revenue come from?
From what Roblox reports for the studio's games, read once a day with each game's group key. It is revenue reported, not money received. See Studio pages.
Why a game has no revenue
Its group has no registered key, or the key lacks the analytics permission, so the daily owned numbers cannot be read.
Why does my game's analytics say Not configured?
Its Roblox group has no registered key, so the daily owned numbers cannot be read. An owner registers the group and its key. See Roblox groups and keys.
What the key needs for analytics
The optional universe.analytics:read permission. Without it, the key is stored and works for
registration, and analytics show as missing.
The panel and the assistant
Can the assistant change things for me?
No. It only reads, as you, with your permissions. See The assistant.
Its limits
Signing, buying, watching and changing settings are out of its reach, and so is anything you could not open yourself, such as the Admin pages for a member.
How do I search the panel or the docs?
Press Ctrl+K or ⌘K, or /, for quick jump in the panel. The docs site, docs.blockoutgames.com, has its own search under the same keys. See Keyboard shortcuts.
What quick jump finds
Any panel page, any studio game and any game the market tracks, by part of its name. Docs search starts after two characters and opens each result at its heading.
How do I stop single keys from triggering shortcuts?
Set Single-key shortcuts to Off on Settings, Shortcuts. Ctrl+K keeps working. See Keyboard shortcuts.
Which keys it stops
/, t, i, ? and g then a letter. Keys inside a control, such as the arrows on a chart,
keep working.
Game developers and the API
How do I get an API key for my game?
On the game's Developer tab, choose Create key and copy it at once. Owners and the game's developers and lead can. See Getting a game's API key.
What the key looks like
bk_live_ and 43 characters, one in use per game, shown once. The panel shows only its
fingerprint afterwards.
I lost my game's API key. Can I see it again?
No: it is shown only once. Choose Rotate key to make a new one, and put it in the BlockoutApiKey secret. See Getting a game's API key.
Why it cannot be shown again
The platform keeps only a hash of the key, so nobody can read it back, owners included.
Where do I put the API key in Roblox?
In the experience's secrets as BlockoutApiKey, domain studio.blockoutgames.com: the Creator Dashboard for live servers, Studio's Local Secrets for testing. Never in a script. See Keeping a game's key secret.
Why never in a script
Anyone who can open the place can read its scripts. A secret is readable only by the game's servers, for the domain it names.
What do I do if my game's key leaked?
Rotate it on the Developer tab at once and update the secret; the old key stops immediately. See Keeping a game's key secret.
Rotate or revoke
Rotate key replaces it with a new one. Revoke key stops it with no replacement, so the game's servers can send nothing until someone creates a new key.
How many requests can my game make?
120 a minute for every server of the game together, reads and feedback alike. See Errors, limits and polling.
The other limits
Every key together shares 1,200 a minute, and one address may send at most 240 posts a minute. A
cached answer and a 304 count too.
Why does my game get 429 Too Many Requests?
Its servers asked more than 120 times in a minute together. Wait the Retry-After seconds. See Errors, limits and polling.
How to stay under the limit
Read through one shared cache for all the game's servers, such as the Template's platform service, instead of each server asking on its own.
Why does my game get 401?
The key is missing, wrong, rotated or revoked, or the game left the studio's catalog. Check the BlockoutApiKey secret. See Errors, limits and polling.
After a rotation
The old key stops at once. Put the new key in the BlockoutApiKey secret on the Creator Dashboard
(and in Studio's Local Secrets for testing).
Why does GET /developer/v1/games/:id answer 404?
The platform does not track that game, and a key never starts tracking one. Ask an owner to open the game's page in the panel. See GET /developer/v1/games/:id.
Why a key cannot start tracking
Tracking a game costs reads of Roblox from the collector's budget, so only opening the game's page in the panel starts it. See The Roblox budget.
How do I read the players of many games at once?
GET /developer/v1/games?ids=… with up to 100 universe ids, or PlatformService.games({ ids = … }) in the Template. See Building a market game.
Why one request for many
One request for 100 games costs one of the key's 120 a minute, where 100 single reads would cost 100.
How fresh is the data the API returns?
It is the platform's stored data: a game's ccu is from its last reading, lastSnapshotAt, every 5 minutes to once a week by tier. See Errors, limits and polling.
Caching
Answers are cached for 60 seconds, so polling more often than once a minute returns the same answer.
How do I send player feedback from my game?
In a Template game, switch the platform on and players use the Feedback window; or call PlatformService.sendFeedback. Otherwise post to POST /developer/v1/feedback. See Sending feedback from Luau.
Where the feedback goes
To the game's Feedback tab in the panel, where its crew triages it. Each piece carries an idempotency key, so a retry is stored once.
Do I need the Blockout Template to use the API?
No, but it does the shared cache, retries and feedback window for you. See The developer API.
Calling the API without the Template
Any game can call the routes from a server script with HttpService:RequestAsync, sending the key
from its secret. Only from server code: a client script is readable by players.
Why does PlatformService answer unavailable?
The server could not read the BlockoutApiKey secret. See The Template's platform service.
Where the secret must be set
It is not set for this experience on the Creator Dashboard, or, in Studio, not set as a local secret.
Can a game's key read studio data or feedback?
No. A key reads market data and posts feedback. See Reading market data.
What is out of a key's reach
Projects, contracts, points, revenue and any game's feedback, its own included.
Updated