로블록스 커스텀 탄도학 아키텍처: 베를레 적분, 탄도 낙차, 풍향 벡터 및 서버 판정 검증

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

local Ballistics = {}
Ballistics.__index = Ballistics

export type Projectile = {
    Position: Vector3,
    Velocity: Vector3,
    Mass: number,
    DragCoefficient: number,
    MaxLifetime: number,
    Age: number,
    Owner: Player,
    Beam: Beam?,
    Attachment0: Attachment?,
    Attachment1: Attachment?
}

local activeProjectiles: { Projectile } = {}
local raycastParams = RaycastParams.new()
raycastParams.FilterType = RaycastFilterType.Exclude
raycastParams.IgnoreWater = true

local globalWind = Vector3.new(4, 0, 2) -- 초당 스터드 단위 풍향 벡터
local airDensity = 0.0012 -- 대기 항력 계수

function Ballistics.Fire(origin: Vector3, direction: Vector3, muzzleVelocity: number, mass: number, owner: Player)
    local proj: Projectile = {
        Position = origin,
        Velocity = direction.Unit * muzzleVelocity,
        Mass = mass,
        DragCoefficient = 0.3,
        MaxLifetime = 6.0,
        Age = 0,
        Owner = owner
    }
    table.insert(activeProjectiles, proj)
end

local function StepProjectile(proj: Projectile, dt: number): boolean
    proj.Age += dt
    if proj.Age >= proj.MaxLifetime then return false end

    -- 항력, 중력, 풍향 물리 연산
    local speed = proj.Velocity.Magnitude
    local dragForce = -0.5 * airDensity * (speed * speed) * proj.DragCoefficient * proj.Velocity.Unit
    local gravityForce = Vector3.new(0, -Workspace.Gravity * proj.Mass, 0)
    local windForce = (globalWind - proj.Velocity) * 0.05

    local totalAcceleration = (dragForce + gravityForce + windForce) / proj.Mass
    local nextVelocity = proj.Velocity + totalAcceleration * dt
    local nextPosition = proj.Position + proj.Velocity * dt + 0.5 * totalAcceleration * (dt * dt)

    -- 연속 레이캐스트 충돌 감지
    local displacement = nextPosition - proj.Position
    local rayResult = Workspace:Raycast(proj.Position, displacement, raycastParams)

    if rayResult and rayResult.Instance then
        -- 착탄 감지: 타격 이펙트 및 서버 판정 요청
        -- CombatRemote:FireServer("ProjectileHit", rayResult.Position, rayResult.Normal, rayResult.Instance)
        return false -- 발사체 종료
    end

    proj.Position = nextPosition
    proj.Velocity = nextVelocity
    return true
end

RunService.RenderStepped:Connect(function(dt: number)
    local subSteps = 2
    local subDt = dt / subSteps

    for i = #activeProjectiles, 1, -1 do
        local proj = activeProjectiles[i]
        local alive = true
        for step = 1, subSteps do
            alive = StepProjectile(proj, subDt)
            if not alive then break end
        end

        if not alive then
            table.remove(activeProjectiles, i)
        end
    end
end)

return Ballistics