К основному содержанию
скилл CX Codex

roblox-open-cloud · el4cteo — скилл для Claude Code: API Roblox

Скилл roblox-open-cloud для Claude Code помогает работать с Open Cloud API Roblox и HttpService. Включается при создании внешних инструментов, ботов и CI/CD для игр.

MIT 1 200 установок ★ 131 обновлён 2026-11-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a claude-code
Открыть на GitHub

Что делает roblox-open-cloud

Скилл объясняет, как подключать Open Cloud API Roblox и вызывать веб-API из игры через HttpService. Он разбирает аутентификацию по API-ключу или OAuth 2.0, работу с хранилищами данных и памяти, публикацию сообщений, обновление мест и ограничения пользователей. Также затрагивает вебхуки и настройки игровых серверов.

В примерах есть запросы к API и код Luau для отправки вебхука и блокировки игрока. Для запросов нужны API-ключ или OAuth 2.0; для вызовов из игры требуется включить Allow HTTP Requests и хранить ключ в Secrets store. Ключи нельзя помещать в клиентский код. Бюджет Data Store общий для Open Cloud и работающих серверов.

Какие задачи решает

  • читать и менять записи Data Store через Open Cloud
  • передавать сообщения между работающими серверами
  • публиковать обновлённый файл place
  • вызывать веб-API из серверного кода игры

Примеры запросов агенту

  • Покажи, как получить запись игрока из Data Store через Open Cloud.
  • Напиши серверный код Luau для отправки данных вебхуку через HttpService.
  • Как заблокировать игрока через Open Cloud API?

Как установить roblox-open-cloud

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a claude-code

2Вручную: положить файлы

~/.claude/skills/roblox-open-cloud/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/roblox-open-cloud/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о roblox-open-cloud

Как установить roblox-open-cloud в Claude Code?

Выполни npx skills add EL4CTEO/roblox-skills --skill roblox-open-cloud -a claude-code. Файл скилла находится по пути ~/.claude/skills/roblox-open-cloud/SKILL.md.

Что делает roblox-open-cloud?

Скилл помогает использовать Roblox Open Cloud API и HttpService для запросов к данным игры, сообщений между серверами, публикации place и других задач.

Что нужно для работы roblox-open-cloud?

Для Open Cloud нужны API-ключ или OAuth 2.0. Для HTTP-запросов из игры требуется включить Allow HTTP Requests; ключ можно хранить в Secrets store.

Исходный текст

SKILL.md · MIT
---
name: roblox-open-cloud
description: Open Cloud REST APIs and HttpService - API keys/OAuth, v2 patterns, data/memory stores from outside, publishMessage, place publishing, server restarts, Luau execution, bans, configs/experiments, notifications, webhooks with roblox-signature verification, rate limits, Secrets. Use when building external tools, dashboards, bots, CI/CD, admin panels, or calling web APIs from a game.
---

# Roblox Open Cloud and HttpService

Base URL: `https://apis.roblox.com`. Prefer **Open Cloud** endpoints (API key or OAuth 2.0, stable).
Legacy cookie-authenticated `*.roblox.com` web APIs can break without notice — don't build on them.

## Authentication

- **API keys** (Creator Dashboard → Open Cloud → API Keys): for your own/your group's resources and
  automation. Grant the minimum scopes per universe, set an **IP allowlist** (CIDR) and **expiration**,
  store as a secret (CI secret, vault), send as header `x-api-key: <key>`. Group-owned resources need a
  key created under the group. Introspect a key with `POST /api-keys/v1/introspect`.
- **OAuth 2.0** (authorization code + PKCE): apps acting on behalf of other users (third-party tools).
- Never ship keys in game scripts, attributes, or client code.

## Common endpoints (v2 unless noted)

| Task | Endpoint |
| --- | --- |
| Data store entries | `GET/POST /cloud/v2/universes/{u}/data-stores/{ds}/entries`, `GET/PATCH/DELETE .../entries/{id}`, `:increment`, `:listRevisions`; scopes via `/scopes/{scope}/entries` |
| Ordered data stores | `/cloud/v2/universes/{u}/ordered-data-stores/{ods}/scopes/{scope}/entries[...]` |
| Memory stores | `/cloud/v2/universes/{u}/memory-store/sorted-maps/{map}/items`, `/queues/{q}/items[:read|:discard]`, `memory-store:flush` |
| Cross-server message into live servers | `POST /cloud/v2/universes/{u}:publishMessage` `{ "topic": "...", "message": "..." }` |
| Publish a place file | `POST /universes/v1/{u}/places/{p}/versions?versionType=Published|Saved` (body: `.rbxl`) |
| Restart servers (after an update) | `POST /cloud/v2/universes/{u}:restartServers` |
| Run Luau in a cloud server | `POST /cloud/v2/universes/{u}/places/{p}[/versions/{v}]/luau-execution-session-tasks` |
| Bans | `PATCH /cloud/v2/universes/{u}/user-restrictions/{userId}?updateMask=gameJoinRestriction` (scope `universe.user-restriction:write`), `user-restrictions:listLogs` |
| Experience notifications | `POST /cloud/v2/users/{userId}/notifications` |
| Secrets store | `/cloud/v2/universes/{u}/secrets` |
| Configs / experiments | `/creator-configs-public-api/v1/configs/universes/{u}/repositories/{repo}[/draft|/publish]`, `/experimentation/...` |
| Universe/place settings | `GET/PATCH /cloud/v2/universes/{u}`, `/cloud/v2/universes/{u}/places/{p}` |
| Assets, badges, game passes, developer products, groups, users, inventory | See the Open Cloud reference by feature. |

