Με λίγα λόγια
Χρησιμοποιήστε το DataStoreService από ένα server Script: φορτώνετε τα δεδομένα του παίκτη με GetAsync όταν μπαίνει, τα κρατάτε σε ένα table όσο παίζει και τα αποθηκεύετε με UpdateAsync με χρονόμετρο, όταν φεύγει (PlayerRemoving) και όταν κλείνει ο server (game:BindToClose). Τυλίξτε κάθε κλήση σε pcall και επαναλάβετε μερικές φορές όσες αποτύχουν.
- Για να δοκιμάζετε στο Studio, δημοσιεύστε το place και ενεργοποιήστε το File > Experience Settings > Security > Enable Studio Access to API Services σε ξεχωριστό δοκιμαστικό παιχνίδι: το Studio χρησιμοποιεί τα ίδια δεδομένα με τους ζωντανούς servers.
- Αν τα δεδομένα ενός παίκτη δεν φόρτωσαν, μην αποθηκεύετε ποτέ αυτόν τον παίκτη. Η αποθήκευση των προεπιλεγμένων τιμών θα σβήσει την πραγματική του πρόοδο.
- Κρατήστε ένα table ανά παίκτη κάτω από ένα key, για παράδειγμα
User_12345, και αποθηκεύετε με χρονόμετρο, όχι σε κάθε αλλαγή. - Για ανταλλαγές αντικειμένων ή αντικείμενα επί πληρωμή προσθέστε session locking, ώστε δύο servers να μην μπορούν να αποθηκεύουν τον ίδιο παίκτη.
Σε αυτή τη σελίδα
- Πρόσβαση Studio
- Πώς δουλεύει το DataStore
- GetAsync και UpdateAsync
- 1. Module PlayerData
- Πώς είναι φτιαγμένο το module
- 2. Δουλειά με τα δεδομένα
- 3. Προειδοποίηση
- 4. Δοκιμή στο Studio
- Γιατί χάνονται τα δεδομένα
- Session locking
- Όρια
- Εκδόσεις και αντίγραφα
- Common errors
- With RoCode
- Συχνές ερωτήσεις
- Πηγές και περαιτέρω ανάγνωση
Πριν ξεκινήσετε: ενεργοποιήστε την πρόσβαση του Studio σε δοκιμαστικό αντίγραφο
Ένα παιχνίδι που τρέχει στο Studio δεν μπορεί να χρησιμοποιήσει data stores μέχρι να το επιτρέψετε. Η άδεια έχει μια παγίδα, για την οποία προειδοποιεί η τεκμηρίωση της Roblox: τότε το Studio διαβάζει και γράφει τα ίδια data stores με το ζωντανό παιχνίδι, οπότε μια δοκιμή που μηδενίζει τα coins σας στο Studio τα μηδενίζει και στο ζωντανό παιχνίδι, και ένα λάθος σε δοκιμαστικό κώδικα μπορεί να χαλάσει τα keys πραγματικών παικτών.
- Φτιάξτε ένα δοκιμαστικό αντίγραφο. Αποθηκεύστε το place σε αρχείο, ανοίξτε το αντίγραφο, επιλέξτε File > Publish to Roblox As και πατήστε Create new game. Μην το προσθέσετε ως place μέσα στο ζωντανό παιχνίδι: όλα τα places ενός παιχνιδιού μοιράζονται τα ίδια data stores.
- Στο δοκιμαστικό αντίγραφο ανοίξτε το File > Experience Settings και πηγαίνετε στο Security.
- Ενεργοποιήστε το Enable Studio Access to API Services και πατήστε Save.
Οι κλήσεις σε data stores δουλεύουν μόνο σε server Script· ένα LocalScript που θα προσπαθήσει παίρνει σφάλμα, οπότε οι clients δεν μπορούν να γράφουν αποθηκευμένα δεδομένα. Όταν ένα κουμπί πρέπει να τα αλλάξει, ο client ζητά από τον server μέσω RemoteEvent και αποφασίζει ο server (δείτε τον οδηγό για τα RemoteEvents, στα αγγλικά).
Πώς τα data stores κρατούν τα δεδομένα των παικτών
Ένα data store είναι ένα σύνολο από keys και τιμές με όνομα στους servers της Roblox, κοινό για όλους τους servers και όλα τα places του παιχνιδιού σας. Το DataStoreService:GetDataStore("PlayerData") επιστρέφει ένα τέτοιο data store.
Οι συστάσεις της Roblox συνοψίζονται στον κανόνα ένα data store για τα δεδομένα παικτών, ένα key ανά παίκτη, ένα table σε κάθε key. Φτιάχνετε το key από το UserId του παίκτη, για παράδειγμα User_12345, και ποτέ από το όνομα, που μπορεί να το αλλάξει. Ένα σταθερό μοτίβο User_{UserId} επιτρέπει επίσης στην αυτόματη επεξεργασία της Roblox για το δικαίωμα στη λήθη να βρει τα δεδομένα του παίκτη, αν τη ρυθμίσετε.
| Τύπος | Αποθηκεύεται; | Σημειώσεις |
|---|---|---|
| Αριθμοί, strings, booleans, buffers | Ναι | Τα strings πρέπει να είναι έγκυρο UTF-8. Μην αποθηκεύετε inf ή nan. |
| Tables | Ναι | Αν και όλα μέσα τους μπορούν να αποθηκευτούν. Ένα table του οποίου τα αριθμητικά keys δεν ξεκινούν από το 1 (άρα το μήκος του είναι 0) επιστρέφει με αυτά τα keys ως strings. |
Instance, Vector3, CFrame, Color3 | Όχι | Η αποθήκευση βγάζει σφάλμα ή γράφει nil. Αποθηκεύστε το όνομα του αντικειμένου ή τη θέση ως τρεις αριθμούς. |
Κάθε αίτημα είναι μια κλήση web που μπορεί να αποτύχει, παίρνει χρόνο και ξοδεύει έναν προϋπολογισμό ανά λεπτό. Γι' αυτό τα αξιόπιστα συστήματα αποθήκευσης διαβάζουν τα δεδομένα μία φορά όταν μπαίνει ο παίκτης, τα κρατούν σε ένα table στον server όσο παίζει και κατά διαστήματα τα γράφουν πίσω.
GetAsync, SetAsync ή UpdateAsync: τι να διαλέξετε
| Μέθοδος | Τι κάνει | Για τι |
|---|---|---|
GetAsync(key) | Διαβάζει την τιμή. Το αποτέλεσμα μένει σε cache σε αυτόν τον server για 4 δευτερόλεπτα. | Φόρτωση δεδομένων παίκτη |
SetAsync(key, value) | Αντικαθιστά την τιμή χωρίς να τη διαβάσει. Μία εγγραφή. | Νέο key ή τιμή που δεν εξαρτάται από την παλιά |
UpdateAsync(key, callback) | Διαβάζει την τελευταία τιμή, την περνά στη συνάρτησή σας και γράφει ό,τι επιστρέψει εκείνη. Μία ανάγνωση και μία εγγραφή. | Αποθήκευση δεδομένων παίκτη και κάθε key που μπορεί να γράφουν πολλοί servers |
IncrementAsync(key, delta) | Προσθέτει έναν ακέραιο σε έναν αποθηκευμένο ακέραιο. | Μετρητές |
RemoveAsync(key) | Διαγράφει το key και επιστρέφει την παλιά τιμή. Τις προηγούμενες εκδόσεις μπορείτε ακόμη να τις απαριθμήσετε και να τις διαβάσετε. | Διαγραφή δεδομένων παίκτη |
Το SetAsync γράφει στα τυφλά: αν δύο servers αποθηκεύουν το ίδιο key σχεδόν ταυτόχρονα, κερδίζει η τελευταία εγγραφή, ό,τι κι αν περιέχει. Το UpdateAsync διαβάζει πρώτα την τρέχουσα τιμή, και αν στο μεταξύ γράψει άλλος server, η Roblox ξανατρέχει τη συνάρτησή σας με τη νέα τιμή. Η Roblox το συνιστά πάντα όταν η εγγραφή εξαρτάται από την τρέχουσα τιμή ή όταν το key μπορεί να το γράφουν πολλοί servers, και αυτό είναι ακριβώς τα δεδομένα παίκτη. Η συνάρτηση έχει τρεις κανόνες:
- Δεν πρέπει να κάνει yield: κανένα
task.wait()και καμία άλλη κλήση data store μέσα της. - Μπορεί να εκτελεστεί περισσότερες από μία φορές, οπότε πρέπει μόνο να υπολογίζει τη νέα τιμή και ποτέ να μη δίνει αντικείμενα ή να ενεργοποιεί events.
- Η επιστροφή
nilακυρώνει την εγγραφή. Το module το χρησιμοποιεί για να μην αντικαταστήσει δεδομένα που αποθήκευσε νεότερη έκδοση του παιχνιδιού.
Βήμα 1: φτιάξτε το module PlayerData
Αυτό το ModuleScript είναι ο μόνος κώδικας που μιλά με το data store. Φορτώνει τα δεδομένα του παίκτη όταν μπαίνει, τα κρατά στη μνήμη, τα αποθηκεύει κάθε 180 δευτερόλεπτα, όταν φεύγει και όταν κλείνει ο server, και αρνείται να αποθηκεύσει όσους τα δεδομένα δεν φόρτωσαν.
- Στο Explorer περάστε τον δείκτη πάνω από το ServerScriptService, πατήστε + και βάλτε ένα ModuleScript. Μετονομάστε το σε
PlayerDataκαι αντικαταστήστε το περιεχόμενο με τον κώδικα παρακάτω. - Ένα ModuleScript εκτελείται μόνο όταν το φορτώνει (require) κάποιο script. Βάλτε στο ServerScriptService ένα Script με όνομα
Mainκαι αυτή τη γραμμή:local PlayerData = require(game:GetService("ServerScriptService").PlayerData). Τα άλλα server scripts το φορτώνουν με τον ίδιο τρόπο. - Αλλάξτε το
DEFAULTSκαι τον τύποDataγια το παιχνίδι σας, κρατώντας κάθε πεδίο αριθμό, string, boolean ή table.
ServerScriptService
PlayerData ModuleScript new
Main Script new
StarterPlayer
StarterPlayerScripts
DataWarning LocalScript new
-- PlayerData: φορτώνει τα δεδομένα του παίκτη όταν μπαίνει, τα κρατά στη μνήμη
-- και τα αποθηκεύει με χρονόμετρο, όταν φεύγει και όταν κλείνει ο server.
-- Τα άλλα server scripts τα διαβάζουν και τα αλλάζουν μέσω PlayerData.Get(player).
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local RunService = game:GetService("RunService")
local STORE_NAME = "PlayerData"
local SCHEMA_VERSION = 2 -- αυξήστε το όταν αλλάζει η μορφή των δεδομένων, και προσθέστε ένα βήμα στο migrate()
local AUTOSAVE_SECONDS = 180
-- Στο Studio μια αποτυχημένη κλήση τα παρατά αμέσως, οπότε μια δοκιμή χωρίς πρόσβαση στο data store είναι γρήγορη
local MAX_ATTEMPTS = if RunService:IsStudio() then 1 else 4
local FIRST_RETRY_SECONDS = 1 -- διπλασιάζεται μετά από κάθε αποτυχία: 1, 2, 4
export type Data = {
SchemaVersion: number,
Coins: number,
Level: number,
Inventory: { string },
}
-- Με τι ξεκινά ένας εντελώς νέος παίκτης
local DEFAULTS: { [string]: any } = {
Coins = 0,
Level = 1,
Inventory = {},
}
type Session = {
key: string,
userId: number,
data: Data,
canSave: boolean, -- false αν η φόρτωση απέτυχε: τα προεπιλεγμένα δεδομένα δεν πρέπει να αντικαταστήσουν την πραγματική πρόοδο
}
-- Καλείται μέσα σε κάθε pcall παρακάτω, οπότε ένα place που δεν έχει δημοσιευτεί ακόμη
-- (χωρίς πρόσβαση στο data store) φορτώνει πάλι τους παίκτες με τα προεπιλεγμένα δεδομένα
local function store(): DataStore
return DataStoreService:GetDataStore(STORE_NAME)
end
local sessions: { [Player]: Session } = {}
local pendingSaves: { [string]: number } = {} -- αποθηκεύσεις που τρέχουν ακόμη, ανά key
local loadedEvent = Instance.new("BindableEvent")
local PlayerData = {}
-- Ενεργοποιείται με τον παίκτη όταν τα δεδομένα του είναι έτοιμα. Το table πάρτε το μέσω PlayerData.Get(player):
-- ένα table που στέλνεται μέσω BindableEvent φτάνει ως αντίγραφο, και η αλλαγή του δεν αλλάζει τίποτα.
PlayerData.Loaded = loadedEvent.Event
local function deepCopy(value: any): any
if type(value) ~= "table" then
return value
end
local copy = {}
for key, item in value do
copy[key] = deepCopy(item)
end
return copy
end
local function defaultData(): Data
local data = deepCopy(DEFAULTS) -- φρέσκο αντίγραφο, ώστε οι παίκτες να μη μοιράζονται ποτέ ένα table Inventory
data.SchemaVersion = SCHEMA_VERSION
return data
end
-- Φέρνει τα αποθηκευμένα δεδομένα στο τρέχον schema. Επιστρέφει nil αν δεν μπορούν να χρησιμοποιηθούν με ασφάλεια.
local function migrate(saved: any): Data?
if type(saved) ~= "table" then
return nil
end
local version = tonumber(saved.SchemaVersion) or 1
if version > SCHEMA_VERSION then
return nil -- αποθηκεύτηκε από νεότερη έκδοση του παιχνιδιού: εδώ ούτε φόρτωση ούτε αντικατάσταση
end
-- Ένα βήμα για κάθε αλλαγή schema, από τα παλιά στα νέα
if version < 2 then
-- Παράδειγμα: στην έκδοση 1 το νόμισμα λεγόταν Gold. Το αντιγράφουμε μόνο αν δεν υπάρχει Coins,
-- ώστε παλιά δεδομένα που έχουν ήδη Coins αλλά όχι SchemaVersion να κρατήσουν την τιμή τους.
if saved.Coins == nil then
saved.Coins = saved.Gold
end
saved.Gold = nil
end
-- Προσθέτουμε πεδία που εμφανίστηκαν μετά την τελευταία αποθήκευση του παίκτη και αντικαθιστούμε τιμές λάθος τύπου
for field, default in DEFAULTS do
if type(saved[field]) ~= type(default) then
saved[field] = deepCopy(default)
end
end
saved.SchemaVersion = SCHEMA_VERSION
return saved
end
-- Εκτελεί μια κλήση data store σε pcall. Αν αποτύχει, περιμένει και ξαναδοκιμάζει, κάθε φορά διπλασιάζοντας
-- την αναμονή και προσθέτοντας λίγη τυχαιότητα, ώστε οι servers να μην ξαναδοκιμάζουν όλοι μαζί.
local function withRetries(label: string, call: () -> any): (boolean, any)
for attempt = 1, MAX_ATTEMPTS do
local ok, result = pcall(call)
if ok then
return true, result
end
warn(`{label} failed (attempt {attempt} of {MAX_ATTEMPTS}): {result}`)
if attempt < MAX_ATTEMPTS then
local waitTime = FIRST_RETRY_SECONDS * 2 ^ (attempt - 1)
task.wait(waitTime + math.random() * waitTime / 2)
end
end
return false, nil
end
local function save(session: Session): boolean
if not session.canSave then
return false
end
local key = session.key
pendingSaves[key] = (pendingSaves[key] or 0) + 1
local newerSchema = false
local ok = withRetries(`Save {key}`, function()
return store():UpdateAsync(key, function(current: any)
if type(current) == "table" and (tonumber(current.SchemaVersion) or 1) > SCHEMA_VERSION then
newerSchema = true
return nil -- η επιστροφή nil ακυρώνει την εγγραφή
end
-- Γράφουμε όλο το τρέχον table με σήμανση το UserId του παίκτη
return session.data, { session.userId }
end)
end)
local left = (pendingSaves[key] or 1) - 1
if left > 0 then
pendingSaves[key] = left
else
pendingSaves[key] = nil
end
if newerSchema then
session.canSave = false
warn(`{key} was saved by a newer version of the game, so this server stopped saving it`)
end
return ok and not newerSchema
end
local function startAutosave(player: Player, session: Session)
task.spawn(function()
-- Ξεκινάμε σε τυχαία στιγμή του διαστήματος, ώστε οι servers να μην αποθηκεύουν όλοι μαζί
task.wait(math.random() * AUTOSAVE_SECONDS)
while sessions[player] == session do
save(session)
task.wait(AUTOSAVE_SECONDS)
end
end)
end
local function load(player: Player)
local key = "User_" .. player.UserId
-- Αν ο παίκτης μόλις έφυγε από αυτόν τον server και γύρισε, αφήνουμε πρώτα να τελειώσει η τελευταία αποθήκευση
while pendingSaves[key] do
task.wait()
end
local ok, saved = withRetries(`Load {key}`, function()
return store():GetAsync(key)
end)
if player.Parent ~= Players then
return -- έφυγε κατά τη φόρτωση: τίποτα δεν άλλαξε, δεν υπάρχει κάτι να αποθηκευτεί
end
local data: Data? = nil
if ok then
data = if saved == nil then defaultData() else migrate(saved)
end
local session: Session = {
key = key,
userId = player.UserId,
data = data or defaultData(),
canSave = data ~= nil,
}
if not session.canSave then
warn(`Could not load {key}. {player.Name} is playing on default data that will not be saved.`)
end
sessions[player] = session
player:SetAttribute("DataLoaded", session.canSave) -- το GUI μπορεί να το διαβάσει και να προειδοποιήσει τον παίκτη
startAutosave(player, session)
loadedEvent:Fire(player)
end
local function endSession(player: Player)
local session = sessions[player]
if not session then
return
end
sessions[player] = nil -- σταματά τον βρόχο autosave, και μια δεύτερη κλήση δεν κάνει τίποτα
save(session)
end
-- Το ζωντανό table δεδομένων του παίκτη ή nil μέχρι να φορτώσει. Αλλάξτε το μόνο από server scripts.
function PlayerData.Get(player: Player): Data?
local session = sessions[player]
return if session then session.data else nil
end
-- True όταν τα δεδομένα του παίκτη φόρτωσαν και θα αποθηκευτούν. Ελέγξτε το πριν από κάθε πώληση.
function PlayerData.CanSave(player: Player): boolean
local session = sessions[player]
return session ~= nil and session.canSave
end
-- Αποθηκεύει τώρα, χωρίς να περιμένει το χρονόμετρο, για σημαντικές στιγμές όπως μια αγορά.
-- Κάνει yield και επιστρέφει true όταν η αποθήκευση πέτυχε.
function PlayerData.SaveNow(player: Player): boolean
local session = sessions[player]
return session ~= nil and save(session)
end
Players.PlayerAdded:Connect(load)
Players.PlayerRemoving:Connect(endSession)
for _, player in Players:GetPlayers() do
task.spawn(load, player) -- παίκτες που μπήκαν πριν από το πρώτο require αυτού του module
end
game:BindToClose(function()
-- Ο server δίνει σε αυτές τις συναρτήσεις 30 δευτερόλεπτα, οπότε αποθηκεύουμε όλους ταυτόχρονα
for player in sessions do
task.spawn(endSession, player)
end
-- Μετά περιμένουμε όλες τις αποθηκεύσεις που τρέχουν ακόμη, και όσες ξεκίνησαν στο PlayerRemoving
while next(pendingSaves) do
task.wait()
end
end)
return PlayerData
Όταν το παιχνίδι έχει βγει, μην αλλάζετε το STORE_NAME και το μοτίβο key User_. Η αλλαγή οποιουδήποτε από τα δύο θα στείλει το module σε κενά keys, και κάθε παίκτης θα ξεκινήσει από την αρχή με τις προεπιλεγμένες τιμές.
Πώς το module προστατεύει τα δεδομένα
Προεπιλεγμένες τιμές και έκδοση schema
Ένας νέος παίκτης παίρνει ένα φρέσκο αντίγραφο του DEFAULTS. Πρέπει να είναι ακριβώς αντίγραφο: αν όλοι οι παίκτες μοιράζονταν ένα table Inventory, ένα αντικείμενο που προστέθηκε σε έναν θα εμφανιζόταν σε όλους.
Κάθε αποθηκευμένο table φέρει ένα SchemaVersion. Η προσθήκη πεδίου δεν χρειάζεται νέα έκδοση, επειδή το migrate συμπληρώνει τα πεδία που λείπουν από τις προεπιλεγμένες τιμές. Η μετονομασία ή η αναδιάρθρωση χρειάζεται: αυξήστε το SCHEMA_VERSION και προσθέστε ένα βήμα, όπως στο παράδειγμα που μετονομάζει το Gold σε Coins (σε νέο παιχνίδι διαγράψτε το και ξεκινήστε από το 1). Δεδομένα με έκδοση μεγαλύτερη από του server ήρθαν από νεότερη έκδοση που ακόμη απλώνεται, οπότε οι παλιοί servers δεν τα αγγίζουν.
Μια αποτυχημένη φόρτωση δεν αποθηκεύεται ποτέ
Αυτός ο κανόνας προστατεύει από ολικό σβήσιμο. Αν όλες οι προσπάθειες φόρτωσης απέτυχαν, ο παίκτης παίζει με τα προεπιλεγμένα δεδομένα, αλλά το canSave είναι false, οπότε αυτές οι τιμές δεν θα αντικαταστήσουν ποτέ την πραγματική του πρόοδο. Το module βάζει επίσης το attribute DataLoaded σε false, και το βήμα 3 το χρησιμοποιεί για να ενημερώσει τον παίκτη. Το παράδειγμα αναφοράς της Roblox χειρίζεται τις αποτυχημένες φορτώσεις με τον ίδιο τρόπο και το προτείνει αντί για kick· αν προτιμάτε kick, καλέστε player:Kick() με ένα μήνυμα εκεί όπου το module βγάζει την προειδοποίηση.
Επαναλήψεις με αυξανόμενη παύση
Το withRetries τυλίγει κάθε κλήση σε pcall. Μετά από αποτυχία περιμένει 1, μετά 2, μετά 4 δευτερόλεπτα, κάθε φορά συν τυχαία έως το μισό αυτού του χρόνου, και σταματά μετά από τέσσερις προσπάθειες (στο Studio μετά από μία, ώστε ένα place χωρίς πρόσβαση στο data store να ξεκινά αμέσως). Η τυχαιότητα απλώνει τις επαναλήψεις πολλών servers μετά από μια βλάβη, και το όριο κρατά την αναμονή γύρω στα 10 δευτερόλεπτα, μέσα στα 30 δευτερόλεπτα που παίρνει ο server για να κλείσει. Επειδή κάθε αποθήκευση γράφει όλο το ζωντανό table μέσω UpdateAsync, μια επανάληψη που τελείωσε καθυστερημένα δεν μπορεί να επαναφέρει παλιά δεδομένα.
Πότε αποθηκεύει το module
| Πότε | Γιατί |
|---|---|
| Κάθε 180 δευτερόλεπτα όσο ο παίκτης είναι στον server | Περιορίζει τις απώλειες σε κρασάρισμα. Η πρώτη αποθήκευση πέφτει σε τυχαία στιγμή του διαστήματος, ώστε οι servers να μην αποθηκεύουν όλοι μαζί. Το παράδειγμα αναφοράς της Roblox χρησιμοποιεί επίσης 180 δευτερόλεπτα. |
Όταν ο παίκτης φεύγει (PlayerRemoving) | Η συνηθισμένη τελική αποθήκευση. Η συνεδρία διαγράφεται πρώτα, οπότε το autosave σταματά. |
Όταν κλείνει ο server (game:BindToClose) | Όλοι όσοι είναι ακόμη στον server αποθηκεύονται μαζί, και η συνάρτηση περιμένει κάθε αποθήκευση που τρέχει. Η Roblox της δίνει 30 δευτερόλεπτα. |
Κατ' απαίτηση, μέσω PlayerData.SaveNow(player) | Μετά από κάτι που δεν πρέπει να χαθεί, για παράδειγμα μια αγορά. |
Αν ο παίκτης ξαναμπεί στον ίδιο server ενώ η τελική του αποθήκευση τρέχει ακόμη, η νέα φόρτωση περιμένει να τελειώσει αυτή η αποθήκευση, οπότε δεν μπορεί να διαβάσει την παλιά τιμή.
Βήμα 2: διαβάστε και αλλάξτε τα δεδομένα από άλλα scripts
Όλα τα server scripts που φορτώνουν το module δουλεύουν με τα ίδια tables:
| Κλήση | Τι κάνει |
|---|---|
PlayerData.Get(player) | Το ζωντανό table δεδομένων του παίκτη ή nil μέχρι να φορτώσει. Αλλάξτε τα πεδία απευθείας, για παράδειγμα data.Coins += 10, και η επόμενη αποθήκευση θα το πάρει. |
PlayerData.Loaded | Ενεργοποιείται με τον παίκτη όταν τα δεδομένα του είναι έτοιμα, και μετά από αποτυχημένη φόρτωση. Περνά μόνο τον παίκτη, επειδή ένα table που στέλνεται μέσω BindableEvent φτάνει ως αντίγραφο. |
PlayerData.CanSave(player) | false αν η φόρτωση απέτυχε. Ελέγξτε το πριν από κάθε πώληση: μια αγορά που δεν μπορεί να αποθηκευτεί θα χαθεί όταν φύγει ο παίκτης. |
PlayerData.SaveNow(player) | Αποθηκεύει αμέσως και επιστρέφει true αν πέτυχε. Κάνει yield. |
Το module είναι το μόνο σημείο όπου ζουν τα αποθηκευμένα δεδομένα, και τα leaderstats είναι μόνο προβολή: φτιάξτε τα όπως στον οδηγό για το leaderboard, γεμίστε τα από το PlayerData.Get(player) στον handler του Loaded και ενημερώνετε και τα δύο όταν αλλάζει μια τιμή. Μη διαβάζετε ποτέ αποθηκευμένες τιμές πίσω από τα leaderstats και μην αφήνετε ποτέ ένα δεύτερο script να αποθηκεύει το ίδιο key.
Ένα script που φόρτωσε το module αφού μπήκαν οι παίκτες χάνει το Loaded γι' αυτούς. Συνδέστε τον handler και μετά περάστε επίσης σε βρόχο από το Players:GetPlayers() και χειριστείτε όλους για τους οποίους το PlayerData.Get(player) επιστρέφει ήδη table.
Αντικαθιστάτε ένα παλιό script αποθήκευσης, για παράδειγμα από τον οδηγό για το leaderboard; Οι τιμές του μένουν στο δικό του data store και key, οπότε αυτό το module θα ξεκινήσει όλους με τις προεπιλεγμένες τιμές. Πριν την κυκλοφορία είτε στρέψτε το STORE_NAME και το πρόθεμα User_ στα παλιά (το migrate θεωρεί δεδομένα χωρίς SchemaVersion έκδοση 1 και συμπληρώνει τα πεδία που λείπουν), είτε μεταφέρετε τις παλιές τιμές και μετά διαγράψτε το παλιό script.
Οι clients δεν αλλάζουν ποτέ αυτά τα δεδομένα απευθείας. Ένα κουμπί μαγαζιού ενεργοποιεί ένα RemoteEvent· ο server ελέγχει το CanSave, συγκρίνει την τιμή με τα Coins του παίκτη, αλλάζει το table και καλεί SaveNow. Ο οδηγός για GUI μαγαζιού στήνει μια τέτοια αγορά στην πλευρά του server.
Έτοιμο παράδειγμα προσθήκης πεδίων υπάρχει στον οδηγό για clicker simulator: προσθέτει PowerLevel και Rebirths στο DEFAULTS και στον τύπο Data και μετά τα αλλάζει στο table που επιστρέφει το PlayerData.Get. Το migrate δίνει τα νέα πεδία στους παίκτες με παλιές αποθηκεύσεις.
Βήμα 3: ενημερώστε τον παίκτη ότι τα δεδομένα του δεν φόρτωσαν
Ένας παίκτης του οποίου τα δεδομένα δεν φόρτωσαν πρέπει να ξέρει ότι αυτή η συνεδρία δεν θα αποθηκευτεί, ώστε να ξαναμπεί αντί να παίζει χωρίς λόγο. Αυτό το LocalScript παρακολουθεί το attribute DataLoaded και δείχνει ένα banner όταν είναι false.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local shown = false
local function showWarning()
if shown or player:GetAttribute("DataLoaded") ~= false then
return
end
shown = true
local gui = Instance.new("ScreenGui")
gui.Name = "DataWarning"
gui.ResetOnSpawn = false
local label = Instance.new("TextLabel")
label.AnchorPoint = Vector2.new(0.5, 0)
label.Position = UDim2.new(0.5, 0, 0, 12)
label.Size = UDim2.new(0.8, 0, 0, 48)
label.BackgroundColor3 = Color3.fromRGB(110, 28, 28)
label.TextColor3 = Color3.new(1, 1, 1)
label.TextScaled = true
label.Text = "Your saved progress could not be loaded. Nothing you do in this server will be saved, so rejoin later."
label.Parent = gui
gui.Parent = player:WaitForChild("PlayerGui")
end
-- Ο server βάζει το DataLoaded μία φορά, αφού προσπαθήσει να φορτώσει τα δεδομένα αυτού του παίκτη
player:GetAttributeChangedSignal("DataLoaded"):Connect(showWarning)
showWarning()
Βήμα 4: δοκιμάστε την αποθήκευση στο Studio
Κάντε το στο δοκιμαστικό αντίγραφο με ενεργή την πρόσβαση του Studio.
- Δώστε στον εαυτό σας κάτι να αποθηκευτεί. Κάτω από τη γραμμή require στο
Mainπροσθέστε:PlayerData.Loaded:Connect(function(player) local data = PlayerData.Get(player) if data then data.Coins += 100 print(player.Name, data.Coins) end end) - Πατήστε Play. Το παράθυρο Output (στο μενού Window ή στην καρτέλα Script) θα δείξει το όνομά σας και 100 (στην πρώτη εκτέλεση), χωρίς την προειδοποίηση
Could not load. - Πατήστε Stop. Το τέλος της δοκιμής κλείνει τον server, και το module σας αποθηκεύει πριν κλείσει.
- Πατήστε ξανά Play. Το Output πρέπει να δείξει 200, 100 περισσότερα από την προηγούμενη φορά. Αν δείχνει πάλι τον ίδιο αριθμό, η αποθήκευση δεν πέρασε: διαβάστε τις προειδοποιήσεις από πάνω.
- Δοκιμάστε τη διαδρομή με σφάλμα. Απενεργοποιήστε την πρόσβαση του Studio και πατήστε Play. Μετά από μερικά δευτερόλεπτα επαναλήψεων το Output θα δείξει
Could not load User_...και 100, και θα εμφανιστεί το banner από το βήμα 3. Σταματήστε τη δοκιμή, ενεργοποιήστε ξανά την πρόσβαση και πατήστε Play: το Output θα δείξει 300, τα αποθηκευμένα σας 200 συν 100, επειδή η αποτυχημένη συνεδρία δεν αντικατέστησε ποτέ τα δεδομένα σας. - Διαγράψτε τη δοκιμαστική γραμμή από το
Main.
Γιατί χάνονται τα δεδομένα των παικτών
Αυτοί είναι οι συνηθισμένοι τρόποι με τους οποίους ένα σύστημα αποθήκευσης χάνει πρόοδο. Το module καλύπτει στον κώδικα τις τέσσερις πρώτες γραμμές και τη γραμμή για το schema· οι υπόλοιπες εξαρτώνται από το τι και πώς αποθηκεύετε, και η τελευταία χρειάζεται session locking.
| Τι συμβαίνει | Αποτέλεσμα | Πώς το αποτρέπετε |
|---|---|---|
| Η φόρτωση απέτυχε, αλλά το script αποθηκεύει παρ' όλα αυτά | Οι προεπιλεγμένες τιμές σβήνουν την πραγματική πρόοδο: ολικό σβήσιμο | Ποτέ αποθήκευση παίκτη του οποίου η φόρτωση απέτυχε |
Αποθήκευση μόνο στο PlayerRemoving | Ένα κρασάρισμα ή κλείσιμο του server χάνει την αποθήκευση | Autosave συν BindToClose που περιμένει τις αποθηκεύσεις του |
Χωρίς pcall ή χωρίς επανάληψη | Ένα αποτυχημένο αίτημα σταματά το script ή χάνει την αποθήκευση | pcall με μερικές επαναλήψεις απλωμένες στον χρόνο |
| Αποθήκευση σε κάθε αλλαγή | Τα αιτήματα μπαίνουν σε ουρά· όταν η ουρά έχει 30, τα νέα απορρίπτονται | Δεδομένα στη μνήμη και αποθήκευση με χρονόμετρο |
| Αποθήκευση πραγμάτων που το data store δεν μπορεί να κρατήσει | Η αποθήκευση βγάζει σφάλμα, ή η τιμή επιστρέφει nil | Αποθήκευση αριθμών, strings, booleans και tables από αυτά |
| Αλλαγή μορφής δεδομένων χωρίς migration | Οι παλιές αποθηκεύσεις φορτώνουν σε λάθος πεδία | Έκδοση schema και βήμα migration |
| Δύο scripts αποθηκεύουν το ίδιο key | Κάθε αποθήκευση σβήνει τα πεδία του άλλου | Το key ανήκει σε ένα μόνο module |
| Δύο servers κρατούν τον ίδιο παίκτη | Ο server με τα παλιά δεδομένα αποθηκεύει τελευταίος και σβήνει τη νέα πρόοδο | Session locking |
Session locking, «lock lost» και ProfileStore
Ένας παίκτης είναι συνδεδεμένος σε έναν server τη φορά, αλλά η τελική αποθήκευση του παλιού server μπορεί να τρέχει ακόμη όταν μπαίνει στον νέο: μια αργή επανάληψη, ένα teleport ή μια γρήγορη επανείσοδος. Αν ο νέος server φορτώσει πρώτος τα δεδομένα, θα έχει τα παλιά δεδομένα, και θα κερδίσει όποιος server αποθηκεύσει τελευταίος. Η τεκμηρίωση της Roblox σημειώνει ότι σε παιχνίδια με ανταλλαγές αυτό το κενό είναι συχνή αιτία διπλασιασμού αντικειμένων.
Το session locking κλείνει αυτό το κενό. Όταν ένας server φορτώνει το key ενός παίκτη, στην ίδια κλήση UpdateAsync γράφει το ID του lock του στα μεταδεδομένα του key. Κάθε άλλος server που βρίσκει ένα lock που δεν έχει λήξει και δεν το έβαλε ο ίδιος δεν θα φορτώσει ούτε θα αποθηκεύσει αυτό το key. Ο κάτοχος ανανεώνει το lock σε κάθε autosave και το αφαιρεί στην τελική αποθήκευση· αν σταματήσει να το ανανεώνει, το lock λήγει και μπορεί να το πάρει άλλος server.
Τι σημαίνει «lock lost»
Σε ένα σύστημα με session locking, ο server έχασε το lock όταν το key του παίκτη ανήκει πια σε άλλον server, επειδή το lock έληξε ή το πήρε άλλος. Το αντίγραφό του μπορεί να είναι παλιό, οπότε πρέπει να σταματήσει να αποθηκεύει αυτόν τον παίκτη· η συνηθισμένη αντίδραση: kick με ένα μήνυμα ώστε να ξανασυνδεθεί. Αν είδατε «lock lost» ως παίκτης, είναι μήνυμα του δικού συστήματος αποθήκευσης εκείνου του παιχνιδιού, και να το εξηγήσουν μπορούν μόνο οι developers του.
Το χρειάζεστε;
Το module αυτού του οδηγού δεν κάνει session locking. Χωρίς lock, η πραγματική χειρότερη περίπτωση είναι αυτή: σε ένα σπάνιο race ο παίκτης χάνει ό,τι κέρδισε στον παλιό server μετά την τελευταία επιτυχημένη αποθήκευσή του. Προσθέστε locking όταν ο διπλασιασμός ή η απώλεια κοστίζει στους παίκτες κάτι πραγματικό: ανταλλαγές, developer products, σπάνια αντικείμενα ή συχνά teleports.
| Επιλογή | Τι είναι | Τι αξίζει να ξέρετε |
|---|---|---|
| Το module αυτού του οδηγού | Φόρτωση, cache στη μνήμη, επαναλήψεις, autosave, αποθήκευση στο κλείσιμο και εκδόσεις schema, χωρίς locking | Αρκετά σύντομο για να το διαβάσετε ολόκληρο και να το αλλάξετε |
| Το παράδειγμα της Roblox για δεδομένα παικτών και αγορές | Κώδικας αναφοράς από τη Roblox με session locking, επαναλήψεις με σειρά για κάθε key και χειρισμό αποδείξεων αγορών | Η Roblox λέει ότι δεν έχει δοκιμαστεί στον χρόνο σε δημοφιλές παιχνίδι και ότι δεν πρέπει να χρησιμοποιείται ως έχει χωρίς εκτενή δοκιμή |
| ProfileStore | Δωρεάν module της κοινότητας με ανοιχτό κώδικα, διάδοχος του ProfileService, χτισμένο γύρω από session locking και autosave | Δεν είναι από τη Roblox. Η μεταφορά ενός υπάρχοντος παιχνιδιού σε αυτό χρειάζεται migration των δεδομένων που έχουν ήδη αποθηκευτεί |
Για κάθε module τρίτων η Roblox συνιστά να ελέγξετε ποιος το έχει, αν συντηρείται και πώς θα φτάσετε στα δεδομένα σας χωρίς αυτό. Η ίδια τεκμηρίωση αποκαλεί το DataStore2 παρωχημένη βιβλιοθήκη που τα νέα παιχνίδια δεν πρέπει να χρησιμοποιούν.
Όρια των data stores
Αυτά είναι τα όρια από την τεκμηρίωση της Roblox στις 30 Σεπτεμβρίου 2026. Η Roblox τα αναθεωρεί, οπότε ελέγξτε τη σελίδα κωδικών σφαλμάτων και ορίων (στα αγγλικά) πριν βασιστείτε σε έναν ακριβή αριθμό.
| Τύπος αιτήματος | Κανονικά data stores | Ταξινομημένα data stores |
|---|---|---|
Ανάγνωση: GetAsync, ανάγνωση στο UpdateAsync | 60 + 40 × παίκτες | 60 + 40 × παίκτες |
Εγγραφή: SetAsync, IncrementAsync, εγγραφή στο UpdateAsync | 60 + 40 × παίκτες | 30 + 5 × παίκτες |
Λίστα: ListKeysAsync ή GetSortedAsync για ταξινομημένα data stores | 5 + 2 × παίκτες | 5 + 2 × παίκτες |
Διαγραφή: RemoveAsync | 60 + 40 × παίκτες | 30 + 5 × παίκτες |
Με 20 παίκτες ένας server μπορεί να κάνει 860 κανονικές εγγραφές το λεπτό· το autosave αυτού του module ξοδεύει περίπου 7 από αυτές, συν μία για κάθε παίκτη που φεύγει. Τον προϋπολογισμό τον εξαντλεί η αποθήκευση σε κάθε coin που μαζεύεται. Ένας δεύτερος προϋπολογισμός ισχύει για όλο το παιχνίδι και μοιράζεται με το Open Cloud: 300 αναγνώσεις το λεπτό συν 40 για κάθε παίκτη online και 300 εγγραφές συν 20 ανά παίκτη.
| Όριο | Τιμή |
|---|---|
| Όνομα data store, όνομα key, scope | Από 50 χαρακτήρες |
| Τιμή σε ένα key | 4 194 304 χαρακτήρες ως JSON |
| Ανάγνωση ενός key από όλους τους servers | 25 MB το λεπτό |
| Εγγραφή σε ένα key από όλους τους servers | 4 MB το λεπτό, κάθε αίτημα στρογγυλεύεται προς τα πάνω στο επόμενο KB |
| Αιτήματα σε αναμονή | 30 ανά ουρά· πέρα από αυτό τα αιτήματα αποτυγχάνουν με σφάλματα 301-306 |
| Αποθηκευτικός χώρος για όλο το παιχνίδι | 500 MB συν 1 MB για κάθε χρήστη όλων των εποχών |
Το μέγεθος των δεδομένων ενός παίκτη μετρήστε το με #HttpService:JSONEncode(data), και τον προϋπολογισμό που απομένει σε ζωντανό server δείτε τον με DataStoreService:GetRequestBudgetForRequestType(Enum.DataStoreRequestType.StandardWrite). Οι κλήσεις GetAsync που απάντησε η cache των 4 δευτερολέπτων δεν μετράνε. Η λειτουργία Run στο Studio έχει δικά της, πιθανώς χαμηλότερα όρια, οπότε για τη δοκιμή των ορίων αιτημάτων η Roblox συνιστά το Team Create.
Εκδόσεις και αντίγραφα ασφαλείας
Τα κανονικά data stores κρατούν το ιστορικό για εσάς. Η πρώτη εγγραφή σε ένα key σε κάθε ώρα UTC αποθηκεύεται ως έκδοση, και οι επόμενες εγγραφές μέσα σε εκείνη την ώρα αντικαθιστούν η μία την άλλη. Μια παλιά έκδοση λήγει 30 ημέρες αφού την αντικατέστησε νεότερη εγγραφή· η τελευταία δεν λήγει ποτέ. Τα ταξινομημένα data stores δεν κρατούν εκδόσεις.
Για να επαναφέρετε έναν παίκτη, ανοίξτε το Data Stores Manager (Creations, το παιχνίδι σας, Configure > Data Stores Manager), επιλέξτε το key του, επιλέξτε μια παλαιότερη έκδοση και πατήστε Revert· γι' αυτό χρειάζεται δικαίωμα Edit. Κάντε το όσο ο παίκτης είναι offline, αλλιώς ο server με τη συνεδρία του θα αποθηκεύσει το δικό του αντίγραφο πάνω από την επαναφορά. Από server script, τα ListVersionsAsync και GetVersionAsync βρίσκουν και διαβάζουν μια παλιά έκδοση, την οποία μετά γράφετε πίσω ως τρέχουσα τιμή.
Πριν δημοσιεύσετε μια ενημέρωση που αλλάζει τον τρόπο αποθήκευσης των δεδομένων, η Roblox συνιστά να πάρετε ένα snapshot μέσω του Open Cloud Snapshot Data Stores API (ένα την ημέρα ανά παιχνίδι). Χωρίς αυτό, μια λάθος αποθήκευση στις 3:30 UTC σβήνει ό,τι γράφτηκε σε εκείνο το key από τις 3:00, επειδή πέφτει στην ίδια ωριαία έκδοση.
Συνηθισμένα λάθη και λύσεις
Τα σφάλματα των data stores εμφανίζονται στο παράθυρο Output του Studio, και το module βγάζει μια προειδοποίηση με το κείμενο του σφάλματος της Roblox σε κάθε αποτυχημένη προσπάθεια. Ο οδηγός για σφάλματα scripts εξηγεί πώς διαβάζετε γενικά το Output.
StudioAccessToApisNotAllowed (σφάλμα 403)
«Can't write to DataStore from Studio because API access is not enabled.» Δημοσιεύστε το place και μετά ενεργοποιήστε το Enable Studio Access to API Services στο File > Experience Settings > Security, στο δοκιμαστικό αντίγραφο.
DataStore request was added to queue
Ο server στέλνει αιτήματα πιο γρήγορα απ' όσο επιτρέπει ο προϋπολογισμός, ή γράφει πολύ συχνά το ίδιο key, συνήθως επειδή αποθηκεύει σε κάθε αλλαγή ή σε βρόχο. Όταν η ουρά έχει 30 αιτήματα, τα νέα αποτυγχάνουν με σφάλματα 301-306. Κρατήστε τα δεδομένα στη μνήμη και αποθηκεύετε με χρονόμετρο.
CantStoreValue (σφάλμα 104), ή ένα πεδίο επιστρέφει nil
Στο table υπάρχει κάτι που το data store δεν μπορεί να αποθηκεύσει, για παράδειγμα Instance, Vector3 ή Color3. Αποθηκεύστε αντί γι' αυτό ένα όνομα, ένα ID ή απλούς αριθμούς και ξαναφτιάξτε το αντικείμενο στη φόρτωση.
ValueTooLarge (σφάλμα 105)
Ένα key κρατά περισσότερους από 4 194 304 χαρακτήρες JSON. Μετρήστε με #HttpService:JSONEncode(data), αφαιρέστε ό,τι μπορεί να ξαναφτιαχτεί, ή χωρίστε τα δεδομένα σε πολλά σταθερά keys.
Δεν υπάρχουν σφάλματα, αλλά τα δεδομένα δεν αποθηκεύονται
Ψάξτε την προειδοποίηση του module Could not load: μετά από αποτυχημένη φόρτωση αρνείται σκόπιμα να αποθηκεύσει. Αλλιώς η τιμή πιθανότατα άλλαζε σε LocalScript, που δεν φτάνει ποτέ στον server, ή το ίδιο key το αποθηκεύει άλλο script.
Τα δεδομένα μηδενίζονται σε κάθε επανείσοδο
Το key αλλάζει από συνεδρία σε συνεδρία (φτιαγμένο από το player.Name, ή αλλάξατε το STORE_NAME), η φόρτωση αποτυγχάνει και βλέπετε τις προεπιλεγμένες τιμές, ή κανείς δεν φορτώνει το module και δεν τρέχει καθόλου. Ελέγξτε το Output και ότι το Main φορτώνει το PlayerData.
Φτιάξτε το με το RoCode
Αν δεν θέλετε να το στήσετε με το χέρι, το RoCode μπορεί να το κάνει κατευθείαν στο place που έχετε ανοιχτό. Είναι ένας ανεξάρτητος πράκτορας AI, όχι από τη Roblox, που δουλεύει μέσω ενός plugin για το Roblox Studio: γράφει Luau που χρησιμοποιεί το DataStoreService όπως κάθε script και δημιουργεί τα scripts στο Explorer σας. Ο ίδιος δεν αγγίζει ποτέ τα data stores σας, αλλά με plugin 3.9 ή νεότερο μπορεί να πατήσει Play για ένα σύντομο playtest, όπου τα scripts σας τρέχουν όπως σε κάθε δοκιμή.
Πρόσθεσε αποθήκευση στο παιχνίδι μου: κράτα τα Coins, Level και Inventory σε ένα module PlayerData με autosave και αποθήκευση όταν κλείνει ο server, και δείχνε τα Coins στα leaderstats που έχω ήδη.
- Μπορεί να ψάξει για υπάρχοντα leaderstats και κώδικα DataStore με Search Scripts και Read Script, ώστε να επεκτείνει ό,τι έχετε και να μην προσθέσει δεύτερο script αποθήκευσης. Σε μεγάλο place αναφέρετε το script ή τον φάκελο στο μήνυμα.
- Δημιουργεί το ModuleScript και το Script που το φορτώνει με Create Script ή αλλάζει τα υπάρχοντα με Edit Script
- Τρέχει Check Script για κάθε script που γράφει: έλεγχο μεταγλώττισης μέσα στο Studio με μια σύντομη λίστα προειδοποιήσεων, όχι έλεγχο τύπων και όχι δοκιμαστική εκτέλεση
- Στέλνει τις αλλαγές σε ομάδες, και κάθε ομάδα είναι ένα σημείο αναίρεσης (undo) στο Studio
Το Studio Access to API Services στο δοκιμαστικό αντίγραφο θα πρέπει να το ενεργοποιήσετε μόνοι σας: το RoCode δεν μπορεί να αλλάξει αυτή τη ρύθμιση. Με plugin 3.9 ή νεότερο το σύντομο playtest του διαβάζει τα σφάλματα, και με plugin 3.9.11 ή νεότερο μπορεί να χειριστεί έναν χαρακτήρα δοκιμών για να ελέγξει ότι το παιχνίδι δουλεύει, αλλά ελέγχει μόνο ό,τι αποφάσισε ο ίδιος να ελέγξει, οπότε παίξτε μόνοι σας και βεβαιωθείτε ότι τα Coins, Level και Inventory αποθηκεύονται και φορτώνουν. Αν η αποθήκευση δεν πέρασε στη δοκιμή σας, το Check Output μπορεί να διαβάσει τις γραμμές Server από το playtest που τρέξατε. Την αποθήκευση συνήθως την προσθέτετε όταν ο βασικός κύκλος του παιχνιδιού δουλεύει ήδη· η δημιουργία παιχνιδιού Roblox με AI ένα σύστημα κάθε φορά δείχνει αυτή τη σειρά. Πώς συνδέεται το RoCode με το Studio.
Συχνές ερωτήσεις
Πώς ενεργοποιώ το DataStore στο Roblox Studio;
Δημοσιεύστε το place, ανοίξτε το File > Experience Settings > Security, ενεργοποιήστε το Enable Studio Access to API Services και πατήστε Save. Κάντε το σε ξεχωριστό δοκιμαστικό παιχνίδι, επειδή τότε το Studio χρησιμοποιεί τα ίδια data stores με τους ζωντανούς servers αυτού του παιχνιδιού.
Αποθηκεύει η Roblox αυτόματα τα δεδομένα του παίκτη;
Όχι. Τίποτα για τον παίκτη δεν αποθηκεύεται μετά τη συνεδρία αν δεν το αποθηκεύσει ένα server script μέσω του DataStoreService, ούτε τα leaderstats.
Τι να διαλέξω: ProfileStore ή απευθείας DataStoreService;
Και το ProfileStore είναι χτισμένο πάνω στα data stores, οπότε το ερώτημα είναι αν θέλετε το session locking να το γράψει και να το συντηρεί κάποιος άλλος για εσάς. Για ανταλλαγές, αντικείμενα επί πληρωμή ή συχνά teleports το locking αξίζει, από βιβλιοθήκη ή από το παράδειγμα αναφοράς της Roblox. Για μικρότερο παιχνίδι ένα module σαν αυτό διαβάζεται και αλλάζει πιο εύκολα.
Πώς μηδενίζω ή διαγράφω τα δεδομένα ενός παίκτη;
Στο Data Stores Manager βρείτε το key και επιλέξτε Mark for Deletion, που αναιρείται μέσα στην περίοδο αναμονής, ή καλέστε RemoveAsync για το key από server script. Κάντε το όσο ο παίκτης είναι offline, αλλιώς η επόμενη αποθήκευση του server του θα γράψει τα δεδομένα πίσω. Στο δοκιμαστικό αντίγραφο η αλλαγή του STORE_NAME ξεκινά όλους από το μηδέν· μην το κάνετε ποτέ στο ζωντανό παιχνίδι.
Πηγές και περαιτέρω ανάγνωση
- Roblox Creator Docs: Data stores (στα αγγλικά). πρόσβαση Studio, GetAsync, SetAsync, UpdateAsync, set και update
- Roblox Creator Docs: Best practices for data stores (στα αγγλικά). ένα key ανά παίκτη, δεδομένα στη μνήμη, επαναλήψεις με αυξανόμενη παύση, modules τρίτων
- Roblox Creator Docs: Data store error codes and limits (στα αγγλικά). κωδικοί σφαλμάτων, όρια αιτημάτων server και παιχνιδιού, όρια μεγέθους, διεκπεραιωτικής ικανότητας και αποθηκευτικού χώρου
- Roblox Creator Docs: Versioning, listing and caching (στα αγγλικά). ωριαίες εκδόσεις, snapshots, cache 4 δευτερολέπτων, τι μπορεί να αποθηκευτεί
- Roblox Creator Docs: Implement player data and purchasing systems (στα αγγλικά). παράδειγμα αναφοράς, session locking, αποτυχημένες φορτώσεις, autosave κάθε 180 δευτερόλεπτα
- Roblox Creator Docs: Data Stores Manager (στα αγγλικά). προβολή keys, επαναφορά εκδόσεων, διαγραφή δεδομένων
- Roblox Engine API: DataModel:BindToClose (στα αγγλικά). 30 δευτερόλεπτα για το κλείσιμο
Πώς ελέγχθηκε ο κώδικας: κάθε script σε αυτή τη σελίδα περνά αυστηρό έλεγχο τύπων Luau με τους ορισμούς του Roblox API (luau-lsp, 20 Νοεμβρίου 2026). Ο έλεγχος τύπων πιάνει λάθη σε ονόματα API και λάθος τύπους, όχι όμως λάθη στη λογική του παιχνιδιού, γι' αυτό δοκιμάστε τα πάντα στο Studio πριν τη δημοσίευση.