怪的皮一会儿绿一会儿红？状态染色的色号表就三列

【游戏功能】

先说结论放在开头：怪的皮一会儿绿一会儿红，不是美术换了几套贴图，是染色系统在怪身上盖了一层"色镜"。开服群里有位架设的老哥甩了段视频：他的怪中了毒该发绿，结果烧起来又变红，绿的影子都没有。他原话是"我毒抗火抗都配了，怎么颜色互相打架"。我说这不是打架，是两张染色表在同一帧都抢了话筒。今天把状态染色这套扒开讲透，看完你自己就能配色。

一、在 996 引擎里，怪身上的每个状态不是只挂数值，还挂一个表现实体。整条链路是：状态生效 → BuffManager 建实体 → 对应的 BuffEntity 子类接管表现 → ActorEffectManager 统一渲染。

flowchart LR
A[状态生效] --> B[BuffManager 建实体]
B --> C{读 BuffEntityColors 色号表}
C --> D[BuffEntityColor 染色层]
C --> E[BuffEntityAnim 换动作]
C --> F[BuffEntityIce 冻壳]
D --> G[ActorEffectManager 统一渲染]

染色这一支的代码在 buff/BuffEntityColor.lua，骨架就三件事：

-- buff/BuffEntityColor.lua · 染色三件套
local M = {}
local CONST = { LERP_TIME = 0.25, HOLD_TAG = "tint" }
local _cur = nil
local _target = nil
local _t = 0
local function ShowTip(msg) if msg and msg ~= "" then SL:ShowSystemTips(msg) end end
function M.Apply(tint, hold)
    if _cur and _cur.key ~= tint.key then
        ShowTip("混色：" .. _cur.key .. " + " .. tint.key)
    end
    _target = tint
    _t = CONST.LERP_TIME
    SL:ScheduleOnce(function()
        if _target == tint then ShowTip("染色到点，开始褪色") end
    end, hold)
end
function M.Ready() return _target ~= nil end
return M

色号表 BuffEntityColors 是一张纯数据表，一行一个状态：键名、目标色相、饱和度、渐变时长。表驱动的好处你现在听腻了也要再听一遍——策划想给"神圣"状态加一层淡金，改表就行，一行 Lua 都不用动。渐变时长统一走 0.25 秒，这是引擎调了几百个状态之后的手感值：再快，颜色"啪"地跳变像出错；再慢，状态都结束了颜色还没上来。

两个状态一起挂会怎么样？答案是混色：染色层不做覆盖，做叠加——毒的绿和烧的红同时在场，色相取中间值，饱和度抬高一档。你在演示场里点「淬毒!」再点「灼烧!」，看怪的皮先绿、再红、绿红同时挂的时候往土黄里混——这就是叠加在起作用，不是谁顶掉了谁。

下面这个演示，你先点「淬毒!」看绿是怎么五秒后自己褪掉的；褪完再点「灼烧!」；最后连着点两个，盯住中间那几秒的混色——

 fx-bufftint

二、实战案例：三步改造

为什么非要渐变不能直接换色？因为玩家对"突变"的注意力是警觉级的。颜色瞬变等于告诉玩家"出事了"，而染色表达的是"有个状态挂着"，是背景信息。0.25 秒的渐变让眼睛把它归到环境里去，不抢操作的注意力。表现层调优，调的从来不是颜色，是玩家的注意力预算。

去年带学员改"中毒加深"：需求是毒叠满五层变深绿。他第一版直接把饱和度拉满，结果绿得像荧光棒，玩家以为出了特效 bug。三步改回来：第一步，饱和度封顶 1.8，超出的层数改用粒子密度表达（一层一个绿雾粒）；第二步，混色表里给"中毒+迟缓"单独配了一行，别让两个冷色混出脏色；第三步，褪色时长跟状态剩余时间挂钩，剩一秒褪一半，玩家肉眼就能读出状态快到站。改完他群里发了一句：原来配色也是数值。

补一句表是怎么长出来的：色号表千万别一次配全——先配手里有原画参考的三五个状态，跑一圈看渐变，再回头补冷门的。一次配二十个状态的颜色，配到第十个你的眼睛就已经不可信了，后面十个全是凭着感觉瞎填。

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

反面教材也有一个。有个服把"冰冻"的染色做成了全屏蓝滤镜，想突出寒冷——结果全场的火墙也跟着发蓝，元素克制玩得深的玩家直接懵了：火怎么变冰了？染色的边界是怪的皮，不是玩家的屏幕。你想做环境氛围，去改天气层，别动状态染色这张表，两张表管两摊事，混了就都是事故。

四、满屏同屏扛得住吗

满屏国战的时候，同屏一百多个状态实体，染色层是开销最小的——它只是渲染管线里的一个滤镜开关，不改贴图、不建节点。真正的开销在 BuffEntityAnim 换动作那支：换动作要重定向动画状态机，一次状态切换就是一次加载。所以优化的顺序永远是：先砍无意义的换动作（比如中毒还非要换受击姿态）、再合并同色号的状态（三层毒共用一个染色实体）、最后才动渐变时长。有个服把同屏染色实体从 40 个合并到 12 个，低端机帧率从 19 拉回 31。省的每一层滤镜都是真金白银的手机发烫。

五、调试技巧：掏出来看

调试技巧：把染色实体掏出来看。ActorEffectManager 里维护着一张活跃染色表，调试期把它打出来：

-- 调试：把当前染色实体打成一行
SL:ScheduleOnce(function()
    SL:BindDebugButton("染色表", function()
        local lines = {}
        for k, v in pairs(ActorEffectManager._tints) do
            lines[#lines + 1] = k .. "=" .. v.key .. "@" .. v.alpha
        end
        SL:ShowSystemTips(table.concat(lines, " | "))
    end)
end, 1.0)

键名、色号、当前透明度一行看完。你调试"为什么颜色不褪"的时候，先看这一行——alpha 卡在 1 不动，就是褪色的 ScheduleOnce 没接上；键名重复，就是混色逻辑把同一个状态叠了两层。两分钟能定位的事，别去逐帧猜。

六、常见疑问

问：两个状态同时挂，颜色听谁的？
答：谁也不听——混色叠加，色相取中间，饱和度抬一档。

问：渐变为什么是 0.25 秒？
答：引擎调了几百个状态的手感值——再快像出错，再慢追不上状态。

问：染色会改贴图吗？
答：不会——只是渲染层的一个滤镜开关，贴图还是那张贴图。

问：褪色的时辰谁来管？
答：挂染色的时候一并登记——ScheduleOnce 到点回调，跟状态本体各走各的账。

写完留一句给做状态层的同学：染色表三列——键名、色号、时长。它管的是玩家的注意力预算，不是美术作业。