scenario-roblox-monetization — скилл для Claude Code: установка
Скилл scenario-roblox-monetization для Claude Code помогает настраивать монетизацию и live ops в играх Roblox. Подключается к задачам с покупками, чеками, ценами, случайными предметами и аналитикой.
MIT 349 установок ★ 3 964 обновлён 2026-10-23
npx skills add scenario-labs/skills --skill scenario-roblox-monetization -a claude-codeЧто делает scenario-roblox-monetization
Скилл помогает проверять и настраивать монетизацию Roblox-игры: каталог товаров, обработку чеков, внутриигровые льготы, цены и аналитику. Для покупок он задаёт проверку сохранённого профиля, чтобы повторный чек не выдавал награду второй раз. Есть сценарии для платных случайных предметов и экспериментов с настройками.
Работа идёт через Roblox Studio и инструментарий scenario-roblox-expert; для слоя данных нужен scenario-roblox-data с Receipts. В неопубликованной игре можно тестировать синтетические чеки, но аналитике, конфигам, рекламе и поиску товаров нужна опубликованная игра. Скилл также описывает аудит проекта и проверки чеков.
Какие задачи решает
- проверить пути покупки и выдачу наград по чекам
- найти повторную обработку покупки
- собрать каталог товаров без ценовых значений
- настроить раскрытие шансов платных случайных предметов
- проверить аналитику и live-конфиги игры
Примеры запросов агенту
- Проведи аудит монетизации этой игры и найди все пути покупки.
- Проверь обработку чеков, чтобы повторная покупка не выдала награду дважды.
- Настрой показ шансов для платных случайных предметов.
Как установить scenario-roblox-monetization
1Через Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-roblox-monetization -a claude-code2Вручную: положить файлы
~/.claude/skills/scenario-roblox-monetization/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/scenario-roblox-monetization/
1Через Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-roblox-monetization -a codex2Вручную: положить файлы
.agents/skills/scenario-roblox-monetization/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-roblox-monetization -a cursor2Вручную: положить файлы
.cursor/skills/scenario-roblox-monetization/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install scenario-labs/skills skills/game-engines/roblox/scenario-roblox-monetization2Вручную: положить файлы
.github/skills/scenario-roblox-monetization/SKILL.md1Через Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-roblox-monetization -a gemini-cli2Командой платформы
gemini skills install https://github.com/scenario-labs/skills --path skills/game-engines/roblox/scenario-roblox-monetizationВручную: положить файлы
.devin/skills/scenario-roblox-monetization/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add scenario-labs/skills --skill scenario-roblox-monetization -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о scenario-roblox-monetization
Как установить scenario-roblox-monetization в Claude Code?
Выполни npx skills add scenario-labs/skills --skill scenario-roblox-monetization -a claude-code. Файл скилла появится по пути ~/.claude/skills/scenario-roblox-monetization/SKILL.md.
Что делает scenario-roblox-monetization?
Помогает разбирать монетизацию Roblox-игры: каталог продуктов, чеки и награды, цены, льготы, аналитику и live-конфиги.
Что нужно для работы scenario-roblox-monetization?
Нужны Roblox Studio, инструментарий scenario-roblox-expert и слой данных scenario-roblox-data с Receipts. Аналитике, конфигам, рекламе и поиску товаров требуется опубликованная игра.
Исходный текст
SKILL.md · MIT
---
name: scenario-roblox-monetization
description: "Use when a Roblox game sells something or plans live ops: Developer Products, game passes, experience subscriptions, Roblox Plus perks, ProcessReceipt or BindReceiptHandler, \"bought it but didn't get it\", a purchase granted twice, shop UI prices, eggs, crates or loot boxes with odds (paid random items, PolicyService), rewarded video ads, AnalyticsService funnels, economy or custom events, ConfigService live config, A/B experiments, price optimization or regional pricing, game thumbnails and icons, play-through rate, Creator Rewards, Ads Manager campaigns, or a launch and update plan."
license: MIT
---
# Roblox Monetization and Live Ops
Target: Roblox Studio (October 2026 build) on macOS, driven through the scenario-roblox-expert
toolkit.
Expert level here means every Robux path ends in one server receipt handler that grants only what
the saved profile confirms, prices and odds come from one source the engine or a config owns, and
every live change ships behind a config with a metric that decides it. The agent builds and tests
the code in an unpublished place; product creation, dashboards and store art uploads stay with the
owner.
If a sibling skill named here is missing from your available skills, load it with `skill_get`
(Scenario MCP) or ask the user to install it (https://github.com/scenario-labs/skills#install);
unattended, proceed from tool schemas and flag the gap.
**REQUIRED BACKGROUND:** scenario-roblox-expert (channels, review loop, toolkit, current-Roblox
traps).
## Stance (the expert delta)
1. **Grant only in the receipt handler, and only after the save.** `PurchaseGranted` means the saved
profile holds the `PurchaseId`; anything else answers `NotProcessedYet`. Prompt-finished events
are not proof of payment (Creator Docs, developer products; Stewiepfing). The docs sample answers
granted when the handler returns nil; the receipts suite reproduces that bug.
2. **One handler per server.** New code uses `BindReceiptHandler`; legacy code assigns
`ProcessReceipt` once, in one Script (MarketplaceService reference). Live, a second catch-all
bind errors, while a second `ProcessReceipt` assignment is accepted without a warning.
3. **Prices come from the engine, on the client.** Typed prices block price optimization and show
Plus subscribers a price they do not pay (Creator Docs, managed pricing, Roblox Plus). The server
never needs a price to grant.
4. **One odds table for the roll and the disclosure, gated per player.** Show every outcome with
numerical odds before spend, and check `ArePaidRandomItemsRestricted` per player (Creator Docs,
paid random items). Prompt random items from the server after that check [added].
5. **Monetize every intended mechanic at launch, cheaply.** Starter bundles at 25 to 99 Robux; many
small spenders beat one high price; never gate basics such as movement (Roblox monetization leads
and studio heads, RDC 2025). Adding payment later reads as pay to win.
6. **Every risky change ships behind a config, and data decides it.** Read experiment values on the
player snapshot where the player meets the feature, check the minimum detectable effect first,
and let guardrails such as disconnects outrank a modest gain (Creator Docs, experiments; Roblox
experiments team and studios, RDC 2025).
7. **The click gates discovery.** Play-through rate and first-play bounce replaced QPTR; ranking
learns only from organic Home traffic, and thumbnails must show the real game (Roblox discovery
leads, RDC 2026 and RFY Q&A; studios, RDC 2025).
8. **Rewarded video pays a fixed developer product.** It is user-initiated, disclosed, never Robux,
never random, never a progress gate (Creator Docs). Reward obsolete paid items so ads do not
cannibalize spenders (RDC 2025).
## Establish first
- Published or not: analytics, configs, ads and product lookups need a published experience.
Unpublished, test with synthetic receipts and record what Studio does.
- Product inventory: names, kinds (currency, bundle, pass, subscription), what each grants, and
whether ids exist. Only the owner creates ids in Creator Hub
([gui-paths.md](references/gui-paths.md)).
- Data layer: which profile store, and its `getProfile` and `isPresent` functions for
scenario-roblox-data `Receipts`.
- Audience: age range, regions with paid random restrictions, mobile share, DAU (experiments under
about 1,000 DAU rarely reach significance).
- Ads: owner age-verified 13+ with 2FA and a public game, or no rewarded video.
- Defaults when unanswered: one catalog module, `BindReceiptHandler` through `Purchases`, prices via
`PriceText`, a currency pack plus a starter bundle, no paid random items, telemetry and live
config on from day one.
## Procedure
Full code and test results are in [procedures.md](references/procedures.md). Server modules
(`Catalog`, `Purchases`, `Entitlements`, `Telemetry`) go in `ServerScriptService.MonKit` beside the
data layer's `Receipts`; shared modules (`Odds`, `PriceText`, `LiveConfig`, `ShopRank`) in
`ReplicatedStorage.MonKit`. Status: 16 of 16 live tests pass in Studio 0.743 on an unpublished place
(2026-10-19); 61 suite tests pass in Lune and unchanged in Studio. Needs a published game, not yet
run: a real `RankProductsAsync` ranking (unpublished: HTTP 400, catalog order kept) and
`no-description` on your own items.
1. **Audit.** Goal: every purchase path, price literal and client-side analytics or config call
found. How: `rbx_monetization.audit_place(place)` offline (Lune), then `MonAudit.run(game)`
through `rbx_monetization.run` in Edit. GATE: zero errors, and the live tally equals the offline
tally.
2. **Catalog.** Goal: products, passes and subscriptions in one server table, grants as data, no
prices. How: `Catalog.new(def)`, `catalog:validate()`; in a published test server,
`catalog:verify(fetch, game.CreatorId)`. GATE: no `duplicate-id`, `bad-grant`, `unknown-id` or
`foreign-id` finding. A wrong pass id is not an error: live, pass id 1 resolved to another
creator's pass.
3. **Receipts.** Goal: exactly one grant per `PurchaseId`. How:
`Receipts.new{getProfile, isPresent, handlers = catalog:handlers()}` from scenario-roblox-data,
then `Purchases.new{receipts, catalog, telemetry}` and `purchases:bind(MarketplaceService)`. Test
with synthetic receipt tables, never a real prompt. GATE: a duplicate grants once, an absent
player and a failed save answer `NotProcessedYet`, and the retry grants once.
4. **Perks.** Goal: passes, subscriptions and Plus as server-checked perks. How:
`Entitlements.new{passes, subscriptions, owns, subStatus, onChanged}`,
`ent:connect(MarketplaceService, Players)`; `Entitlements.giveTool` writes Backpack and
StarterGear. GATE: a check that errors keeps the paid state; the tool survives respawn; the
client shows "Owned" from the `perk_` attribute.
5. **Prices.** Goal: every displayed price is the player's price. How: `PriceText.fetch` and
`PriceText.view` in a LocalScript when the shop opens. GATE: no `price-literal` finding; rows
show "..." and stay unbuyable until the price loads.
6. **Paid random items.** Goal: disclosed odds, a path for restricted players. How: one
`Odds.fromWeights` module required by the server roll and the client panel; `Odds.display` behind
a "Details" button with the disclaimer; restricted players get `Odds.directPrice` or no offer.
GATE: displayed odds sum to 100% or carry the disclaimer; a restricted player cannot reach the
prompt.
7. **Rewarded video.** Goal: a disclosed, optional ad that pays a fixed product. How: client
`GetAdAvailabilityNowAsync` when the menu opens; server `CreateAdRewardFromDevProductId` then
`ShowRewardedVideoAdAsync` in `pcall`; the reward arrives as a receipt with channel `AdReward`.
GATE: the ad row hides when unavailable; the reward path is the receipt path.
8. **Analytics.** Goal: onboarding, shop funnel and economy events that survive exploiters and the
limits. How: `Telemetry` on the server only; clients send step numbers, the server accepts
forward steps only; log economy events after the save. GATE: invalid steps dropped and counted;
event names, currencies and fields within the limits table.
9. **Live config and experiments.** Goal: values change without a release. How:
`LiveConfig.new{defaults}` with `UpdateAvailable` and `Refresh`, mirrored to `cfg_` player
attributes plus a `cfgReady` marker; `forPlayer` for experiment keys. GATE: defaults apply when
ConfigService fails (live: it fails after about 30 s unpublished); the client reads values only
after `cfgReady`.
10. **Store art.** Goal: thumbnails, icon and item icons that pass the size rules and show the real
game. How: capture a staged playtest view, `thumb_from_capture`, then Scenario art (see
Handoffs); `check_art(path, kind)`. GATE: zero errors from `check_art`; a contact sheet
reviewed; the owner uploads.
11. **Launch and live ops.** Goal: a plan with metrics that decide each step. How:
`rbx_monetization.mde(enrolled, baseline)` for each test, rollout at 10, 50 then 100%, ads
campaigns run 1 to 2 weeks without targeting for a baseline. GATE: each experiment has a primary
metric, guardrails, an MDE under the expected effect and a stop date. Launch checklist and
content pacing: [launch-liveops.md](references/launch-liveops.md).
## Numbers
| Value | Relative to | Source |
| -------------------------------------------- | ------------------------------------------------------------- | ------------------------------------ |
| 25 to 99 Robux | Starter bundle price | RDC 2025 |
| 100 PurchaseIds | Receipt log kept in the profile | scenario-roblox-data default [added] |
| 60,000 transactions in 30 days | Price optimization eligibility; about 3 weeks at a 98/2 split | Docs |
| 4 places below the first non-zero digit | Odds rounding, with the disclaimer | Docs |
| 120 + 20 x CCU per minute | Analytics requests per server | Docs |
| 3 fields, 10 currencies, 20 types, 100 SKUs | Analytics cardinality before "Other" | Docs |
| 10 funnels, 100 steps, 100 event names | Analytics per experience | Docs |
| 14 to 60 days, up to 2 variants | Experiment length and arms | Docs |
| -10% playtime, -20% ARPU or payer conversion | Early harm stop, first 24 h, 10,000+ enrolled | Docs |
| About 1,000 DAU | Below this, a useful MDE is hard to reach | Docs |
| 10%, 50%, 100% | Rollout steps for risky features | RDC 2025 studios |
| Up to 4% of daily earnings | Ads reinvestment; ROAS read over 30 days | RDC 2026 |
| 1920x1080, 16:9, under 3 MB | Thumbnail; bottom strip covered by the player count | Docs |
| 512x512, legible at 150x150 | Experience icon | Docs |
| 512x512 max, circle crop | Pass and product icons | Docs |
| 5 Robux per Active Spender per day | Creator Rewards, first three games of the day, 10+ minutes | Docs |
## Quality gates
Measurable:
- Audit: zero errors offline and live; warnings fixed or justified.
- Suites: `catalog`, `receipts`, `entitlements`, `pricetext`, `odds`, `telemetry`, `liveconfig` and
`monaudit` pass in Lune and, unchanged, in Studio with the same count.
- Receipts in a playtest: a duplicate `PurchaseId` grants once; a failed save answers
`NotProcessedYet` and the retry grants once.
- Console: server analytics lines read "AnalyticsService: <Method> event fired."; no "can only be
executed on the game server" line.
- Telemetry trace: funnel steps forward only; economy events only after a saved grant.
Visual:
- A client capture of the shop with prices, the odds panel and the restricted view, checked with
`rbx_review.image_checks`.
- Store art on a contact sheet at 1,600 px or less, opened and read.
Score the result with [critique.md](references/critique.md) before calling it done.
## Common mistakes
| Mistake | Symptom | Fix |
| ----------------------------------------- | ---------------------------------------------------- | --------------------------------------------------- |
| Grant, then save, then `PurchaseGranted` | Paid but nothing after a crash | Save first; grant only on `LastSavedData` |
| Grant on `PromptProductPurchaseFinished` | Free items through a fired remote | Grants only in the receipt handler |
| `pcall(handler)` success taken as a grant | Granted while the handler returned nil | Return true only after the save; nil is not granted |
| Two scripts set `ProcessReceipt` | One product never grants | One `Purchases:bind` per server |
| Prices typed in UI code | Plus and regional prices wrong; optimization blocked | `PriceText` from `GetProductInfoAsync` |
| Odds in two tables | Disclosed odds differ from rolls | One odds module for both |
| Paid egg prompted from the client | Restricted players can still buy | Server prompt after the policy check |
| Analytics or ConfigService on the client | Silent no-ops; "only available in the game server" | Server calls; client reads attributes |
| Client-sent funnel steps trusted | Funnel inflated by exploiters | Forward-only, validated on the server |
| Experiment read at join for everyone | Enrollment diluted by players who never see it | `forPlayer` where the feature appears |
| Stopping a test on an early peek | Winner that does not hold | Fixed duration from the MDE |
| Thumbnail text or giveaway claims | Rejected video or discovery penalty | Real gameplay, plain titles |
## Handoffs
- With scenario-roblox-data: delivers product ids and grant amounts; receives the `Receipts` handler
table, which owns persistence (`PurchaseIds` log, `LastSavedData` confirmation). This skill owns
the receipt contract and the catalog.
- From scenario-roblox-networking: the `purchase-signal` finding and validated remotes for shop
steps and egg requests.
- To scenario-roblox-ui: price and odds text, `perk_` and `cfg_` attributes, the "Details" panel
contents; layout and scaling stay with UI.
- To scenario-roblox-performance and scenario-roblox-tooling: telemetry send rates; CI for the
offline audit and suites.
- Scenario art: thumbnails start from a staged gameplay capture, reframed to 16:9 at 1920x1080 with
scenario-formats or edited with scenario-image; experience icons (512x512 square) and pass or
product icons (transparent PNG, subject inside the circle) come from scenario-game-assets;
scenario-quality-gate scores them. Files land in the project, `check_art` runs, and only the owner
uploads. Keep text, prices and "free" claims out of all art; moderation applies to every upload.
## Current Roblox notes
- `BindReceiptHandler` (with `Enum.ReceiptDecision` and optional filters) is the current receipt
API; `ProcessReceipt` still works.
- Cross-game product and pass sales ended on 2026-05-30; Robux transfers use their own receipt
types.
- Roblox Plus replaced Premium for new subscribers: `HasRobloxSubscription`,
`PromptRobloxSubscriptionPurchase`.
- Creator Rewards replaced Engagement-Based Payouts on 2025-07-24.
- Yielding calls carry `Async`: `GetProductInfoAsync`, `UserOwnsGamePassAsync`. Use
`Enum.InfoType.GamePass`: the price-optimization page says `GamePasses`, which does not exist.
- Play-through rate and first-play bounce replaced QPTR; the thumbnails page still says "qualified
play through rate".
- Open Cloud has Configs, Experimentation, Analytics Query and Ads APIs, all on owner-issued keys.
- Free trials for passes were announced at RDC 2026 for October 2026 and are not in the docs yet:
verify before using.
## References
- [references/expert-notes.md](references/expert-notes.md): principles by source, with timestamps
and live findings.
- [references/procedures.md](references/procedures.md): full code for stages P1 to P11, each with
its tests and live result.
- [references/critique.md](references/critique.md): blocking and quality rubric with how to measure
each item.
- [references/launch-liveops.md](references/launch-liveops.md): item metadata, rewarded video
eligibility, shop order, content pacing and power creep, paid-item trading.
- [references/gui-paths.md](references/gui-paths.md): Creator Hub and Studio paths for what agents
cannot do, plus Open Cloud routes.
- [references/sources.md](references/sources.md): every doc and video, with credentials and
timestamps.
- [scripts/rbx_monetization.py](scripts/rbx_monetization.py): audit, kit loader, Studio probe, art
checks, thumbnail crop, MDE.
- [scripts/agentkit/monetization/](scripts/agentkit/monetization/): `Catalog`, `Purchases`,
`Entitlements`, `PriceText`, `ShopRank`, `Odds`, `Telemetry`, `LiveConfig`, `MonAudit`,
`lune_mon_audit.luau`.
© scenario-labs · MIT · scenario-labs/skills