跳到正文

Kinesis Lib

作者:xaylis

为 Minecraft 模组提供的数据驱动型视觉特效引擎

收藏

截图

介绍

介绍由机器翻译自 CurseForge 原页面,仅供参考。

Kinesis

Documentation Java API

Forge 1.20.1 Shader support GeckoLib models Client and server No dependencies MIT licensed

What is Kinesis?

Kinesis 是一款 Minecraft 视觉特效引擎。模组、整合包和地图作者可以用它为游戏添加特效:从单个细胞开始再生的生物、被整齐切成两半的身体、撕裂地面的冲击波,或环绕玩家飞舞的十万粒粒子。

每种特效都是资源包中的一个 JSON 文件。你只需描述各个图层(模型材质、粒子云、光束、屏幕震动等)、它们的启停时机,以及数值随时间的变化方式。剩下的交给 Kinesis:它几乎不增加每帧的开销,所有效果都由显卡处理。你可以用一行 Java 代码播放特效,也可以从服务器通过 /kinesis play 或命令方块触发。

Kinesis 本身不会添加物品、方块或生物。如果你游玩的模组或整合包需要它,或是想自己制作特效,就安装它。模组还附带 18 种现成特效,可立即通过 /kinesis play 播放。

A zombie regrowing from a single cell

kinesis:regen:单个细胞分裂,血管沿着骨架生长,随后长出骨骼、肌肉和皮肤。

Cut, break and bend

Kinesis 会重新渲染任意实体自己的模型(原版生物、玩家、模组生物、GeckoLib 模型),因此它能对身体模型进行普通粒子模组做不到的处理。

Slicing a zombie in half Shattering a zombie
切割。沿任意平面切开实体。两半分离、倾倒并落下,切口也会被填补。 粉碎。冻结模型并将其打碎成最多 64 块碎片,让碎片飞散、翻滚并落地。
Melting a zombie A bulging arm
融化。模型会塌成不规则、不断滴落的水洼,同时保持动画效果。 鼓胀、膨胀与波动。让任意骨骼周围的肌肉弯曲、逐渐隆起,或在皮肤上掀起波浪。

所有效果都在顶点着色器中运行:将模型拆成 64 块与拆成 4 块,每帧的开销相同。

Features

  • 模型材质。让效果前沿从某个点、沿某条轴或沿骨架向外扫过模型。前沿经过后,分层表面会逐渐覆盖模型:血液、骨骼、肌肉、石头或实体自身的皮肤。反向播放即可让物体消散。你可以将姿势冻结成雕像、留下残影,或投射全息影像。
  • 粒子。支持随生命周期变化的数值、重力、阻力、风、涡流、吸引器、轨道和卷曲噪声。粒子可从点、球体、方块、圆环、圆锥、线条、模型表面(可继承模型颜色)或骨骼生成。粒子可以弹跳、附着、留下轨迹,也能触发其他特效。将粒子轨道切换到 GPU 模式,最多支持 262,144 个粒子。
  • 形状。轨迹与刀光弧线、分支状卷须、光束、反复劈落的闪电、圆环与冲击波、网格(球体、环面或自定义 OBJ 文件),以及投射到地面的贴花。
  • 材质。翻页纹理、渐变贴图、滚动、噪声、溶解、菲涅耳效果、柔和边缘、热浪、泛光,以及带次表面散射的摄影棚灯光。也可以接入自己的着色器。
  • 屏幕特效。镜头震动、闪光、色差分离、暗角、黑白漫画式冲击画面与速度线、去饱和和镜头扭曲;这些效果既可覆盖整个屏幕,也可限制在世界中的球体范围内。
  • 时间线。轨道会按设定时机启动和停止;数值可按带缓动的关键帧曲线或任意数学表达式变化;特效还可以播放声音、启动子特效,并触发代码可监听的事件。
  • 多人游戏。服务器启动特效后,所有能看到它的玩家都会看到相同的效果和随机结果。后来加入的玩家也能看到正在播放的特效。
Disintegrating Turning to stone
kinesis:disintegrate kinesis:petrify
Shockwave Lightning
kinesis:shockwave kinesis:lightning
Summoning circle GPU particle nebula
kinesis:summon_circle kinesis:nebula, 131,072 个 GPU 粒子