The authoritative list with scopes and per-endpoint rate limits is the Open Cloud reference
(`create.roblox.com/docs/cloud/reference`) and its OpenAPI description — check it before writing a client.

## Patterns

- **Pagination**: pass `maxPageSize`; follow `nextPageToken` → `pageToken` until empty.
- **Long-running operations**: some calls return an operation `path`; poll `GET /cloud/v2/{path}` until `done`.
- **Filtering**: `filter` query parameter on list endpoints that support it.
- **Rate limits**: read the `x-ratelimit-*` response headers; on `429`, back off exponentially with jitter.
  Data store budgets are **shared** between Open Cloud and live game servers — throttle bulk scripts so they
  don't starve the game (see `roblox-data-stores`).
- **Errors**: JSON `{ code, message }`; retry only `429` and `5xx`.
- **Legacy web APIs** (cookie or unauthenticated IP): after Oct 19, 2026, limits on the badges, datastores,
  game-persistence, inventory, thumbnails, and users APIs drop sharply (often to 100 requests/min). Open Cloud
  limits don't change: use Open Cloud with an API key for tools and bots, and cache responses.
- **Thumbnails**: from Oct 26, 2026 an unapproved or broken thumbnail returns `200` with a completed
  operation containing an `error` object (not `503`); check `error` before reading `response.imageUri`.

```bash
# Read one player's data store entry
curl -s "https://apis.roblox.com/cloud/v2/universes/$UNIVERSE_ID/data-stores/PlayerData/entries/User_$USER_ID" \
  -H "x-api-key: $ROBLOX_API_KEY"

# Announce to all live servers (the game subscribes to the "Announcements" topic)
curl -s -X POST "https://apis.roblox.com/cloud/v2/universes/$UNIVERSE_ID:publishMessage" \
  -H "x-api-key: $ROBLOX_API_KEY" -H "Content-Type: application/json" \
  -d '{"topic":"Announcements","message":"{\"text\":\"Update in 5 minutes\"}"}'
```

## HttpService inside games

- Enable **Allow HTTP Requests** (Experience Settings → Security). Server-side only.
- Limits: 500 requests/min per server for external URLs; Open Cloud calls have a separate
  2,500/min per server budget. Always `pcall`; handle non-2xx (`response.Success`).
- Store keys in the experience **Secrets store** (Creator Hub) and read with `HttpService:GetSecret(name)`,
  which returns an opaque `Secret` usable in headers (and `AddPrefix`/`AddSuffix`), not a readable string.
- Only a **subset** of Open Cloud endpoints can be called from games (assets, bans, configs, data/memory
  stores, messaging, notifications, and more — check the in-game HTTP docs list). Calls to other
  `roblox.com` domains are blocked.

```luau
--!strict
local HttpService = game:GetService("HttpService")

local function postToWebhook(url: string, payload: { [string]: any }): boolean
	local ok, response = pcall(function()
		return HttpService:RequestAsync({
			Url = url,
			Method = "POST",
			Headers = { ["Content-Type"] = "application/json" },
			Body = HttpService:JSONEncode(payload),
		})
	end)
	if not ok then
		warn("HTTP request failed to send:", response)
		return false
	end
	if not response.Success then
		warn(`HTTP {response.StatusCode}: {response.StatusMessage}`)
	end
	return response.Success
end

local function banViaOpenCloud(universeId: number, userId: number, reason: string): boolean
	local ok, response = pcall(function()
		return HttpService:RequestAsync({
			Url = `https://apis.roblox.com/cloud/v2/universes/{universeId}/user-restrictions/{userId}?updateMask=gameJoinRestriction`,
			Method = "PATCH",
			Headers = {
				["Content-Type"] = "application/json",
				["x-api-key"] = HttpService:GetSecret("OpenCloudKey"),
			},
			Body = HttpService:JSONEncode({
				gameJoinRestriction = { active = true, displayReason = reason, privateReason = reason },
			}),
		})
	end)
	return ok and response.Success
