PlayerStateType-safe player data for Roblox

Created by bellaouzo — Powerful player data tooling that pairs ProfileStore with Replica replication.

Use a Server root and ServerOnlyRoots when data should persist but never reach any client Replica. Server-only player data · Data visibility model

Performance ​

Quick Start ​

On the server, connect PlayerState.Init to PlayerAdded. After that, use Set / Get on the server and Get / OnChanged on the client.

local PlayerState = require(ReplicatedStorage.Libraries.PlayerState.PlayerStateServer)

game.Players.PlayerAdded:Connect(function(player)
    PlayerState.Init(player)
    PlayerState.Set(player, "Coins", 1000)
end)

local PlayerState = require(ReplicatedStorage.Libraries.PlayerState.PlayerStateClient)

local coins = PlayerState.Get("Coins")

PlayerState.OnChanged("Coins", function(newValue, oldValue)
    print("Coins updated:", newValue)
end)

Getting started ​

1. Concepts — How persistence, replication, and scopes fit together
2. Installation — Add the module to your project
3. Setup — Initialize server and client and define DefaultData
4. Configuration — Tune PlayerStateConfig, performance, and leaderboards
5. API Reference — Complete function documentation
6. Examples — Common usage patterns

Looking for a specific task? Use the “I want to…” shortcuts on the Guides hub.

See What's new for migrations, Shared Session, server-only roots, session data, and other highlights.

If you have existing player data, Legacy Data Migration can import from an old DataStore during profile load (opt-in).