Kzeroko KTM2

地形冲击

地面裂纹、掀起的板块、翻滚碎块与按法术范围缩放的镜头震动。

更新于 2026/11/8 8 分钟阅读

TerrainImpactAPI由服务端确定地面接触点,再由客户端绘制地形破碎效果。大型冲击同时呈现倾斜板块、裂纹条带和飞散碎块;是否永久破坏方块由服务端单独控制。

它做什么

门面位于net.kzeroko.isekaiexpansion.api。emit接收服务端世界、Area、Profile与可为空的施法者;shake根据爆炸半径调整震动的传播范围与强度,再交给ImpactShakeAPI处理。

天坠在每层推进的伤害环上使用SOUL_WAVE,半径为24格,10层波面在25刻(1.25秒)内向外推进。寰宇崩毁在延迟引爆时使用CATACLYSM,后续脉冲使用AFTERSHOCK;命中屏障时不产生地形效果。两者都根据半径调整镜头震动。普通投射物溅射与寰宇露滴使用IMPACT。

预设表面采样数碎块尺寸冲量板块抬升存续时间波面延迟可破坏方块
IMPACT240.45格×0.70格42刻(2.1秒)0刻(0秒)false
CATACLYSM960.85格×1.351.2格90刻(4.5秒)10刻(0.5秒)true
SOUL_WAVE400.65格×1.10.95格80刻(4秒)0刻(0秒)true
AFTERSHOCK320.5格×0.80.45格48刻(2.4秒)5刻(0.25秒)false

表内数值是预设参数,各碎块会在对应范围内变化。碎块尺寸低于配置上限,板块宽度为0.85–1.5格。板块先被掀起,保持倾斜后缓慢沉回地面;它们没有碰撞体,也不会放置真实方块。飞散碎块使用体素扫掠碰撞,并计算反弹、摩擦和水中阻力。

刚体求解器位于 internal.physics.block。地脉法术在客户端显现岩层、服务端判定岩牙命中时,使用同一条垂直位移曲线。岩块保持原尺寸,越过地面的部分才会显现。大地尖牙依编织强度在 3~6 刻内完全升起。

运行时模型

internal.terrainimpact.TerrainImpact只扫描已加载的区块列,在伤害形状内寻找暴露表面;垂直搜索最多到原点上方3格、下方16格。液体、排除的材质、方块实体、不可破坏方块与非模型方块都会阻断该列。一次冲击先完成全部采样,再按设置移除方块,因此不会连续向下挖穿多层地面。

isekaiexpansion:terrain_impact数据包携带维度、原点、半径、确定性随机种子、视觉预设与材质接触点。客户端读取方块模型各面的贴图和染色索引,独立模拟碎块,并在实体之后绘制。Iris阴影阶段跳过绘制;断开连接、更换世界与资源重载都会清空效果。粒子质量设置会降低接收数量。

临时岩层即将消退时,客户端为可脱落的岩块预留名额。收到移除更新后,这些岩块独立脱落,其余岩层在原处淡出。大地尖牙保留该段岩牙的体素轮廓,叹息之墙和盖娅的庇护保留整块模型、朝向和各面的纹理。赭岩魔像的岩块则从当前动画姿势逐块脱落。岩块与地形碰撞,也能落在先前沉下的碎石上。支撑消失时,岩块会继续下落。这些效果共享地形冲击的渲染预算。客户端缓存每格岩层的材质模型,材质变更或资源重载时重新采集。碎块、板块和裂纹沿同一曲线淡出。

预算上限
每包接触点96
每世界每刻探测数16384
每世界每刻接触点384
每世界每刻移除方块数32
客户端每刻新增效果192个
默认活跃效果数(全部/减少/最少)384 / 256 / 96
客户端采样步长:全部/减少/最少1 / 2 / 4
默认客户端绘制距离64格

本地的方块碎片设置同时适用于地脉法术和地形冲击。blockDebris.enabled 默认为 true。blockDebris.fadeTicks 默认为 22 刻(4~80),blockDebris.maxPieces 默认为 384(16~768),blockDebris.viewingDistance 默认为 64 格(8~80)。三档粒子质量对应的活跃效果上限分别为 768、256、96。

