mcpField
R
roblox-analytics

roblox-analytics

github.com/tabooharmonyData & databases1381.9k installsUpdated 2w ago
Repository

About roblox-analytics

roblox-analytics is a reference skill for developers instrumenting Roblox player behavior, economy events, funnels, and onboarding. It covers built-in AnalyticsService reporting, event limits, and interpreting economy signals.

Key features

  1. 01Custom, economy, and funnel events
  2. 02AnalyticsService rate-limit guidance
  3. 03Committed-balance reporting rules
  4. 04Economy health signals and cohorts
  5. 05Server-side logging guidance

Use cases

  1. 01Tracking player onboarding steps
  2. 02Measuring currency sources and sinks
  3. 03Diagnosing economy health changes
  4. 04Instrumenting behavior without third-party SDKs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tabooharmony/roblox-brain --skill roblox-analytics

After installing, type/roblox-analyticsin Claude Code to confirm it loaded.

Bundled filesreferences/full.md

Details

From the project README

Roblox Analytics Reference

When to Load

Load when tracking player behavior, economy events, funnels, or onboarding traces, or building AnalyticsService instrumentation.

Quick Reference

Key rules:

  • Built-in AnalyticsService; no third-party SDK.
  • Event types: Custom (counters/values), Economy (currency flow), Funnel (step progression)
  • Rate limit: 120 + (20 × CCU) calls/minute. Batch where possible.
  • Economy events report committed changes; diagnostic events can record failed attempts.
  • Report the balance the committed mutation RETURNED; never recompute it from the leaderstats replica — re-adding double-counts.
  • Economy events track sources (earned) and sinks (spent) separately.
  • Funnel steps need not fire in order; skipped steps back-fill when a later step logs.
  • Dashboard ~24-hour delay; "View Events" validates in real time.
  • Server-side logging preferred; client-side only for UI interaction tracking.
  • Creator Rewards: no AnalyticsService grant event. Track leading indicators (session duration, onboarding, referrals); Creator Dashboard owns payouts.
  • First-session traces: bounded buffer, shared save owner, RTBF + retention. Eligibility from player history, not missing traces; attempts matter. full.md §8.

Economy health (decision layer):

  • Instrument from day one; you cannot backfill history.
  • Log source AND sink per currency with SKUs + the mutation's returned balance.
  • Health signals: sink/source ratio, inflation, whale concentration, elasticity, sink sufficiency, D1/D7 cohorts. Thresholds are heuristics.
  • Economy breaks: verify events, read narrowest broken signal, change ONE lever, re-check.

Cross-refs: roblox-growth-design (audit workflow); roblox-monetization (purchase funnel).

Need more detail? references/full.md: code examples, API tables, edge cases.

Comments

Markdown supported