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

roblox-data — скилл для Claude Code: сохранения игроков Roblox

Скилл для Claude Code по работе с сохранениями игроков в Roblox: DataStore, ProfileStore, сессионные блокировки, схемы и миграции. Подсказывает, как добавить поле в сейв, изменить хранение валюты или разобраться с потерей данных.

MIT 3 300 установок ★ 199 обновлён 2026-10-15

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

Что делает roblox-data

Скилл подсказывает агенту, как устроены сохранения в Roblox. Он покрывает DataStore, ProfileStore, блокировки сессий, версии схем и миграции. Загружайте его, когда добавляете поле в сейв, меняете хранение валюты или инвентаря, разбираете потерю данных либо откат.

Внутри — шпаргалка по ключевым правилам: сериализуемый шаблон с полем версии, глубокое копирование шаблонов, UpdateAsync для чтения-изменения-записи. Отдельно описаны StartSessionAsync, Profile.OnSessionEnd и EndSession, а также ProfileStore.Mock для временных записей из Studio. Есть заметки про кэш GetAsync на 4 секунды и про то, что PlayerRemoving сам по себе не спасает — нужен ещё BindToClose.

Из нюансов: для соблюдения RTBF ключи должны содержать ID пользователя как статическую подстроку вида player_<UserId>. Хешированные или случайные ключи делают удаление по шаблону {UserId} невозможным. GetAsync по умолчанию читает из локального кэша, поэтому для проверки записи передавайте UseCache = false.

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

  • найти причину потери или отката сохранений
  • добавить поле в схему сейва без поломки старых данных
  • настроить сессионные блокировки профиля
  • развести данные Studio и продакшена по разным хранилищам
  • проверить, что запись реально дошла до DataStore

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

  • Разбери мой код сохранений в ServerScriptService и найди, где можно потерять данные.
  • Добавь поле premiumUntil в схему игрока и напиши миграцию для старых сейвов.
  • Проверь, как я вызываю UpdateAsync: не упрусь ли я в троттлинг при пиковой нагрузке?

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

1Через Skills CLI (Vercel)

npx skills add TabooHarmony/roblox-brain --skill roblox-data -a claude-code

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

~/.claude/skills/roblox-data/SKILL.md

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

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

Вопросы о roblox-data

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

Выполните npx skills add TabooHarmony/roblox-brain --skill roblox-data -a claude-code. Скилл появится в ~/.claude/skills/roblox-data/SKILL.md.

Что делает roblox-data?

Скилл даёт агенту правила работы с сохранениями игроков Roblox: DataStore, ProfileStore, сессионные блокировки, схемы и миграции. Подключайте его при написании, изменении, отладке или аудите кода сейвов.

Как отличить потерю записи от чтения из кэша?

GetAsync по умолчанию отдаёт данные из 4-секундного локального кэша. Если запись «не видна» сразу после UpdateAsync, проверьте с UseCache = false — так вы обойдёте кэш.

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

SKILL.md · MIT
---
name: roblox-data
description: "Use when writing, changing, debugging, or auditing Roblox player saves: DataStore, ProfileStore, session locks, schemas, migrations."
when_to_use: "Also when data is lost, rolled back, duplicated or not saving, when adding a field to the save, changing currency or inventory storage, or reviewing save code."
last_reviewed: 2026-10-14
sources:
  - https://create.roblox.com/docs/reference/engine/classes/DataModel
  - https://create.roblox.com/docs/cloud-services/data-stores
  - https://create.roblox.com/docs/cloud-services/data-stores-vs-memory-stores
  - https://create.roblox.com/docs/cloud-services/memory-stores
  - https://create.roblox.com/docs/cloud-services/data-stores/data-stores-manager
  - https://create.roblox.com/docs/cloud-services/data-stores/right-to-be-forgotten
  - https://create.roblox.com/docs/cloud-services/data-stores/error-codes-and-limits
  - https://create.roblox.com/docs/cloud-services/data-stores/versioning-listing-and-caching
  - https://create.roblox.com/docs/reference/engine/classes/DataStoreService
  - https://raw.githubusercontent.com/MadStudioRoblox/ProfileStore/main/README.md
  - https://madstudioroblox.github.io/ProfileStore/api/
  - https://devforum.roblox.com/t/profilestore/3190543
  - original
---

# roblox data persistence

## When to Load

Load for player saves, migrations, retries, shutdowns, or session ownership. Leaderboards/messaging/world data: `roblox-server-data`; Open Cloud: `roblox-cloud`.

## Quick Reference

