Home - bellaouzo/PlayerState GitHub Wiki

PlayerState

A modern player data management system for Roblox games featuring ProfileService integration, replica-based state replication, automatic leaderboards, and batched updates.

Quick Start

  1. Configure your data structure in DefaultData.luau
  2. Configure settings in PlayerStateConfig.luau
  3. Initialize on server with PlayerState.Init(player)
  4. Use the API on client and server

Installation

Download the .rbxm file from Releases and drag it into ReplicatedStorage.

Or use the GitHub Cloning Plugin.

API Reference

Documentation

📖 Full documentation: playerstate.netlify.app

Support