特效总挂在脚后跟上？挂点表选对一行顶十行

【游戏功能】

先看一个熟场面：法师的火球特效挂在怪的脚后跟上，明明技能说明写着"焚烧其面"，火星子却在地上打滚。群里有位策划兄弟发火："挂点怎么又挂脚上了，改了三次了"。程序回他：代码里写死了 P.y 减三十，怪一换体型就露馅。我说别吵，这不是谁的错，是挂点压根不该写死在代码里。今天把挂点系统扒开讲透，看完你自己就能挂对。

一、挂点是什么？特效钉在角色身上的那个"钉子位"。整条链路是：特效请求带上挂点名 → ActorEffectManager 查挂点表 → 按角色当刻坐标换算出世界位 → 每帧跟着骨头走。

flowchart LR
A[特效请求+挂点名] --> B[ActorEffectManager]
B --> C{查挂点表}
C --> D[脚下 anchor_foot]
C --> E[手心 anchor_palm]
C --> F[头顶 anchor_head]
D --> G[每帧随骨骼换算世界位]
E --> G
F --> G
G --> H[特效钉在钉子位]

挂点表就是一张纯数据：挂点名、相对锚点的偏移、跟随权重。

-- buff/ActorEffectManager.lua · 挂点表骨架
local ANCHORS = {
    anchor_foot = { ox = 0,   oy = -8,   w = 1.0 },
    anchor_palm = { ox = 14,  oy = -58,  w = 1.0 },
    anchor_head = { ox = 0,   oy = -96,  w = 0.6 },
}
local function Resolve(name, px, py)
    local a = ANCHORS[name]
    if not a then return px, py - 30 end
    return px + a.ox, py + a.oy
end
local M = {}
function M.Attach(name, fx)
    M._list[#M._list + 1] = { name = name, fx = fx }
end
function M.Ready() return #M._list > 0 end
return M

三个挂点三种命：脚下挂地面特效（毒圈、冰霜、烙印），手心挂持握特效（火球、剑气、灯），头顶挂状态指示（血条、眩晕星、标记）。同一颗火球挂在手心是"法术"，挂在脚下是"事故"。表驱动的意义在于：换体型、换坐骑、换变身形态，挂点表跟着形态走一套，代码一行不改——写了死的坐标，怪一变大，火球就挂进地里。

挂点还有个隐藏属性：权重。头顶的挂点权重 0.6，意思是特效只跟六成的晃动——头是全身晃得最厉害的部位，特效全跟吐了，半跟留一点视觉缓存，飘但稳。手心权重 1.0 全跟，火球就得焊死在掌心。这个数不是玄学，是拿玩家晕不晕试出来的。

下面这个演示，先点三个挂点按钮切换钉位，看火球飘的位置；再用同一个「出招!」分别打三遍——脚下削地六点、手心正账十二点、头顶爆头十八点，同一个技能，挂点一换，账目三样。感受一下挂点就是结算位：

 fx-attachpt

二、实战案例：三步改造

为什么挂点能左右伤害数字？它不能——伤害是判定层算的，但表现层的落点会反向误导玩家对强弱的感知。火星炸在头上，六点看着像十六；火星滚在地上，十八点看着像挠痒。所以定挂点表要和数值同事坐下来对：核心技能的命中表现挂头线，功能性技能挂脚下，谁挂哪，是设计决定，不是程序随手。

实战案例：救"雷光盾"。需求是盾牌环绕特效要贴着角色的肩走。第一版挂在腰上，角色一跑盾就追着屁股转。三步改：第一步，挂点表加一行 anchor_shoulder，偏移量按站立姿态量；第二步，跟随权重给 0.8——肩的晃动比头小，跟八成刚好；第三步，变身形态单独一套挂点表，变身切换时 ActorEffectManager 把旧特效整体迁移到新表的同名挂点。改完策划的原话是：这盾终于像长在身上，不像拴在身上。

三、反面教材：两个数都拧反了会怎样

反面教材：有个服把全体技能特效统一挂 anchor_head，理由是"打头好看"。上线就穿帮——中毒的绿雾从怪的天灵盖冒出来，像着了火；回血的圣光糊在脸上，把表情全盖了。挂点的第一原则是语义：状态类挂头顶是提示，伤害类挂头线是打击感，环境类挂脚下是场域。一把抓挂头顶，就是让所有特效抢同一个话筒。

四、满屏同屏扛得住吗

性能这块，挂点系统是特效管线的第一道闸。每帧要做的事只有一件：挂点名查表、坐标换算、写回特效节点。开销在"每帧"两个字上——同屏两百个特效每个都跟着骨头晃，就是两百次三角函数。优化顺序：不动的特效（地面印记）在创建时换算一次就锁死，不走每帧跟随；同挂点的特效合并成一个宿主节点，父节点动一次子节点全跟；屏幕外的直接跳过换算。有个服把国战特效的每帧换算从一千二砍到三百，中端机稳定 60 帧。挂点表越省，手机越凉。

五、调试技巧：掏出来看

调试技巧：把挂点表打在屏幕上。调试期给 ActorEffectManager 加一个可视模式：每个活跃挂点画一个小十字，特效钉歪了一眼看穿——十有八九你会发现是偏移量的正负号写反了，y 轴向上向下这一昏招，坑过每一个写过表现层的人。

-- 调试：挂点可视化
SL:ScheduleOnce(function()
    SL:BindDebugButton("挂点十字", function()
        ActorEffectManager._debug = not ActorEffectManager._debug
        SL:ShowSystemTips("挂点可视 " .. (ActorEffectManager._debug and "开" or "关"))
    end)
end, 1.0)

常见疑问三连：挂点表谁来维护？程序建结构，策划和美术填偏移——他们对着角色立绘量，比程序拍脑袋准。换形态特效会断吗？不会——迁移是按挂点名对名搬家，表里同名就在。挂点能挂 UI 吗？别——UI 走 sui 那套布局，硬挂到角色身上，分辨率一变全是错位。

六、常见疑问

问：挂点为什么不能写死在代码里？
答：怪会换体型——写死的坐标换个形态就挂进地里，表驱动跟着形态走。

问：权重 0.6 是什么意思？
答：跟六成晃动留四成缓存——全跟吐，半跟飘但稳。

问：挂点影响伤害吗？
答：不影判定，影观感——火星挂头上六点看着像十六。

问：挂点表谁填？
答：程序建结构，策划美术量偏移——对着立绘量比拍脑袋准。

写完留一句给做特效管线的同学：挂点表三列——名字、偏移、权重。钉子钉对了，十行代码顶一百行补丁。