VoxelFX

VoxelFX

通过关键帧、缓动函数等方式，为客户端侧的方块和物品显示实体添加动画效果！
制作如此炫酷的视觉效果（VFX）：

功能特性

动画方块与物品显示

可分别或同时对方块和物品显示实体进行动画处理。

查看演示

关键帧与缓动函数

使用带缓动函数的关键帧，为你想要的任何运动制作超级流畅的动画。访问 easings.net 可视化缓动效果，或在游戏中亲自测试。

查看演示

覆盖层

为任意方块（包括讲台等异形形状）叠加任意颜色。强度控制叠加的不透明度，且覆盖层支持与其他属性一样的关键帧。
不支持物品。

查看演示

动画队列与继承

将动画排入队列依次播放，或立即覆盖当前动画。动画可继承先前播放动画的属性，以减少样板代码。

查看演示

循环与回调

将动画循环播放固定次数或无限循环。利用回调在动画生命周期的任意节点触发逻辑。

查看演示

逐帧修改器

在关键帧值的基础上应用自定义逐帧修改器，用于实现摇晃、摆动或脉冲等难以仅用关键帧表达的动画效果。
注意：这些修改器应使用上下文的 interpolatedTicks 进行缩放，以确保所有效果与任何帧率保持一致。

查看演示

实体绑定

将动画绑定到实体上，并跟随实体移动，可设置可选偏移量。操作既可在全局空间也可在局部空间中进行。
上述 Nova Bomb 视频中已有展示。

构建器 API

一个流式构建器，让你以声明方式构建动画，通过链式调用平移、缩放、旋转、覆盖层、方块/物品通道，最大限度减少样板代码。

限制

需要 NeoForge 26.1.2 或更高版本。
本模组仅适用于客户端，意味着所有动画效果都需要通过你自己的代码触发。例如，从服务器向客户端发送数据包，指示客户端播放动画。
动画被设计为纯视觉效果——请勿尝试使用它们改变游戏状态。

此外，由于模组仅限客户端，显示实体本身不支持保存到世界或持久化动画。你需要自行编写相应系统。

一般用法：

VoxelFX 有一些可通过 /voxelfx 运行的命令。最值得注意的是，demo 命令可用于运行内置的演示动画。
另一个重要命令是 clear，它将清除实体缓存，移除所有 VFX 实体，用于处理意外情况。
你还可以暂停、恢复、停止或设置所有 VFX 实体的播放速度。
这不是全局状态——它仅作用于命令运行时存在的实体。

文档

请参阅 GitHub 维基。