- Define a serializable template and a version field before storing player state. Deep-copy templates so nested defaults are not shared; migrate, then reconcile missing fields against the template. Scope store names by environment (`PlayerData_Studio`) so Studio writes stay out of production.
- Use `UpdateAsync` for read-modify-write; handle throttling and transient errors.
- Prevent concurrent profile mutation with a session-ownership protocol.
- With ProfileStore: `StartSessionAsync`, `Profile.OnSessionEnd`, `EndSession` as documented; no `Steal` for normal loads; `ProfileStore.Mock` for ephemeral Studio writes.
- Save on meaningful changes and lifecycle boundaries; `PlayerRemoving` alone is not sufficient; `BindToClose` finishes pending work.
- Store primitives/arrays/dictionaries; convert Instances/userdata/functions/cyclic tables first. Validate numbers (no NaN/inf), strings (`utf8.len`), nested tables: one bad value fails the write.
- RTBF: keep the user ID as a static substring in keys (`player_<UserId>`) so `{UserId}` deletion templates match; hashed/random keys make erasure manual.
- `GetAsync` serves a 4-second local cache (`DataStoreGetOptions.UseCache`, default `true`); verify writes with `UseCache = false`.
- Poll `DataStoreService:GetRequestBudgetForRequestType` for live headroom; quotas scale with concurrent users (experience reads: 300 + CCU x 40/min).
- New code identifies users with `player.User` (`User.Id`, `DomainType`, `DomainId`); `UserId` remains valid, but never mix the two IDs in one key scheme.
- First-session traces: `roblox-analytics` §8.

> Persistence workflows: [references/full.md](references/full.md)

© TabooHarmony · MIT · TabooHarmony/roblox-brain

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
roblox-data-stores EL4CTEO Скилл roblox-data-stores для Claude Code помогает проектировать сохранение данных игроков и облачные сервисы Roblox. Включается при настройке таблиц лидеров, очередей или устранении потери и дублирования данных. CX Codex +1 1 200установок scenario-roblox-data scenario-labs Скилл scenario-roblox-data для Claude Code помогает проектировать и проверять сохранение данных в Roblox. Подключается при работе с DataStoreService, профилями игроков, миграциями или сбоями сохранения. CX Codex +1 348установок roblox-datastores gamedev-skills Автоматизирует работу с Roblox DataStoreService, загрузку профилей и защиту от перезаписи прогресса. Применяется при потере данных игроков или дублировании предметов после телепортации. CX Codex +1 11 400установок roblox-game-development greedychipmunk Скилл roblox-game-development для разработки игр на Roblox: помогает писать скрипты на Luau, собирать игровые системы и готовить проект к релизу. CX Codex +1 2 400установок roblox-datastore-safety LihFolk Скилл roblox-datastore-safety для Claude Code проверяет сохранение данных игроков в Roblox DataStores. Он подключается к задачам о потере данных, откате сохранений и дублировании предметов. CX Codex +1 ★ 98звёзд репо roblox-system-builder LihFolk Скилл roblox-system-builder для Claude Code проектирует геймплейные системы Roblox с серверной валидацией, сохранением данных в DataStore и сетевой защитой. CX Codex +1 ★ 98звёзд репо

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

Весь набор →
roblox-luau-types Скилл roblox-luau-types для аннотаций типов Luau: дженерики, юнионы, сужение типов, строгий режим, экспорт типов из модулей. Пригодится при миграции на --!strict. CX Codex +1 3 400установок roblox-npc-ai Скилл roblox-npc-ai для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode. Добавляет агенту знание Roblox PathfindingService, машин состояний для NPC, линии видимости и серверных AI-петель. CX Codex +1 3 400установок roblox-camera Скилл roblox-camera для Claude Code и Codex: скриптинг камеры в Roblox через CFrame, рейкасты с экрана, переключение видов и катсцены. Решает проблемы с дрожанием камеры и пересечением геометрии. CX Codex +1 3 300установок roblox-publish-checklist Скилл roblox-publish-checklist прогоняет релизные гейты перед публикацией Roblox-опыта: что сломалось, что не проверено и можно ли выпускать билд. CX Codex +1 3 300установок roblox-luau-core Скилл roblox-luau-core для написания и отладки Luau: подсказывает семантику языка и ловит синтаксис, перенесённый из JavaScript или Python. CX Codex +1 3 300установок roblox-networking Скилл roblox-networking проверяет клиент-серверный код в Roblox: валидацию RemoteEvent, лимиты вызовов, NaN-значения и защиту от читов. Пригодится при настройке сетевого обмена. CX Codex +1 3 300установок roblox-tooling Скилл roblox-tooling помогает настроить или починить инструментарий для разработки в Roblox: Rojo, Wally, pesde, линтеры и пайплайны CI/CD. CX Codex +1 3 200установок roblox-analytics Скилл roblox-analytics для Claude Code и Codex по аналитике Roblox: работа с AnalyticsService, событиями, экономикой, воронками и лимитами. Помогает найти, где игроки отваливаются, и правильно инструментировать фичи. CX Codex +1 3 200установок

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

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