传送画面表现
每次玩家传送时伴随的以太汇聚、同维度瞬移和次元通道。
模组执行的每次玩家传送都可以提前通知客户端,客户端最多用三种屏幕着色器回应:仪式或入口蓄力时的汇聚,同一维度内约0.7秒的瞬移,以及跨维度时的次元通道。三者都只负责画面,不锁定输入,不选择目的地,也不决定能否传送。玩家规则见转移之石。
它做什么
汇聚。视野边缘沉入带有亮色流丝的色调光雾,符文在雾中浮现并向内飘移,集中线汇向画面中心。边缘会朝中心轻微扭转,中间区域保持清晰。蓄力达到75%后,光雾开始脉动,并向内推出光环。
瞬移。出发画面越过镜头向外冲散,中心同时撕开一个漩涡;随后实时的目的地画面带着折射边缘和散落的光屑,从漩涡中展开。
次元通道。出发画面从中心像被击中的水晶一样碎裂,碎片越过镜头飞散。其后是一条以太回廊:星云壁、能量丝、极光带、光流,以及围绕远方星光依次掠过的符文门。抵达时冲入那颗星,画面转为一片白光,再沿着闪烁的边缘从中心向外溶解。
三者都由同一个传送颜色照亮。CrossingPalette把最亮的通道提到1,将色度提高到×1.35,让浅色传送门也能发光;再把辅色绕灰轴转0.6弧度:绿、青、蓝转向紫色,黄、红、品红转向暖色。暗部取自固定的紫色夜空,不从主色派生,所以金色仍是金色。
运行时模型
服务端发送两个数据包。两者都只有当前一种格式,不保留旧格式解码。
| 数据包 | 数据,按顺序 | 发送时机 |
|---|---|---|
isekaiexpansion:teleport_gather | 刻数(varint)、颜色(int) | 以传送结束的仪式或蓄力开始时。 |
isekaiexpansion:teleport_crossing | 是否跨维度(boolean)、颜色(int)、抵达位置(方块坐标) | 目的地验证通过后、移动玩家之前。 |
目的地世界与玩家当前世界不同时,TeleportScreenCues.cross会标记为跨维度。当前的来源如下:
| 来源 | 汇聚 | 传送颜色 |
|---|---|---|
TeleportUtil.tryTeleport仪式路径,转移之石使用 | 22刻(1.1秒),即仪式的转移延迟 | 0xFF85CFFF |
TeleportUtil.tryTeleport即时路径 | 无 | 0xFF85CFFF |
PortalEntity:召唤传送门的成对传送门,以及召唤世界传送门连往世界之门的传送门 | 无 | 该传送门的颜色。 |
| 世界之门旅程 | 无 | 该世界之门设置的颜色。 |
| 地下城进入与返回 | 进入时由客户端入口探测驱动 | 难度对应的入口颜色,或返回用的金色0xFFFFD66B。 |
| 其他任何维度切换 | 无 | 0xFF18DFFF,由客户端的维度切换钩子启动。 |
汇聚
GatherController随游戏刻推进,刻与刻之间用当前帧的刻内进度插值,所以暂停时会冻结。每次汇聚的动画循环都从零开始,每480刻(24秒)无缝循环一次,所以满蓄力停留时也能干净地重复。聚焦线会随蓄力从0.6×加速到1.4×真实速度;它们的行进按刻累积,所以蓄力变化时不会跳动。减少动态效果时,两个时钟都以0.3×运行。两个驱动源中较大的一个决定蓄力值:
| 驱动源 | 上升 | 释放 |
|---|---|---|
| 定时通知 | 在通知的刻数内线性上升,刻数限制为1–100(0.05–5秒)。 | 没有等到传送时,满值保持10刻(0.5秒),之后每刻下降1/5。 |
| 地下城入口探测 | 玩家与入口重叠时,用38刻(1.9秒)充满。 | 离开后4刻(0.2秒)内消退;满蓄力后20刻(1秒)内没有等到传送时也会消退。 |
入口探测取入口1.5格内地下城传送门的颜色,找不到时用0xFF18DFFF。旁观者不会触发。玩家落在入口上时,只要还站在那里,服务端就会不断重置传送门冷却;因此切换世界后,探测会保持不亮,直到玩家离开所有入口满10刻(0.5秒)。进入被拒绝时,服务端不会每刻重试,而是同样重置这个冷却,所以玩家需要离开入口10刻(0.5秒)后入口才会重新蓄力;探测在满蓄力无人响应后消退,并按同一规则重新就绪。任何一次传送都会立即清除汇聚,出发画面已经保留了汇聚时的样子。
瞬移
收到瞬移传送时,BlinkController把游戏上一次呈现的画面复制进FrameSnapshot,界面也包括在内。它的PresentedClock从下一次呈现的帧开始计时,暂停期间不增加时间,单帧间隔超过50毫秒的部分也不计入。
| 阶段 | 时间 | 规则 |
|---|---|---|
| 撕开 | 0.32秒 | 出发画面随着展开的漩涡向外冲散。 |
| 等待 | 直到抵达,最多1.4秒 | 玩家站到抵达位置4格内、且该区段已绘制后才开始展开。 |
| 展开 | 0.5秒 | 最早在0.2秒时开始,目的地从中心打开。 |
因此目的地就绪时,一次瞬移持续0.7秒,最长1.9秒。瞬移结束时释放快照纹理。
次元通道
TravelPresentation自行截取出发画面,并在游戏画面之后合成,加载界面上也会显示。TravelTimeline与瞬移一样按呈现时间计时。
| 阶段 | 时间 | 规则 |
|---|---|---|
| 进入 | 1.6秒 | 碎裂与飞散;结束时释放出发画面纹理。 |
| 回廊 | 从2.1秒起,直到就绪 | 等玩家所在位置的区块绘制完成,或等待预算用完,才开始抵达。 |
| 抵达 | 1.8秒 | 光门打开、白光,然后光从中心溶解。 |
汇聚与瞬移是在界面之前绘制的Satin后处理效果。各自渲染到自己的swap目标,只把颜色复制回去,场景深度得以保留。两者都跳过Iris阴影阶段。断开连接时,会在客户端线程上释放它们的效果和快照。
约定
net.kzeroko.isekaiexpansion.api.fx.TeleportScreenAPI是服务端门面。颜色为打包的RGB,不使用透明度。
| 成员 | 作用 |
|---|---|
gather(ServerPlayerEntity player, int ticks, int color) | 提前ticks刻通知一次传送,限制在1–MAX_GATHER_TICKS。 |
cross(ServerPlayerEntity player, ServerWorld destination, Vec3d arrival, int color) | 通知传送本身,按目的地世界选择瞬移或次元通道。 |
STONE_COLOR | 0xFF85CFFF,转移之石仪式的颜色。 |
MAX_GATHER_TICKS | 100,汇聚通知的最长时间。 |
每次移动玩家只调用一次cross,并放在所有可能取消移动的检查之后。客户端会把它上一次呈现的画面当作出发画面,所以过早发送cross会显示过时的位置。
net.kzeroko.isekaiexpansion.api.client.FrontendAPI.beginTravel(int durationMs, int color)从客户端代码打开次元通道。它会转交客户端线程执行,等待预算限制为2000–30000毫秒。已经开始的通道保留原有颜色与时间轴;传送数据包使用30000。
FrontendAPI.reducedMotion()读取共用的客户端偏好。开启减少动态效果后,次元通道不会启动,加载时使用普通加载界面。汇聚和瞬移保留颜色与光效,但去掉所有位移,瞬移会变成柔和的径向交叉淡化。
瞬移的第一帧与出发画面一致,最后一帧原样返回实时画面。汇聚为零时场景不变,次元通道结束时完全透明。
扩展
新增的服务端传送在自身的移动前后调用门面:
TeleportScreenAPI.gather(player, chargeTicks, color);
// ...later, once the destination has been validated:
TeleportScreenAPI.cross(player, destinationWorld, arrival, color);
FabricDimensions.teleport(player, destinationWorld, new TeleportTarget(arrival, Vec3d.ZERO, player.getYaw(), player.getPitch()));
接触即传送的入口不调用gather。着色器位于assets/isekaiexpansion/shaders:次元通道是core/dimension_passage,另有program/teleport_warp、program/teleport_gather及对应的post定义。保持各端点不改变画面,所有高光都取自CrossingPalette.applyTo写入的Hue和Accent uniform。后处理动画要用Clock uniform驱动,不能用Time:原版PostEffectPass每次绘制都会用自己的锯齿波覆盖Time,它每20刻(1秒)回绕一次。循环效果从LoopClock取得Clock,并在旁边写入循环长度Loop;着色器里每个定时运动都必须在一个循环内走完整数周期。
验证
运行./gradlew.bat compileJava。在游戏内分别使用横屏、竖屏和超宽窗口,检查瞬移的首尾帧、零汇聚量和次元通道结束时的画面,确认特效使用本次穿越的颜色,边界帧不改变场景。
游戏内需要检查:同维度和跨维度的转移之石、区块加载较慢的远距离转移之石与世界之门、不同颜色的召唤传送门、地下城进入与返回、返回后站在入口上、各阶段中暂停、减少动态效果、断开连接和资源重载。分别开启与关闭Iris,确认瞬移期间界面保持清晰,场景深度保留。