mcpField
R
roblox-cloud

roblox-cloud

github.com/tabooharmony开发1381.9k 次安装2 周前更新
代码仓库

关于 roblox-cloud

面向 Roblox 开发者的 Open Cloud 操作参考技能，涵盖 API 密钥、OAuth、REST、Webhook 和体验内 HTTP 请求。它强调凭据保护、请求校验与故障处理边界。

主要功能

  1. 01API 密钥与 OAuth 2.0 认证选择
  2. 02分页、更新掩码与操作轮询
  3. 03PKCE、令牌轮换及权限管理
  4. 04Webhook 签名校验与异步处理
  5. 05配额信号与瞬态故障处理

适用场景

  1. 01为自动化任务配置最小权限认证
  2. 02构建第三方 OAuth 授权流程
  3. 03接收并安全处理 Webhook
  4. 04排查 API 配额或请求失败

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/roblox-cloud确认已加载。

附带文件references/full.md

详细介绍

Roblox Open Cloud

何时加载

涉及 Open Cloud、OAuth、webhook、HttpService 或传送交接时加载。游戏内数据：roblox-data 和 roblox-server-data。

快速参考

首先选择身份验证方式
  • **API key：**适用于服务器、CI、机器人、webhook 处理程序或所有者自动化。将权限范围限制为所需的资源和操作。
  • **OAuth 2.0：**第三方应用需要用户授权访问 Roblox 资源；使用带 PKCE 的授权码流程。
  • 切勿在复制到客户端或交付给浏览器的代码中公开凭据或令牌。
REST 机制
  • 资源通常使用 https://apis.roblox.com/cloud/v2/...；请确认每个端点以及旧版 v1 例外情况。
  • 读取 nextPageToken；将其原样作为 pageToken 传回。
  • 仅对要更改的字段使用 updateMask。
  • 使用有上限的退避策略轮询返回的 Operations。
  • 将 429 和 RESOURCE_EXHAUSTED 视为配额信号；遵循 Retry-After。
OAuth 要点
  1. 注册精确的重定向 URL 和最低限度的作用域。
  2. 每次尝试都使用新的高熵 state 和 PKCE 验证码／质询。
  3. 交换一次性代码前先验证 state。
  4. 通过可信后端交换／刷新令牌；以原子方式替换轮换后的刷新令牌。
  5. userinfo 用于身份信息，introspect 用于活动状态，token/resources 用于已授权的访问权限。
  6. 作用域变更时重新授权；断开连接时撤销授权。

公共客户端无法保管密钥，必须使用 PKCE。机密客户端应在服务器端保管密钥，并且也应使用 PKCE。

Webhook 和 HttpService
  • 验证签名，拒绝过期的投递，按 ID 去重，快速返回 2XX，并异步处理。
  • 在体验内使用时：确认支持 HttpService。使用 HTTPS 和 Roblox Secret 作为 x-api-key。
失败边界

分别验证路径、架构、作用域、权限和资源授权。仅重试暂时性故障。

身份验证和交接工作流：references/full.md

仅提供认知，不提供脚本。 当用户手动执行 Open Cloud 可自动完成的工作（批量上传、元数据编辑、活动）时，提供 Open Cloud 方案。获取资源（生成／搜索／上传／应用 ID）：展示选项，不要默认选择。参见 references/full.md §1.5。

评论

支持 Markdown