Roblox Datastores

Solid reference for Roblox DataStoreService that covers the full lifecycle: loading with GetAsync, saving with SetAsync vs UpdateAsync for atomic operations, and crucially, the BindToClose pattern so you don't lose data on server shutdown. It walks through retry logic, ordered datastores for leaderboards, and data migration strategies with versioned schemas. The common mistakes table is the most useful part, calling out things like rate limit traps from over-saving and why you should kick players on load failure instead of silently giving them default data. If you're building any kind of persistent player data in Roblox, this hits all the patterns you actually need.

skills.sh installs: 650
GitHub stars: 31
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add sentinelcore/roblox-skills --skill roblox-datastores --agent claude-code

Installs into .claude/skills of the current project.

Files

roblox-datastores

Reference for Roblox DataStoreService — saving, loading, and managing player data on the server.

Quick Reference

Method	Signature	Notes
`GetDataStore`	`DSS:GetDataStore(name, scope?)`	Returns a `GlobalDataStore`
`GetOrderedDataStore`	`DSS:GetOrderedDataStore(name, scope?)`	For leaderboards
`GetAsync`	`store:GetAsync(key)`	Returns value or nil
`SetAsync`	`store:SetAsync(key, value)`	No return value needed
`UpdateAsync`	`store:UpdateAsync(key, fn)`	Atomic read-modify-write
`RemoveAsync`	`store:RemoveAsync(key)`	Deletes key, returns old value
`GetSortedAsync`	`orderedStore:GetSortedAsync(asc, pageSize)`	Returns `DataStorePages`

Basic Setup

-- Server Script (ServerScriptService)
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")

local playerStore = DataStoreService:GetDataStore("PlayerData_v1")

local DEFAULT_DATA = {
    coins = 0,
    level = 1,
    xp = 0,
}