roblox-data

gamestabooharmony

Use when implementing player data persistence with DataStore, session ownership, schemas, migrations, or save and load flows.

Install

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

SKILL.md

---name: roblox-datadescription: Use when implementing player data persistence with DataStore, session ownership, schemas, migrations, or save and load flows.last_reviewed: 2026-09-19sources: - https: //devforum.roblox.com/t/profilestore/3190543---

roblox data persistence

When to Load

Load when designing player saves, schema migrations, retries, shutdown handling, or session ownership. Use roblox-server-data for ordered leaderboards, messaging, and world data; roblox-cloud for Open 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 two servers mutating one profile at once: a session-ownership wrapper or equivalent 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 can match; hashed or 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 + concurrentUsers 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.

Need details? references/full.md has the framework-neutral persistence design.

Related skills

godot-gdscript-patternswshobson16KMaster Godot 4 GDScript patterns including signals, scenes, state machines, and optimization. Use when building Godot games, implementing game systems, or learning GDScript best practices.game-enginegithub13KExpert skill for building web-based game engines and games using HTML5, Canvas, WebGL, and JavaScript. Use when asked to create games, build game engines, implement game physics, handle collision detection, set up game loops, manage sprites, add game controls, or work with 2D/3D rendering. Covers techniques for platformers, breakout-style games, maze games, tilemaps, audio, multiplayer via WebRTC, and publishing games.unity-ecs-patternswshobson11KMaster Unity ECS (Entity Component System) with DOTS, Jobs, and Burst for high-performance game development. Use when building data-oriented games, optimizing performance, or working with large entity counts.msw-defaultplayermsw-git7.9KMSW DefaultPlayer (character) management. Use the msw-general ModelBuilder to inspect/patch DefaultPlayer.model and Player.model, add/remove components, configure movement speed / jump force / HP / camera, and per-map-mode movement components. Use for DefaultPlayer model, player components, movement speed, jump force, HP, camera, physics. Keywords: player, DefaultPlayer, speed, jump, HP, camera, gravity, revive, respawn, character.