Built-in effects

Kinesis 附带了可直接播放的特效,也提供了示例文件,方便你了解文件格式:

regen · disintegrate · petrify · hologram · afterimage · aura · orb · shockwave · lightning · beam · summon_circle · impact · time_stop · nebula · slice · shatter · melt · flex

/kinesis play kinesis:shatter @e[type=zombie,limit=1,sort=nearest]
/kinesis play kinesis:shockwave at ~ ~ ~ color=#4ab8ff radius=10

For mod developers

特效文件位于 assets/<namespace>/kinesis/effects/:

{
  "duration": 3.5,
  "tracks": [
    {
      "type": "model",
      "hide_original": true,
      "shatter": { "pieces": 40, "force": 2.4, "lift": 2.2, "spin": 420, "gravity": 16 }
    },
    {
      "type": "particles",
      "end": 0.6,
      "emitter": { "burst": 120, "shape": { "type": "sphere", "radius": 0.5 } },
      "particle": { "lifetime": [0.4, 0.9], "speed": [1, 4], "direction": "outward" }
    }
  ]
}

无论在客户端还是服务器端,只需一行代码即可播放:

Kinesis.play("mymod:shatter", entity);

Kinesis.effect("mymod:fire_beam")
        .at(player, "right_arm:tip")
        .to(target)
        .color(0xFF6A00)
        .play();

文件格式附带 JSON schema,让你的编辑器能够自动补全并检查每个字段。特效文件中的错误会在聊天栏中显示文件名和出错字段,按下 F3+T 即可重新加载所有内容。

Tools for building effects

Kinesis 附带了制作精美特效所需的工具,让整个流程更快捷:

  • 保存即重载。在开发环境中,保存特效、纹理、模型或着色器后,修改会立即生效,无需重新构建,也不必按 F3+T。如果着色器出错,旧版本会继续运行,并提示出错文件和行号。
  • 冻结与跳转。 /kinesis seek 1.25可将所有特效精确跳转到指定时刻,每次结果都完全一致。
  • 胶片条。 /kinesis filmstrip从多个角度截取特效在指定时刻的画面,并保存为带标签的缩略图表,还可以附上概念美术图。
  • 参数扫描。 /kinesis sweep在一系列取值范围内逐个测试某个参数,并将每个取值的结果排列成一行,方便快速选出最佳效果。
  • 性能分析。 /kinesis profile测量每条轨道的 CPU 耗时、GPU 耗时和粒子数量。

A filmstrip contact sheet

Fast by default

Kinesis 的设计目标是让特效几乎不产生额外开销,无需任何设置:

  • 几何数据会直接传送到显卡,静态网格只需上传一次。
  • 屏幕外的内容会跳过处理。粒子轨道会并行模拟,大型粒子轨道则会自动转移到 GPU。
  • 只有画面中出现发光效果时才会运行泛光处理。
  • 模型的切割、粉碎和弯曲都由顶点着色器完成。

典型特效每帧耗时约三分之一毫秒。包含 131,072 个粒子的 GPU 星云特效耗时0.22 毫秒。

Compatibility

  • Oculus 和光影包。特效会在光影包完成当前帧渲染后绘制,因此使用任何光影包时看起来都一样。替换实体的模型副本会像实体本身一样受到光影包的照明和阴影效果影响。
  • GeckoLib。GeckoLib 模型中的骨骼和定位器可用作附着点,因此拖尾可以跟随动画中的刀刃移动。
  • 任何实体。模型特效会使用实体自身的渲染器、盔甲、手持物品,以及其他模组添加的图层。
  • 多人游戏。请在服务器和客户端都安装 Kinesis。
Afterimages Hologram
kinesis:afterimage kinesis:hologram

本页面上的所有片段都是在游戏中使用 Complementary Reimagined 光影包录制的。

Links

Documentation Java API

Kinesis 使用 MIT 许可证。你可以在任何模组或整合包中使用它。

常见问题

Kinesis Lib 支持哪些 Minecraft 版本?

Kinesis Lib 支持 Minecraft Java 版 1.20.1,可用的加载器:Forge。下载时注意选择和你游戏版本一致的文件。

Kinesis Lib 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 Forge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分