로블록스 퀘스트 및 대화 아키텍처: 유한 상태 머신(FSM), 노드 기반 분기 및 DataStore 저장

--!strict
local HttpService = game:GetService("HttpService")
local Players = game:GetService("Players")

local QuestManager = {}
QuestManager.__index = QuestManager

export type QuestState = "Locked" | "Available" | "Active" | "Completable" | "Completed" | "Failed"

export type Objective = {
    Id: string,
    Type: "Kill" | "Gather" | "Interact",
    TargetId: string,
    Current: number,
    Required: number
}

export type QuestData = {
    QuestId: string,
    State: QuestState,
    Objectives: { [string]: Objective },
    StartTime: number
}

local playerQuests: { [Player]: { [string]: QuestData } } = {}
local questDefinitions = {
    ["bandit_camp_1"] = {
        RequiredLevel = 5,
        Objectives = {
            ["kill_bandits"] = { Type = "Kill", TargetId = "Bandit", Required = 5 },
            ["find_chest"] = { Type = "Interact", TargetId = "CampChest", Required = 1 }
        }
    }
}

function QuestManager.StartQuest(player: Player, questId: string): boolean
    local def = questDefinitions[questId]
    if not def then return false end

    local userQuests = playerQuests[player]
    if not userQuests then return false end

    local existing = userQuests[questId]
    if existing and existing.State ~= "Available" then return false end

    local objTable: { [string]: Objective } = {}
    for objId, objDef in pairs(def.Objectives) do
        objTable[objId] = {
            Id = objId,
            Type = objDef.Type,
            TargetId = objDef.TargetId,
            Current = 0,
            Required = objDef.Required
        }
    end

    userQuests[questId] = {
        QuestId = questId,
        State = "Active",
        Objectives = objTable,
        StartTime = os.time()
    }

    QuestManager.SyncClient(player, questId)
    return true
end

function QuestManager.RecordAction(player: Player, actionType: string, targetId: string, amount: number)
    local userQuests = playerQuests[player]
    if not userQuests then return end

    for questId, quest in pairs(userQuests) do
        if quest.State == "Active" then
            local allComplete = true
            for _, obj in pairs(quest.Objectives) do
                if obj.Type == actionType and obj.TargetId == targetId then
                    obj.Current = math.clamp(obj.Current + amount, 0, obj.Required)
                end
                if obj.Current < obj.Required then
                    allComplete = false
                end
            end

            if allComplete then
                quest.State = "Completable"
            end
            QuestManager.SyncClient(player, questId)
        end
    end
end

function QuestManager.SyncClient(player: Player, questId: string)
    -- 클라이언트로 직렬화된 퀘스트 상태 딕셔너리 전송 (RemoteEvent)
end

return QuestManager