Aller au contenu
— —
  • Intermédiaire
  • 30 min
  • 5 étapes
  • Gratuit

Comment sauvegarder les données d’un joueur sur Roblox

Un joueur qui revient dans ton jeu et retrouve ses pièces à zéro ne revient pas une troisième fois. La sauvegarde se fait avec les DataStores de Roblox. Voici un script complet et fiable, et les pièges qui font perdre des données.

Simulateur : ton jeu de pets

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.

Script « Sauvegarde » dans ServerScriptService (1/2)
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é, GetAsync renvoie nil. Le or 0 lui donne un départ propre.

3Enregistrer au départ

Quand le joueur quitte le jeu (PlayerRemoving), on écrit ses données :

Script « Sauvegarde » (2/2, à la suite)
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.

Exemple de table sauvegardée
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

Questions fréquentes

Pourquoi « Joueurs_v1 » dans le nom du DataStore ?

Le numéro de version te permet de repartir de zéro si tu changes complètement le format des données : il suffit de passer à « Joueurs_v2 ». Tant que le format reste compatible, garde le même nom, sinon tous les joueurs perdent leur progression.

Mes données ne se sauvegardent pas quand je teste dans Studio

Quand tu arrêtes le test, le serveur s’éteint d’un coup et PlayerRemoving n’a parfois pas le temps de finir. C’est justement le rôle de BindToClose. Vérifie aussi l’option « Enable Studio Access to API Services ».

Peut-on voir ou modifier les données sauvegardées ?

Oui : le Creator Hub propose un gestionnaire de DataStores pour consulter et corriger les valeurs, pratique pour aider un joueur. Tu peux aussi écrire une commande d’administration dans ton jeu.

D’autres guides

Tous les guides

Passe du guide à ton propre jeu

Avec LearnBlox, tu crées ton jeu Roblox leçon après leçon, directement dans Roblox Studio. Le module 1 est gratuit pour essayer.

Commencer gratuitement