地形冲击
地面裂纹、掀起的板块、翻滚碎块与按法术范围缩放的镜头震动。
TerrainImpactAPI由服务端确定地面接触点,再由客户端绘制地形破碎效果。大型冲击同时呈现倾斜板块、裂纹条带和飞散碎块;是否永久破坏方块由服务端单独控制。
它做什么
门面位于net.kzeroko.isekaiexpansion.api。emit接收服务端世界、Area、Profile与可为空的施法者;shake根据爆炸半径调整震动的传播范围与强度,再交给ImpactShakeAPI处理。
天坠在每层推进的伤害环上使用SOUL_WAVE,半径为24格,10层波面在25刻(1.25秒)内向外推进。寰宇崩毁在延迟引爆时使用CATACLYSM,后续脉冲使用AFTERSHOCK;命中屏障时不产生地形效果。两者都根据半径调整镜头震动。普通投射物溅射与寰宇露滴使用IMPACT。
| 预设 | 表面采样数 | 碎块尺寸 | 冲量 | 板块抬升 | 存续时间 | 波面延迟 | 可破坏方块 |
|---|---|---|---|---|---|---|---|
IMPACT | 24 | 0.45格 | ×0.7 | 0格 | 42刻(2.1秒) | 0刻(0秒) | false |
CATACLYSM | 96 | 0.85格 | ×1.35 | 1.2格 | 90刻(4.5秒) | 10刻(0.5秒) | true |
SOUL_WAVE | 40 | 0.65格 | ×1.1 | 0.95格 | 80刻(4秒) | 0刻(0秒) | true |
AFTERSHOCK | 32 | 0.5格 | ×0.8 | 0.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。
| 字段 | 类型 | 默认值 | 作用 |
|---|---|---|---|
samples | integer | 必填 | 表面接触点上限,1–96。 |
fragmentSize | number | 必填 | 碎块边长上限,0.1–1.5格。 |
impulse | number | 必填 | 速度倍率,大于0且不超过3。 |
plateLift | number | 必填 | 板块的标称抬升量,0–3格;零表示不生成板块。 |
lifetimeTicks | integer | 必填 | 标称存续时间,20–120刻(1–6秒);各效果会略微缩短。 |
waveTicks | integer | 必填 | 随半径增加的启动延迟,0–30刻(0–1.5秒)。 |
breaksTerrain | boolean | 必填 | 其余服务端检查也通过时,允许永久移除方块。 |
spellTerrainDestruction | boolean | false | config/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约束。确认天坠的推进波面与寰宇崩毁的延迟引爆符合伤害时序。这些是验收步骤,不是已经完成的视觉测试记录。