时间停止

简介

“时间停止”是晓美焰的标志性技能，其效果顾名思义，冻结时间，控制除自己以外的所有物体，暂停其一切行为。当这个技能发动的时候，怪物无法移动和攻击，花草树木不会生长，查理不会伤害黑暗中的玩家，飞行物将被定在原地，就连雨滴、雪和火山灰也会暂时悬浮在半空中。

时停技能可通过点按技能图标（在饥饿值图标左侧）来主动触发，持续8秒，技能结束后会进入冷却，时间为25秒（单机版）/30秒（联机版）。

在单机版中，世界时钟也会因为这个技能停摆。换言之，如果你频繁发动时间停止，那么一天的时间可能会延长到10分钟，而非默认的8分钟。这拖延了猎犬、蝙蝠和四季boss的来袭时间，但也意味着更多的饥饿值消耗和魔力的流失。

在联机版中，这个技能不会真正地停止游戏时间，并且它只会作用于晓美焰附近40单位距离内的物体，所以离晓美焰太远的玩家可能并不会察觉到这个技能被发动，但一旦玩家踏入魔法的控制范围，则ta也同样会被冻结。作为发动者，晓美焰自己显然不会受时间停止的影响，而其他玩家也可以在魔法栏位利用1个金块，1个齿轮和15点理智值制作一个精致的怀表，防止自己遭受时间魔法控制。

---

这些实体可以免疫时停：

• 带有homuraTag_ignoretimemagic标签（如熔炉模式下的伤害数字）
• 带有INLIMBO标签（放在物品栏和容器内的所有物体）
• 携带精致的怀表（包括玩家、猪人、切斯特等）
• 晓美焰
• 本身不符合上述条件，但母体免疫时停（如玩家释放符咒时的光）

这些实体可以暂时免疫时停：

• 刚刚被扔出的物体（如回力标、水球）
• 刚刚被丢在地上的物体

---

代码实现

1.计时机制的暂停

暂停实体需要注意很多细节。比如，将一个物体的动画（AnimState）和运动（Physics）暂停以后，还需要阻止它内部的计时机制。以草的燃烧为例，一根草被点燃后，经过7.5秒的燃烧，熄灭变为灰烬，这个过程的计时是基于延时任务函数（DoTaskInTime）。对于这个计时器，官方提供了添加和取消它的方法，但没有提供暂停它的方法，所以得自己写一个。

--这个函数可以让延时任务的完成时间往后推1帧
local function PeriodicPostInit(self)
    function self:AddTick()
        local thislist = scheduler.attime[self.nexttick]
        self.nexttick = self.nexttick + 1
        if not thislist then
            return
        end
        if not scheduler.attime[self.nexttick] then
            scheduler.attime[self.nexttick] = {}
        end
        local nextlist = scheduler.attime[self.nexttick]
        thislist[self] = nil 
        nextlist[self] = true
        self.list = nextlist
    end
end
AddGlobalClassPostConstruct('scheduler', 'Periodic', PeriodicPostInit)

如果想要暂停一个实体的全部延时任务，可以用以下这段代码。

--遍历实体的所有计时器，并让它们的完成时间往后推1帧
--配合组件的OnUpdate函数就能实现计时器暂停
for k in pairs(inst.pendingtasks or {})do
    k:AddTick()
end

这样一来，物体内部的计时器就被控制住了。这有什么作用呢？举两个例子。一个干草已经燃烧了5秒，此时发动时停技能，则这个燃烧的草不会在技能持续期间突然变成灰烬，而是在技能结束后的2.5秒才熄灭；反之，先在地上摆5个干草，发动技能，趁技能结束前依次点燃这5个干草，那么这些干草会在技能结束后才会熄灭，并且是同时熄灭。（因为它们是被“同时”点燃）

2.阻止组件刷新

colourtweener（渐变），grue（查理攻击），projectile（子弹）等组件中存在着一个刷新机制，例如海象射出的吹箭，会以每秒30次的频率计算自己和目标的距离，如果距离小于1，就判定为击中目标，否则继续往前飞行。我们并不希望在撞上停止运动的飞行物后会受到伤害，所以要阻止组件的刷新活动。
有少部分组件的刷新是不应该被暂停的，如container（容器），如果暂停的话，会导致界面无法正常关闭。

local skip_components = {
    'container', --保证容器界面正常关闭
   --[[......]]--
}
local function CanHook(name)
    for _,v in pairs(skip_components)do
        if v == name then
            return false
        end
    end
    return true
end

local function ComponentPostInit(self)
    local old_add = self.AddComponent
    function self:AddComponent(name, ...)
        old_add(self, name, ...)
        if CanHook(name) and self.components[name].OnUpdate then 
            local cmp = self.components[name]
            local old_up = cmp.OnUpdate
            cmp.OnUpdate = function(self, ...)
                if self.inst:HasTag('homuraTag_pause') then 
                    return
                else
                    old_up(self, ...)
                end
            end
        end
    end
end

AddGlobalClassPostConstruct('entityscript','EntityScript', ComponentPostInit)

3.范围搜索

为了游戏的流畅性，时间停止技能显然不应该将饥荒世界里的所有物体都控制住，它只影响以玩家为中心，40半径范围内的物体——这个范围已经大大超出了玩家的视野范围。

在何时搜索附近实体呢？一般的思路是，在技能发动时搜索一次，把附近所有物体暂停，然后在技能结束时解除暂停状态。但略作思考就能发现问题：假如在技能持续期间，出现了一个新的物体（比如落下来一只鸟），则这个物体是无法受到控制的。因此，我们应该每隔一段时间就进行一次搜索。

--以每秒30次的频率搜索附近实体
local function OnUpdate(inst, dt) 

    --[[......]]--

    --再次遍历周围实体，加入新的，移除出范围的
    local ignoretags = {"INLIMBO", "homuraTag_ignoretimemagic"}
    local searchlocal = not TheNet:IsDedicated()
    for player in pairs(inst.centers)do
        local x,y,z = player:GetPosition():Get()
        local ents = TheSim:FindEntities(x,y,z, MAGIC_RADIUS, nil, ignoretags)
        for _, item in pairs(ents)do  
            if not IsMagicImmue(item) and (item.Network or searchlocal) then 
                if not inst.items[item] then
                    inst:AddItem(item)
                    inst.items[item] = 2
                else
                    inst.items[item] = 2
                end
            end

            --[[......]]--

        end
    end

    --如果对应值仍然为1，则移除
    --如果对应值为2，不移除，并重置为1，然后对这些实体进行更新
    for k,v in pairs(inst.items)do
        if v == 1 then 
            inst:RemoveItem(k)
        end
        if v == 2 then 
            inst.items[k] = 1
            ItemTimeMagicUpdate(k, dt)
        end
    end

    --[[......]]--

end