end

return { postToWebhook = postToWebhook, banViaOpenCloud = banViaOpenCloud }
```

In-game, prefer native APIs (`Players:BanAsync`, `DataStoreService`) over calling Open Cloud for the same thing.
Never log or send player chat/PII to third parties without a legitimate purpose and compliance review.

## Webhooks (Roblox → your server)

Configure in Creator Hub → Account Settings → Webhooks (max 5; for group games only the group owner).
Triggers: subscription purchased/renewed/cancelled/refunded/resubscribed, right-to-erasure requests,
commerce order paid/refunded, **transaction refunded** (Robux refunds/chargebacks of developer products,
passes, private servers, Paid Access — revoke developer product benefits yourself).
Verification details and a Node/Python verifier: [references/webhooks.md](references/webhooks.md).

## Related skills

`roblox-data-stores` (budgets, schema), `roblox-tooling` (CI publishing), `roblox-testing` (Luau
execution tests), `roblox-analytics-liveops` (configs, experiments), `roblox-security` (bans, secrets).

© EL4CTEO · MIT · EL4CTEO/roblox-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →

Сначала — roblox-open-cloud от других авторов.

roblox-open-cloud nonlooped Справочник по REST API Roblox Open Cloud для внешней автоматизации, CI/CD и работы с Data Stores без запуска игры. CX Codex +1 497установок roblox-cloud TabooHarmony Скилл roblox-cloud направляет агента при интеграции с Roblox Open Cloud: настройка OAuth 2.0 с PKCE, API-ключей, вебхуков и доступа к DataStore из внешних сервисов. CX Codex +1 3 100установок roblox-datastores gamedev-skills Автоматизирует работу с Roblox DataStoreService, загрузку профилей и защиту от перезаписи прогресса. Применяется при потере данных игроков или дублировании предметов после телепортации. CX Codex +1 11 400установок roblox-server-data TabooHarmony Скилл roblox-server-data для работы с общими данными между серверами Roblox: лидерборды, рассылки, MemoryStore, сезоны и гильдии. CX Codex +1 3 000установок roblox-luau gamedev-skills Скилл roblox-luau для Claude Code помогает писать Luau-код для Roblox и проверять его статическими инструментами. Подключается, когда не запускается LocalScript, клиент получает nil после входа или пора заменить wait(). CX Codex +1 12 300установок roblox-game-development greedychipmunk Скилл roblox-game-development для разработки игр на Roblox: помогает писать скрипты на Luau, собирать игровые системы и готовить проект к релизу. CX Codex +1 2 400установок roblox-gui sentinelcore Скилл roblox-gui помогает верстать и анимировать интерфейсы в Roblox: от экранных меню до вывесок в 3D-мире. CX Codex +1 1 300установок

Из того же набора22

Весь набор →
roblox-game-systems Скилл roblox-game-systems для Claude Code и Codex помогает собирать игровые механики Roblox с серверной валидацией. Включается при создании экономики, раундов, инвентаря, боевой системы или чекпоинтов. CX Codex +1 1 300установок roblox-luau Скилл roblox-luau для Claude Code помогает писать и разбирать скрипты Roblox на Luau. Включается при создании, рефакторинге и объяснении скриптов, исправлении ошибок типов и обновлении старого Lua-кода. CX Codex +1 1 300установок roblox-ui Скилл roblox-ui для Claude Code и Codex формирует адаптивный интерфейс в Roblox. Включается при сборке HUD, инвентарей, магазинов или починке вёрстки под мобильные экраны и консоли. CX Codex +1 1 300установок roblox-testing Скилл roblox-testing для Claude Code помогает тестировать код Roblox и проверять игровые изменения. Подключается при добавлении тестов, настройке тестового запуска или CI. CX Codex +1 1 300установок roblox-text-chat Скилл roblox-text-chat для Claude Code и Cursor, который настраивает TextChatService, фильтрацию текста и чат в Roblox. Включается при добавлении чата, команд или табличек с текстом игроков. CX Codex +1 1 200установок roblox-monetization Скилл roblox-monetization для Claude Code помогает настраивать монетизацию в Roblox и разбирать сбои покупок. Подключается при работе с магазинами, пропусками, подписками, рекламой и платными случайными предметами. CX Codex +1 1 200установок roblox-physics Скилл roblox-physics для Claude Code управляет физикой и пространственными запросами. Подключается при настройке столкновений, лучей и транспорта. CX Codex +1 1 200установок roblox-npc-ai Скилл roblox-npc-ai для Claude Code помогает создавать ИИ врагов, питомцев и других NPC в Roblox. Используется для настройки поиска пути, преследования, атак и поведения персонажей, а также для исправления застревающих NPC. CX Codex +1 1 200установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой