Skip to content

Server scripts only. Validate all client input on your own remotes—PlayerState does not ship RemoteEvents.

Server Functions

Server-side PlayerState API for data management and persistence.

Server Only - Security

Server scripts only. No built-in RemoteEvents - create your own with validation.
Never trust client data!

Studio: ViewedUser

When using ViewedUser in PlayerStateConfig (Studio-only), setting ReadOnly to true causes all write APIs (Set, SetPath, SetValues, batch ops, Increment, Decrement, array/dict writes, WipePlayerData, etc.) to return false and warn. Reads and Replica subscriptions still work. See Configuration — ViewedUser.

Reference sections

TopicDescription
All functionsAlphabetical index of every server API symbol
InitializationInit
Basic dataSet, Get
PathsSetPath, GetPath
Change listenersOnChanged
NumericIncrement, Decrement
BatchSetValues, BatchSetValues, BatchUpdateValues, FlushBatch
ArraysArray helpers
DictionariesDict helpers
CachePath cache
Shared sessionServer-wide ephemeral state
EventsSignals
UtilitiesProfiles, Replica, offline, wipe, etc.
Leaderboard & leaderstatsRankings and HUD stats
ExamplesLarger patterns
PerformanceOptimization notes

PlayerState - High-Performance Roblox Data Management