剑环：三柄飞剑绕着转，贴身就挨削

 fx-swordring

--------------------------------------------------------------------------------
-- @file        SwordRing.lua
-- @brief       剑环 —— 三柄飞剑绕着转，贴身就挨削
--              客户端表现模块：配置表 / 飞剑构件 / 环绕结算 / 定时器
--------------------------------------------------------------------------------

local SwordRing = {}

--------------------------------------------------------------------------------
-- 配置与常量
--------------------------------------------------------------------------------
local CONST = {
    RING_LIFE     = 10.0,       -- 剑环十秒
    RING_CD       = 12.0,       -- 冷却十二秒
    RING_RADIUS   = 62,         -- 轨道半径六十二
    RING_SPEED    = 3.2,        -- 每秒转三点二弧度
    SWORD_COUNT   = 3,          -- 三柄飞剑
    HIT_GAP       = 0.8,        -- 结算零点八秒一跳
    HIT_DMG       = 9,          -- 一跳九
    HIT_BAND      = 30,         -- 扫掠带外扩三十

    -- 颜色
    COLOR_BLADE   = "#e6edf3",  -- 剑白
    COLOR_DEEP    = "#1f6f5f",  -- 深青
    COLOR_GHOST   = "#64d8b8",  -- 剑青

    ZORDER_GROUND = 118,
    ZORDER_SWORD  = 133,
    ZORDER_EFFECT = 135,

    AUTOINC_BASE  = 937000,
}

--------------------------------------------------------------------------------
-- 模块内部状态
--------------------------------------------------------------------------------
local _ringT     = 0              -- 环期余时
local _orbit     = 0              -- 轨道相位
local _hitT      = 0              -- 结算节拍
local _cdLeft    = 0
local _scheduler = nil
local _autoInc   = 0

local m_cos = math.cos
local m_sin = math.sin

--------------------------------------------------------------------------------
-- 辅助函数
--------------------------------------------------------------------------------
local function GenID(prefix)
    _autoInc = _autoInc + 1
    return string.format("%s_%d", prefix or "SWR", CONST.AUTOINC_BASE + _autoInc)
end

local function GetMyPos()
    local x = SL:GetValue("ACTOR_POSITION_X", SL:GetValue("USER_ID"))
    local y = SL:GetValue("ACTOR_POSITION_Y", SL:GetValue("USER_ID"))
    if not x or not y then return nil end
    return { x = x, y = y }
end

local function SafeRemove(node)
    if node and not GUI:Widget_IsNull(node) then
        GUI:removeFromParent(node)
    end
end

local function ShowTip(msg)
    if msg and msg ~= "" then SL:ShowSystemTips(msg) end
end

---飞剑构件：菱形剑身加脊线
local function CreateSwordNode()
    local node = GUI:Layout_Create(GUI:Attach_SceneF(), GenID("Swd"), 0, 0, 0, 0, false)
    GUI:setLocalZOrder(node, CONST.ZORDER_SWORD)
    GUI:DrawLine_Create(node, "edge_l", 0, 0, 3, 0, -13, -4, 0, CONST.COLOR_BLADE, 240)
    GUI:DrawLine_Create(node, "edge_r", 0, 0, 3, 0, -13, 4, 0, CONST.COLOR_BLADE, 240)
    GUI:DrawLine_Create(node, "spine", 0, 0, 2, 0, -8, 0, 9, CONST.COLOR_GHOST, 240)
    return node
end

--------------------------------------------------------------------------------
-- 开环与归鞘
--------------------------------------------------------------------------------
function SwordRing.Cast()
    if _cdLeft > 0 or _ringT > 0 then return end
    _cdLeft = CONST.RING_CD
    _ringT = CONST.RING_LIFE
    ShowTip("剑出了鞘——往前顶，让剑环贴着它削")
end

--------------------------------------------------------------------------------
-- 定时器：轨道推进与贴身结算
--------------------------------------------------------------------------------
if not _scheduler then
    _scheduler = SL:Schedule(function(dt)
        _cdLeft = math.max(0, _cdLeft - dt)
        if _ringT <= 0 then return end
        _ringT = _ringT - dt
        _orbit = _orbit + CONST.RING_SPEED * dt
        local mp = GetMyPos()
        if not mp then return end
        for s = 0, CONST.SWORD_COUNT - 1 do
            local a = _orbit + s * (6.28 / CONST.SWORD_COUNT)
            local sx = mp.x + m_cos(a) * CONST.RING_RADIUS
            local sy = mp.y - 46 + m_sin(a) * CONST.RING_RADIUS * 0.4
            SL:DrawSword(s, sx, sy, a)
        end
        _hitT = _hitT + dt
        if _hitT >= CONST.HIT_GAP then
            _hitT = _hitT - CONST.HIT_GAP
            local tid = SL:GetValue("MARK_TARGET_ID")
            local tp = tid and SL:GetValue("ACTOR_POSITION_X", tid)
            if tp and math.abs(tp - mp.x) <= CONST.RING_RADIUS + CONST.HIT_BAND then
                SL:ActorHurt(tid, CONST.HIT_DMG)
                SL:TipAbove(tid, "-" .. CONST.HIT_DMG)
            end
        end
        if _ringT <= 0 then
            ShowTip("剑归鞘了——下一环跟上")
        end
    end, 0.02)
end

SL:RegisterLUAEvent(LUA_EVENT_SCENE_CLEAR, "SWR_Clear", function()
    _ringT = 0
    for s = 0, CONST.SWORD_COUNT - 1 do
        SL:DrawSword(s, -999, -999, 0)
    end
end)

SL:ScheduleOnce(function()
    ShowTip("技能已加载: 剑环 (调试按钮触发)")
end, 1.0)

return SwordRing