天狗食月纹：月亮一口被吞，黑里全是刀

【游戏功能】

线上事故引入：早上打谷场黑了半拍——有人开了天狗食月，满场的怪全瞎了眼乱挥爪，可挨打的人有的掉血有的不掉，同一个黑窗口里两套规矩。值班的一查，黑暗窗口挂上了，可怪的出手口有的地方读了窗口、有的地方没读，读了的挥空，没读的照拍不误。这篇把天狗食月纹整套写法重写成篇：吞月、入暗、挥空、复明，一段一段照抄能跑。

一、效果演示

演武场是一片打谷场的夜地，头顶挂着一轮明月，怪走进来站定。点「食月!」——天狗一口把月亮咬掉，全场瞬间黑下来，倒计时挂在右上角。黑暗的六秒里怪的朝向乱转、出爪全凭摸，爪爪挥空；你在黑里下刀，一刀二十一点。六秒一到月亮回来、全场复明，十秒一轮。

flowchart TD
A[食月!] --> B[月亮被咬 黑场]
B --> C[它摸黑乱转]
C --> D{它出爪了吗}
D -- 出爪 --> E[读暗表 挥空]
D --> F[你暗里下刀 二十一点]
E --> G{六秒到了吗}
F --> G
G -- 没有 --> C
G -- 到了 --> H[复明 十秒再吞]

 fx-crest-eclipse

二、底层原理

天狗食月纹的机关是「全场地氛有人认」——黑暗不是一个滤镜，它是一份挂在场地上的暗表：怪的出手口出爪前先来读这份表，读到暗重过半，这一爪就照着挥空结；你的出手口也读它，读到暗就按二十一点结。早年那单「黑了半拍两套规矩」的事故，就是暗表挂上了、出手口只接了一半——读的人不齐，黑就成了装饰。窗口的两头也要收干净：入暗要有半拍的渐黑，复明要有半拍的渐亮，怪醒那一下还得把朝向还给它自己。幂尔框架这边，暗只放一个浓度量加一个时辰量，浓度管演出、时辰管账，两头读同一份。

这套玩法的代码量不到七十行，难的不是吞月那一下，难的是暗表人人来读——出手口读全了，黑才是真的黑；读一半，黑就是一块布。

暗场的渐变给了「黑」一个来去的路：吞月那半拍由亮转黑，复明那半拍由黑转亮，月亮缺了又圆——黑得有头有尾，玩家才敢在黑里下刀。

再补一句关于月亮的话——被咬的月亮不是整个消失：缺口的弧一点点扩大，黑到最深处只剩一圈极淡的晕，复明时缺口再一点点长回来。月亮的圆缺就是暗表的表盘，玩家抬头看一眼月牙，就知道这一轮黑到了几分、还剩几拍——表不用读数字，读月亮就行。

暗里的怪还有一层细节值得单说——它摸黑那几秒不是站着挨打的：耳朵会动，会朝着声响的方向偏半步，爪子挥的方向多半冲着声响去。这层「盲听」给了黑窗口一点活气：有心的人在黑里故意弄出动静引它偏头，把它引到背对的位置再下刀——黑是公平的，会用的的人把它用成自己的夜。

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

-- @file crest-eclipse.lua
-- 天狗食月纹：月亮一口被吞，黑里全是刀

local M = {}
local CONST = { AUTOINC_BASE = 1214300 }
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 M.Ready() return true end

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

-- 出手口: 读暗表挥空
function M.OnClawSwing()
    if M.Dark() > 0.5 then
        ShowTip("它摸黑挥空了!")
        return false
    end
    return true
end
function M.Dark() return _a end

if not _ticker then
    _ticker = SL:Schedule(function(dt)
        if _on then
            _t = _t - dt
            _a = _t > 1 and 0.62 or _a - 2 * dt
            if _t <= 0 then _on = false _a = 0 ShowTip("月亮回来了") end
        else
            _a = _a - 3 * dt
            if _a < 0 then _a = 0 end
        end
    end, 0.05)
end
SL:ScheduleOnce(function()
    SL:BindDebugButton("食月!", function()
        if _on then ShowTip("天还没亮") return end
        _on = true _t = 6
        ShowTip("天狗食月——黑下来了!")
    end)
end, 1.0)
function M.Unload() _on = false _a = 0 _t = 0 end
return M

五、机制问答

问：黑了之后它为什么还乱转？
答：神志没灭只是瞎——暗表只接它的眼和爪，脚还是它自己的。

问：它黑里出爪怎么结算？
答：出手口读暗表——暗重过半这一爪照挥空结，一分不掉。

问：你黑里下刀为什么疼？
答：它睁眼瞎——背光挨刀，一刀二十一点，明暗两档。

问：复明那一拍它的朝向归谁？
答：归它自己——暗表一撤朝向还给它，黑里怎么转都不记仇。

问：十秒一轮管什么？
答：食月的回气。

六、调参与实战怎么用

参数三个量——暗场时辰、暗里加成、回气。六秒、二十一对十四、十秒是一组甜点位：六秒够它挥两爪空、你下三刀重，黑白两头的账都算得过来。想调险些把时辰缩到四秒——窗口薄了，抢刀的要求高了一截，加成可以抬到二十四找平。

补一句设计层面的话——这六手有改天时的、有改地利的、有改人和的：食月改天时、跃龙借地利、鬼打墙乱它的人和、吞剑攒自己的势、神速提自己的拍、掷卦赌自己的运——天时地利人和势拍运，七样里占六样，玩家配纹配的就是这几样的组合。

补一句维护层面的话——这轮借的东西都要还：月亮要还、朝向要还、间隔要还、倍率要清，卸载口里一样一样归位。暗表撤了还留半截黑、催速停了间隔是负的、卦清了倍率还挂着，都是没还干净的账。

补一句工程层面的话——凡是要「人人来读」的场氛和倍率，都走查询口：暗走浓度口、晕走圈角口、卦走倍率口，读的人认口不认变量——哪天黑换了月亮来管，读的人一行不用动。

这一手在实战里的分量在「等」字：食月等它挥空、跃龙等它站定、鬼打墙等它入圈、吞剑等三拍走满、掷卦等正面向上——会等的人，纹纹都在点子上；不会等的人，月亮吞了也白吞。

反馈要成对：暗场配倒计时、鱼影配弧线、圈影配秒数、白光配三拍、残影配秒表、铜板配倍字——演出给一半，明账给一半，玩家两头都看得见。

最后说实战：这轮的拍点全在天上和风里——月亮缺几分明、鱼翻到几层高、铜板转到第几枚，都是掐得出的点；掐得住的赌不叫赌，叫算账。

写完留一句给做地纹系的同学：暗表要人人来读——出手口接全了，黑才是真的黑；接一半，黑就是一块布。