Games often need to store some amount of persistent data between sessions like a player's level, experience points, inventory items, gold/cash, and more.
This tutorial will show you how to create a basic data store, save sample data, and read the data back into a game session.
Enabling Studio Access
By default, games tested in Studio cannot access data stores, so you must first enable them.
Make sure your game is published (File > Publish to Roblox) to enable Studio access.
From the Home tab, open the Game Settings window.
In the Security section, turn on Enable Studio Access to API Services.
Click Save to register your changes.
Creating a Data Store
Data stores are identified by a unique name. In this example, a data store named PlayerGold will save each player's gold to persistent storage.
Data stores are managed by DataStoreService, so get the service on the first line.1local DataStoreService = game:GetService("DataStoreService")2
Call DataStoreService:GetDataStore() with the string "PlayerGold". This will access the PlayerGold data store if it already exists, or create it otherwise.1local DataStoreService = game:GetService("DataStoreService")2local goldStore = DataStoreService:GetDataStore("PlayerGold")3
Saving the Data
A data store is essentially a dictionary, like a Lua table. Each value in the data store is indexed by a unique key, for instance the player's unique UserId or simply a named string for a game promo.
Player Data Example
To save player data in the data store:
Create a variable named playerUserID for the data store key. Then, use playerGold to store a player's starting gold amount.1local DataStoreService = game:GetService("DataStoreService")2local goldStore = DataStoreService:GetDataStore("PlayerGold")34-- Data store key and value5local playerUserID = 5053060926local playerGold = 2507
To save data into the PlayerGold data store, call SetAsync within a protected call, passing the key and value variables previously created.1local DataStoreService = game:GetService("DataStoreService")2local goldStore = DataStoreService:GetDataStore("PlayerGold")34-- Data store key and value5local playerUserID = 5053060926local playerGold = 25078-- Set data store key9local setSuccess, errorMessage = pcall(function()10 goldStore:SetAsync(playerUserID, playerGold)11end)12if not setSuccess then13 warn(errorMessage)14end15
In its most basic form, pcall() accepts a function and returns two values:
- The status (boolean); this will be true if the function executed without errors, or false otherwise.
- The return value of the function or an error message.
In the sample above, the status (setSuccess) is tested on line 12 and, if SetAsync() failed for any reason, errorMessage is displayed in the Output window.
To read data from a data store, call GetAsync() with the desired key name.1local setSuccess, errorMessage = pcall(function()2 goldStore:SetAsync(playerUserID, playerGold)3end)4if not setSuccess then5 warn(errorMessage)6end78-- Read data store key9local getSuccess, currentGold = pcall(function()10 return goldStore:GetAsync(playerUserID)11end)12if getSuccess then13 print(currentGold)14end15
To test the script, click Run and notice the currentGold value printed to the Output window. Note that it may take a couple seconds, as the functions must connect to data store servers.
Now that you understand basic data store usage, test it out in a sample game.
Gather as many gold chunks as you can to set a personal record that will persist between game sessions.
You can also edit the game in Studio and explore the enhanced GoldManager script which includes data auto-saving and more.