Un DataStore, c’est un grand tableau stocké chez Roblox : à chaque clé (ici, l’identifiant du joueur) correspond une valeur (ses données). On lit la valeur quand le joueur arrive, on l’écrit quand il repart. Simple en principe, mais il y a des pièges : ce guide les évite tous.
1Autorise les DataStores dans Studio
Les DataStores ne marchent que dans un jeu publié. Si ce n’est pas encore fait, publie ton jeu (voir comment publier son jeu Roblox), même en privé.
Ensuite, dans Studio : Game Settings › Security, active Enable Studio Access to API Services. Sans ça, ton script fonctionnera en ligne mais renverra une erreur pendant tes tests dans Studio.
2Charger les données à l’arrivée
On utilise DataStoreService. La clé est l’UserId du joueur : un numéro qui ne change jamais, contrairement au pseudo.
local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")
local magasin = DataStoreService:GetDataStore("Joueurs_v1")
local charges = {} -- joueurs dont les données sont bien chargées
Players.PlayerAdded:Connect(function(joueur)
local stats = Instance.new("Folder")
stats.Name = "leaderstats"
stats.Parent = joueur
local points = Instance.new("IntValue")
points.Name = "Points"
points.Parent = stats
local ok, donnees = pcall(function()
return magasin:GetAsync(tostring(joueur.UserId))
end)
if ok then
points.Value = donnees and donnees.points or 0
charges[joueur] = true
else
warn("Chargement impossible pour", joueur.Name)
end
end)
Deux règles d’or dans ce bloc :
- Toujours pcall autour d’un appel au DataStore. Les serveurs de Roblox peuvent ne pas répondre ; sans pcall, ton script plante.
- Des données par défaut : un nouveau joueur n’a rien de sauvegardé,
GetAsyncrenvoienil. Leor 0lui donne un départ propre.
3Enregistrer au départ
Quand le joueur quitte le jeu (PlayerRemoving), on écrit ses données :
local function sauvegarder(joueur)
if not charges[joueur] then return end -- jamais écraser par du vide
local donnees = { points = joueur.leaderstats.Points.Value }
local ok, erreur = pcall(function()
magasin:SetAsync(tostring(joueur.UserId), donnees)
end)
if not ok then warn("Sauvegarde ratée :", erreur) end
end
Players.PlayerRemoving:Connect(function(joueur)
sauvegarder(joueur)
charges[joueur] = nil
end)
game:BindToClose(function()
for _, joueur in Players:GetPlayers() do
task.spawn(sauvegarder, joueur)
end
task.wait(2)
end)
BindToClose s’exécute quand le serveur s’éteint (mise à jour du jeu, dernier joueur parti) : il laisse le temps de sauvegarder tout le monde.
4Sauvegarder plusieurs valeurs
On enregistre une table plutôt qu’un seul nombre : ajouter une donnée plus tard ne casse rien.
local donnees = {
points = 1250,
niveau = 7,
pets = { "Chat", "Renard" },
checkpoint = 12,
}
Un DataStore accepte les nombres, les textes, les booléens et les tables qui en contiennent. Il refuse les objets du jeu (une Part, un Player) : on sauvegarde leur nom ou un identifiant, et on les recrée au chargement. Voir sauvegarder des objets.
5Aller plus loin
- UpdateAsync au lieu de SetAsync : il lit l’ancienne valeur avant d’écrire, ce qui évite d’écraser des données si deux serveurs écrivent en même temps.
- Une sauvegarde automatique toutes les quelques minutes : si le serveur plante, le joueur perd au pire quelques minutes.
- Les nouvelles tentatives : réessayer deux ou trois fois avant d’abandonner.
- Le verrouillage de session, pour les jeux avec échanges entre joueurs.
Respecte aussi les limites des DataStores : pas de sauvegarde à chaque pièce ramassée, seulement à des moments clés.
Ce guide ou la formation ?
Ce guide te donne les bases pour démarrer. Il ne remplace pas la formation complète, qui t’accompagne jusqu’à un jeu terminé.
Dans ce guide
- 5 étapes pour comprendre le principe
- Le code de base, à recopier et adapter
- Tu avances seul : si ça ne marche pas, à toi de trouver pourquoi
Dans la formation « Simulateur »
- 24 leçons en 6 modules : Le cœur du simulateur, Interface et améliorations, Œufs et pets, Zones et renaissances, Sauvegarde, classement et publication, Faire revenir les joueurs
- Chaque exercice vérifié directement dans Roblox Studio
- Bloxi t’aide quand tu bloques
- Ton jeu terminé et publié sur Roblox