💾 How to save to DataStore

Most developers will want to connect their Quest System to a data store in order to save/load their data.

Here you can find some examples on how to do it

🔍 Native DataStore

-- main.lua
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")

local RoQuest = require(ReplicatedStorage.RoQuest).Server

local questsStore = DataStoreService:GetDataStore("PlayerQuests")

RoQuest:Init(RoQuest:LoadDirectory(ReplicatedStorage.Quests))

local function playerAdded(player: Player)
	local success, playerData = pcall(function()
		return questsStore:GetAsync("player_"..player.UserId)
	end)
	

	if playerData then -- Set the data on RoQuest
		RoQuest:SetPlayerData(player, playerData)
	end
end

local function playerRemoved(player: Player)
	local success, errorMessage = pcall(function()
		questsStore:SetAsync("player_"..player.UserId, RoQuest:GetPlayerData(player))
	end)
	
	if not success then
		print(errorMessage)
	end
end

RoQuest.OnStart():andThen(function()
	Players.PlayerAdded:Connect(playerAdded)
	
	for _, player: Player in Players:GetPlayers() do
		playerAdded(player)
	end
	
	Players.PlayerRemoving:Connect(playerRemoved)
end)

🔍 ProfileService

    local ProfileStore = ProfileService.GetProfileStore("RandomKey", {})
    local profile = ProfileStore:LoadProfileAsync("USER_"..userId)

    if not profile.Data then
        profile.Data = {}
    end

    if not playerData.Data.PlayerQuestData then -- New player, create new quest data
        playerData.Data.PlayerQuestData = PlayerQuestData {}
    end

    -- Since RoQuest stores the player data as a pointer we don't need to update anymore. Once the profile gets released it will automatically safe the player data with it
    RoQuest:SetPlayerData(player, playerData.Data.PlayerQuestData)