同一时间的冲击共享这些预算。超出的采样或效果直接舍弃,不创建服务端实体、存档数据或待处理队列。所有允许的半径都受相同的探测预算约束。

调用约定

在服务端线程上对有效世界调用门面。Area要求坐标有限,水平方向的边界距原点不超过128格。sphere和ring的外半径必须大于零且不超过128格;环形的上下高度不能为负。自定义区域需要提供准确的点包含判断,垂直边界也会限制接触点。

Profile中的参数都是必填的Java构造参数。数值不合法或不是有限数时抛出IllegalArgumentException。

字段类型默认值作用
samplesinteger必填表面接触点上限,1–96。
fragmentSizenumber必填碎块边长上限,0.1–1.5格。
impulsenumber必填速度倍率,大于0且不超过3。
plateLiftnumber必填板块的标称抬升量,0–3格;零表示不生成板块。
lifetimeTicksinteger必填标称存续时间,20–120刻(1–6秒);各效果会略微缩短。
waveTicksinteger必填随半径增加的启动延迟,0–30刻(0–1.5秒)。
breaksTerrainboolean必填其余服务端检查也通过时,允许永久移除方块。
spellTerrainDestructionbooleanfalseconfig/isekaiexpansion.json中的服务端同步选项,界面归入法术类别。允许合适的预设与施法者永久移除方块。

永久移除要求施法者存活且处于同一世界。玩家必须拥有世界修改权限,并通过出生点保护与世界边界检查;非玩家施法者还需要开启mobGriefing。携带行为者的breakBlock会执行现有区域保护检查。移除方块不掉落物品,硬度不得超过5,还必须属于可破坏标签;方块实体与排除材质始终不可移除。施法者为null时只产生视觉效果。

三个方块标签位于data/isekaiexpansion/tags/blocks/:

标签用途
isekaiexpansion:terrain_impact_materials可采样为视觉效果的材质。
isekaiexpansion:terrain_impact_excluded即使属于上一标签也会排除的材质。
isekaiexpansion:terrain_impact_breakable永久移除的额外限制;内置条目覆盖天然地形。

震动传播距离为min(96, 2 × radius + 12)格。源强度乘以min(2, sqrt(radius / 6)),随后由ImpactShakeAPI处理距离衰减与强度上限。粒子接收预算不会抑制震动。

扩展

可直接用预设发起完整冲击。只有本次调用允许永久移除方块时,才传入施法者:

var area = TerrainImpactAPI.Area.sphere(point, radius);
TerrainImpactAPI.emit(world, area, TerrainImpactAPI.CATACLYSM, caster);
TerrainImpactAPI.shake(world, point, radius,
        ImpactShakeAPI.Shake.impact(12, 24));

内部工具AoECommonUtil的构建器接受.terrainImpact(profile, caster),让接触点与伤害形状、定时脉冲一致。它们先选定伤害目标并检查掩体,再按设置移除方块。保存的世界实例不再是服务器当前实例时,定时区域与推进波会停止。整圈扩散波只调用一次震动;独立引爆可以分别调用,不应为每个接触点都触发震动。

验证

运行compileJava,再在石头、草方块、台阶、坡地与洞穴地面上检查两个法术。覆盖离地命中、未加载区块边界、重叠施法、全部粒子档位、切换维度与资源重载。确认草顶染色不会把原本无染色的泥土面也染绿。在游戏内检查前景遮挡和目标Iris光影包。

关闭破坏设置时,对比效果前后的真实地形。开启后检查天然表层移除、无掉落、区域保护拒绝、方块实体排除、玩家建造限制与NPC施法的mobGriefing约束。确认天坠的推进波面与寰宇崩毁的延迟引爆符合伤害时序。这些是验收步骤,不是已经完成的视觉测试记录。

相关

法术交付约定见法术集成,底层镜头控制见镜头API。