开光佩纹：纹章上胸，刀刀生光

【游戏功能】

线上事故引入：早上客诉炸了——玩家花了六百八买的纹章礼盒，纹章躺在背包里闪闪发光，属性一条没涨。排查发现佩戴流程只把图标挪进了装扮栏，属性挂接那段根本没跑，前端显示"已佩戴"后端账上毛都没有。修完顺手把佩戴这套表现重写成篇：一枚纹章怎么飞到胸口、纹位怎么一格格点亮、刀重怎么一档档往上跳。

一、效果演示

演示场左边一位侠客右边一只巨兽，正面对峙。点「佩戴纹章」：一枚纹章从侧边飞旋着落上侠客胸口，左上角三个纹位格子应声点亮一枚——刀重从十四跳到二十二。连点三下，三纹齐佩的瞬间金光一圈炸开，此后每一刀再添十点加成。巨兽扑过来和你对刀，血条在它头顶一格格掉。

flowchart TD
A[点佩戴] --> B{纹位满了吗}
B -- 满 --> C[提示三个纹位全满]
B -- 没满 --> D[纹章飞向胸口]
D --> E[纹位点亮]
E --> F[刀重上一档]
F --> G{三纹齐了吗}
G -- 否 --> A
G -- 是 --> H[触发生光加成]

 fx-crest-equip

二、底层原理

佩戴系统的机关是"槽位驱动"——纹位是固定的三个格子，佩戴动作只是往格子里放东西，属性加成永远从格子现场数出来而不是存一个总数。这一条是那场客诉的正解：显示层说"已佩戴"没用，格子里的货和属性账本是两本账，任何改动都要以格子为准重算一遍加成。刀重的算法简单到不需要注释：基础十四，每纹加八，三纹齐佩再一次性给十——档位感就是数值的节奏感，玩家要的是"再佩一枚能涨多少"的可预期。
飞行表现是佩戴的仪式感所在——纹章从侧边起步、旋转、落到胸口，落位瞬间粒子炸开配一声"纹!"。飞行中途再点佩戴被拦下，一次只飞一枚，落一枚亮一格，节奏不能乱。幂尔框架这边用调试按钮接佩戴入口，状态栏把每一档刀重报出来，测起来一目了然。

这套玩法的代码量不到一百行，难的不是放格子而是两本账的口径统一——显示归显示、加成归加成，源头永远只有一个。

再看三纹齐佩的加成设计——为什么不做成每纹加十二而是"八、八、八再加十"？因为质变要留给"齐"这个动作：单枚平平无奇，凑齐那一刻多给一记重赏，玩家凑槽的动机就从"慢慢攒"变成了"就差最后一枚"。数字上这是同一笔账，体感上是两种玩法。落地时注意齐佩加成只发一次——用纹位数等于三这个瞬间做闸门，别做成"三纹状态下每刀都查一遍"的持续判断，那样改配置容易出双发。

三、核心代码：完整模块（上·骨架）

-- @file CrestEquip.lua
-- 开光佩纹 —— 纹章上胸 刀刀生光

local CrestEquip = {}

local CONST = {
    SLOT          = 3,
    BASE_DMG      = 14,
    PER_CREST     = 8,
    TRIO_BONUS    = 10,

    AUTOINC_BASE  = 1198600,
}

local _eqN     = 0
local _flying  = false
local _autoInc = 0

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

local function GenID()
    _autoInc = _autoInc + 1
    return CONST.AUTOINC_BASE + _autoInc
end

-- 三个纹位现场数出来的加成，不存总数
function CrestEquip.Bonus()
    local n = _eqN
    if n >= CONST.SLOT then
        return CONST.PER_CREST * n + CONST.TRIO_BONUS
    end
    return CONST.PER_CREST * n
end

function CrestEquip.Dmg()
    return CONST.BASE_DMG + CrestEquip.Bonus()
end

function CrestEquip.Count() return _eqN end

四、核心代码：完整模块（下·推进与卸载）

-- 佩戴：一次只飞一枚
function CrestEquip.Equip()
    if _eqN >= CONST.SLOT then
        ShowTip("三个纹位全满了")
        return
    end
    if _flying then return end
    _flying = true
    _eqN = _eqN + 1
    ShowTip("第" .. _eqN .. "纹上胸——刀重" .. CrestEquip.Dmg())
    if _eqN >= CONST.SLOT then
        ShowTip("三纹齐佩——刀刀生光")
    end
    _flying = false
end

SL:ScheduleOnce(function()
    SL:BindDebugButton("佩戴纹章", function()
        CrestEquip.Equip()
    end)
    ShowTip("技能已加载: 开光佩纹")
end, 1.0)

function CrestEquip.Unload()
    _eqN = 0
    _flying = false
end

return CrestEquip

五、机制问答

问：为什么加成从格子现场数而不是存总数？
答：两本账必对不上——佩戴、卸下、重载任何一路改动都要以格子为准重算，存总数的迟早漂移。

问：飞行途中连点佩戴怎么处理？
答：一次只飞一枚——飞行中再点直接拦下，落一枚亮一格，节奏不能乱。

问：齐佩加成为什么不均摊到每枚？
答：质变留给"齐"这个动作——单枚平平、凑齐重赏，凑槽的动机才够足。

问：纹位满了再点会怎样？
答：拦下并提示——入口处先查格子，满了不消耗任何东西。

问：卸下纹章加成怎么走？
答：同一句现场重算——格子少了加成立刻掉档，不存在残留。

六、调参与实战怎么用

参数层面三个量——每纹加成、齐佩重赏、基础刀重。调的次序先定基础刀重让玩家打得动怪，再定每纹加成让档位跳得明显，最后定齐佩重赏给质变一记响的。实战里这套槽位驱动的思路直接能搬：法宝栏、符文页、称号位，一切"放格子涨属性"的系统都是同一套账。常见坑两个：显示层自己算加成不走统一入口，和账本对不上；齐佩加成做成持续判断，重载或换装时双发。

补充一个设计层面的思考——纹章类玩法的设计核心是"期待感的节奏"：每一次佩戴、镶嵌、升星、洗练都是一次开奖，开奖的间隔和反馈的强度决定玩家留不留下来。反馈要三层齐发：数字层（刀重变了几）、表现层（光效震屏飘字）、文案层（状态栏一句话说清发生了什么）。三层缺一层，玩家就觉得"点了没反应"。

补充一个维护层面的思考——纹章系统的数值全收在参数表里，概率、上限、每档加成一个数字都不许硬编码在流程里。策划调爆率、调保底、调加成，改表就生效，热重载立刻可见。状态变量收在模块闭包里，卸载入口归零——纹章这类带概率和计数的系统，脏状态残留是客诉的重灾区。

补充一个工程层面的思考——带概率的流程必须把概率计算收成单个函数，输入是计数输出是概率，别处一律调用不许自己算。这样策划要验概率分布、测试要回归、排查要复现，都只需要盯一个函数。概率散落在流程各处是这个品类事故的头号来源，收口一次受益全年。

写完留一句给做养成系的同学：纹章上胸那一刻的亮，是玩家花钱买来的——两本账合一本，每一格都作数，客诉自然就没了。