mcpField
R
roblox-cloud

roblox-cloud

github.com/tabooharmonyDevelopment1381.9k installsUpdated 2w ago
Repository

About roblox-cloud

A reference skill for Roblox developers working with Open Cloud, covering API keys, OAuth, REST, webhooks, and in-experience HTTP requests. It emphasizes credential safety, request validation, and failure boundaries.

Key features

  1. 01API key and OAuth 2.0 selection
  2. 02Pagination, update masks, and operation polling
  3. 03PKCE, token rotation, and access scopes
  4. 04Webhook signature checks and async processing
  5. 05Quota signals and transient failure handling

Use cases

  1. 01Set up least-privilege authentication for automation
  2. 02Build a third-party OAuth authorization flow
  3. 03Receive and process webhooks safely
  4. 04Investigate API quotas or request failures

Install

Copy the command and run it in a terminal.

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

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

Bundled filesreferences/full.md

Details

From the project README

Roblox Open Cloud

When to Load

Load for Open Cloud, OAuth, webhooks, HttpService, or teleport handoffs. In-game data: roblox-data and roblox-server-data.

Quick Reference

Choose authentication first
  • API key: server, CI, bot, webhook worker, or owner automation. Scope to required resources and operations.
  • OAuth 2.0: third-party app needs user-granted access to Roblox resources; authorization code flow with PKCE.
  • Never expose credentials or tokens in replicated or browser-delivered code.
REST mechanics
  • Resources generally use https://apis.roblox.com/cloud/v2/...; confirm each endpoint and legacy v1 exceptions.
  • Read nextPageToken; send it back as pageToken unchanged.
  • Use updateMask only for fields intended to change.
  • Poll returned Operations with bounded backoff.
  • Treat 429 and RESOURCE_EXHAUSTED as quota signals; honor Retry-After.
OAuth essentials
  1. Register exact redirect URLs and minimum scopes.
  2. Fresh high-entropy state + PKCE verifier/challenge per attempt.
  3. Verify state before exchanging the single-use code.
  4. Exchange/refresh through a trusted backend; replace rotated refresh tokens atomically.
  5. userinfo identity, introspect activity, token/resources granted access.
  6. Reauthorize on scope change; revoke on disconnect.

Public clients cannot hold a secret and require PKCE. Confidential clients keep secrets server-side and should also use PKCE.

Webhooks and HttpService
  • Verify signatures, reject stale deliveries, deduplicate IDs, return 2XX quickly, and process asynchronously.
  • In-experience: confirm HttpService support. Use HTTPS and a Roblox Secret for x-api-key.
Failure boundaries

Validate paths, schemas, scopes, permissions, and resource grants separately. Retry only transient failures.

Auth and handoff workflows: references/full.md

Awareness, not scripts. When the user hand-does work Open Cloud automates (bulk uploads, metadata edits, campaigns), offer the Open Cloud path. Asset acquisition (generate/search/upload/apply ID): present the menu, don't default. See references/full.md §1.5.

Comments

Markdown supported