魔族回路运行机制
实际耗能记账、共享余魔储量、技能状态转换与仅面向持有者的HUD同步。
魔族回路属于种族内部实现。DemonCirculationState负责能量记账,玩家组件在服务端推进状态,再投射为状态图标与HUD显示。具体玩法数值见魔族。
它做什么
DemonEventFactory订阅SpellCastEvents.ON_ENERGY_SPENT。CommonEventFactory在耗能计算完成后,发布实际从星界能量中扣除的数量。只有非创造模式的服务端玩家支付魔法耗能时才进入回路记账;命中回调、免费生效与能量回复均不提供余魔。
DemonCirculation连接魔法付费、咏唱计时、对外魔法伤害与受击抵伤。术式选择、消耗计算、生效次数与引导计时仍由现有法术系统负责。
运行时模型
DemonCirculationModule由isekaiexpansion:dynamic_player承载,重生策略为RespawnCopyStrategy.NEVER_COPY。生效中的上位魔血启用模块;死亡、能力失效或种族身份变化会卸载模块并清除标记。正常读取仅在保存身份一致时恢复状态。宿主封装见动态玩家模块。
存档字段如下。缺少的数值字段按零读取,负数与非有限能量值被丢弃。计时限制在状态机允许的范围内,零头始终小于一点能量;读取开启中的回路时,会清除同时存在的收束返还。
| 字段 | 类型 | 默认值 | 作用 |
|---|---|---|---|
reserve | double | 0 | 仍可用于抵伤或之后回收的余魔。 |
recovering | double | 0 | 已进入返还、不能再用于护盾的余魔。 |
credit | double | 0 | 等待累计为整点返还的能量零头。 |
passiveRate | double | 0 | 当前这段未中断的常态回收每刻返还量。 |
idleTicks | int | 0 | 距离上次魔法付费的刻数。 |
recoveryTicks | int | 0 | 收束返还的剩余刻数。 |
overloadTicks | int | 0 | 魔能过载的剩余刻数。 |
capacity以double保存,默认值为0,用于恢复与本人快照。后续服务端更新会根据当前最大星界能量重新计算,因此它不是独立的容量依据。容量下降会截断储量,正常能量上限丢弃溢出返还。
动态宿主在脏状态下每4刻(0.2秒)仅向本人发送完整模块载荷。主动施放与受击抵伤标记宿主为脏,沿用同一同步节奏。模块是否存在决定HUD可见性,零头记账仍以服务端为准。
约定
开启过载只启动一次冷却。收束要求回路已开启足够时间,并将余魔一次性转为待返还能量。自然结束复用相同转换。返还期间的新施法积累独立余魔,不会中断待返还部分。
SkillPowerUtil在执行处理器前查询CooldownBypassSkill。被接受的后续操作保留原冷却条目及其初始总时长;客户端提示只决定是否允许发送请求。服务端仍检查能力持有情况、生效状态与实际状态转换。DemonEnergyOverloadASkill只计算一次技能急速,并执行冷却下限。
SpellCastTiming将回路系数乘入非引导魔法的咏唱时间。IsekaiDamageCondition只对MAGIC伤害应用当前回路阶段。两处都不修改法术定义,也不额外制造一次效果。
PlayerDamageAbsorptionMixin在玩家伤害完成减伤后,先处理个人屏障,再处理魔族抵伤。回路先扣除原版伤害吸收对应的部分,再按剩余生命伤害消耗余魔。仅其他活体攻击者符合条件,无视无敌的来源被排除。
isekaiexpansion:demon_energy_overload、isekaiexpansion:demon_residual_energy与isekaiexpansion:demon_ancient_blood_recovery均为有益、不可用牛奶清除的标记,分别归入攻击、防御与回复分类。放大器不拥有玩法状态。通过指令添加标记不能开启回路、生成余魔或获得伤害加成。
上位魔血还通过Origins属性能力,以multiply_base向isekaiexpansion:energy_regen_speed添加+0.5。基础自然回复速度因此提升50%,余魔记账不受影响,也不另加一套逐刻回复逻辑。
回收表现
二次按键成功后,播放isekaiexpansion:skill_demon_energy_reclaim与绑定脚下的单次特效isekaiexpansion:studio/demon-energy-reclaim/demon-energy-reclaim。动画持续14刻(0.7秒),双手向内收拢;仅前2刻(0.1秒)限制物品使用与攻击,移动和跳跃不受限制。能量返还先于表现开始,不必等待动画完成。
Studio制作的特效使用鬼族的火焰材质,形成六道向内回流的能量。表现契约与原生源文件一起保存在KTM Effek Studio中。
| 表现项 | 数值 |
|---|---|
| 原始缩放/外部包络 | 1.0/6.4格 |
| 胸前汇聚点 | 本地Y轴1.15 |
| 回流轨迹 | 原生第0–36帧 |
| 吸收节拍 | 原生第17–24帧 |
| 最后余光 | 原生第58帧 |
| 控制器寿命 | 90原生帧 |
| 大小控制 | 动态输入1 |
原生帧率为每秒60帧。特效没有释放触发器或持续发射器。二次按键使用isekaiexpansion:cast.buff_1,首次开启仍使用isekaiexpansion:fx.overload。这些表现时序不改变三秒的能量返还。
RetriggerableSkill报告处理器当前是否处于后续阶段,与CooldownBypassSkill的冷却绕过权限分开。仅向持有者同步的isekaiexpansion:skill_phase组件从实时能力推导两项标志,在成功触发后及服务端逐刻刷新,仅在变化时同步,不保存阶段数据。SkillPhaseAPI提供只读查询,触发判定仍由服务端处理器负责。可选的_rt贴图规则见起源图标资源。
辅助HUD条
DemonHudSnapshot在客户端线程将同步状态转换为不可变的AuxiliaryHudGauge条目。余魔与待返还能量使用各自固定的ID,待返还量大于零时才增加第二行。过载期间,三个充能圆点显示已到达的阶段及前往下一阶段的部分进度;显示投射不改变伤害计算。
AuxiliaryHudLayout统一管理物品进度条、物品模型与辅助条的位置。边框尺寸为44 × 8 GUI单位,基准位置在水平中心+69、底部−57。显示物品进度时,为其保留基准槽位,资源条以24单位的行距向上排列;没有物品进度时,第一条资源占用基准槽位。每行预留上方4单位圆点与下方5.5单位文字的空间,过长文字缩小至行宽以内。越过顶部留白的行不显示。
AuxiliaryHudAtlas按176 × 176的逻辑图集读取assets/isekaiexpansion/textures/gui/extra_hud_bar.png,资源包提供更高分辨率图片时也沿用这套坐标。边框区域为(0, 0, 176, 24);青色、紫色与黄绿色填充条均为128 × 8,起始y分别为34、46与58。圆点边框为(163, 33, 13, 13),内缩2像素。选定填充条的中段填入9 × 9内部区域,按部分充能量从底部向上裁切,最后绘制边框。魔族使用青色。
PlayerHudAuxiliaryBars在UI线程按条目ID保留文字排版与动画值。渲染只读取不可变快照,不读取玩家实时状态,也不在每帧重新排版文字。
扩展方式
状态转换与守恒规则放在DemonCirculationState中。接入新的来源时,在付费或伤害结算处添加运行适配;不能按目标、弹体或术式后续法术独立奖励余魔。
组件负责推进、持久化与显示状态投射,渲染读取其同步视图。种族身份继续由Origins能力管理,法术是否合法继续由法术运行机制判断。
新增资源显示时,在ModuleHudSnapshot中加入AuxiliaryHudGauge。每项提供唯一且固定的ID、已翻译标签、配色、归一化填充量、0至8的圆点数量及可带小数的充能数。列表顺序决定由基准位置向上的排列。玩法状态由来源系统负责,图集绘制、裁切与物品进度避让由共享渲染器负责。
验证
运行./gradlew.bat compileJava assembleLanguageFiles。
游戏内应对比相同耗能的单体与群体施法、付费引导生效以及已预付的术式后续法术。检查冷却中的技能栏收束、重复按键、技能急速、屏障和伤害吸收之后的抵伤消耗、阶段提示、死亡、切换种族与重连。对比有无上位魔血时的基础回复。在多种GUI缩放下,带着余魔或待返还能量切换物品进度显示,检查圆点的部分填充,并切换语言。这些集成及视觉场景需要运行游戏。