로블록스 근접 전투 아키텍처: 다중 어태치먼트 레이캐스트 히트박스, 검기 궤적 및 콤보 상태 트리

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

local MeleeController = {}
MeleeController.__index = MeleeController

local player = Players.LocalPlayer
local raycastParams = RaycastParams.new()
raycastParams.FilterType = RaycastFilterType.Exclude
raycastParams.IgnoreWater = true

export type WeaponHitbox = {
    BladePart: BasePart,
    Attachments: { Attachment },
    PreviousPositions: { Vector3 },
    IsActive: boolean,
    HitTargets: { [Model]: boolean }
}

function MeleeController.NewHitbox(bladePart: BasePart): WeaponHitbox
    local attachments: { Attachment } = {}
    for _, child in ipairs(bladePart:GetChildren()) do
        if child:IsA("Attachment") and string.find(child.Name, "DmgPoint") then
            table.insert(attachments, child)
        end
    end

    local hitbox: WeaponHitbox = {
        BladePart = bladePart,
        Attachments = attachments,
        PreviousPositions = {},
        IsActive = false,
        HitTargets = {}
    }
    return hitbox
end

function MeleeController.StartSwing(hitbox: WeaponHitbox)
    hitbox.IsActive = true
    hitbox.HitTargets = {}
    hitbox.PreviousPositions = {}
    for i, att in ipairs(hitbox.Attachments) do
        hitbox.PreviousPositions[i] = att.WorldPosition
    end
end

function MeleeController.StopSwing(hitbox: WeaponHitbox)
    hitbox.IsActive = false
    hitbox.HitTargets = {}
    hitbox.PreviousPositions = {}
end

function MeleeController.UpdateHitbox(hitbox: WeaponHitbox, characterModel: Model)
    if not hitbox.IsActive then return end

    raycastParams.FilterDescendantsInstances = { characterModel }

    for i, att in ipairs(hitbox.Attachments) do
        local currentPos = att.WorldPosition
        local prevPos = hitbox.PreviousPositions[i] or currentPos
        local displacement = currentPos - prevPos

        if displacement.Magnitude > 0.05 then
            local result = Workspace:Raycast(prevPos, displacement, raycastParams)
            if result and result.Instance then
                local hitModel = result.Instance:FindFirstAncestorOfClass("Model")
                if hitModel and not hitbox.HitTargets[hitModel] then
                    local hum = hitModel:FindFirstChildOfClass("Humanoid")
                    if hum and hum.Health > 0 then
                        hitbox.HitTargets[hitModel] = true
                        -- 서버로 검증된 타격 이벤트 전송
                        -- CombatRemote:FireServer("MeleeHit", hitModel, result.Position, result.Normal)
                    end
                end
            end
        end
        hitbox.PreviousPositions[i] = currentPos
    end
end

return MeleeController