粒子动画库

粒子动画库

一个粒子动画库模组,可以超级轻松地创建酷炫的粒子效果!

particle_animation_library_header

你想创建诸如圆锥、立方体、球体和漩涡之类的酷炫粒子效果,却不知道怎么做?那么这个模组就是为你准备的! 它主要是一个开发者工具,但作为玩家,你也可以用命令来玩一玩,尤其是在用代码实现这些效果之前先试一试。它也是完全服务端运行的,意味着你不需要在客户端安装它。正如你可能猜到的那样,它受到 EffectLib 插件的启发。

目前可用的效果:

  • [3D] 动画球体、球体、长方体、漩涡、圆锥
  • [2D] 弧线、直线、动画圆、彩色和黑白图像

目前该模组处于 alpha 阶段,这意味着不同版本之间内容可能会变化或损坏,所以请注意这一点(不过我会尽量避免做这类改动)。此外,计划中的效果只有一小部分可用,文档暂时主要放在 javadoc 中,虽然我希望将来能做一个 wiki! 未来可能会推出 Forge/NeoForge 版本,但我想先把 Fabric/Quilt 版本推进到 beta 阶段,再开始移植!

nodecraft 体验这个模组的最佳方式是在服务器上和其他人一起玩,所以你可以在 Nodecraft 上使用优惠码 EMALIGHTDEV 来获得折扣!

如何创建效果?

所有效果都在 effects 包中,你只需创建一个新的效果对象,或者使用它们的 builder 方法(有点像 Block 属性),就可以创建新效果。

然后你可以使用你喜欢的 #run() 方法来激活效果:

//Constructor pseudocode with runFor example
Effect effect = new Effect(ServerWorld world, ParticleEffect effect, Vec3d originPos, int particles, Other stuff...)
effect.runFor(5);

//Builder pseudocode with run and setIterations example (20 ticks = 1 second) Effect effect = Effect.builder(ServerWorld world, ParticleEffect effect, Vec3d originPos).particles(10).anotherOption(true).build; effect.setIterations(5*20); effect.run();

注意:使用 builder 时,你总是需要向方法提供 world、particle effect 和 origin pos,因为每个动画效果都会用到它们,并且假定它们不为 null。如果需要,你可以之后再更改它们。 TLDR; 你必须提供它们,才能让效果正常工作而不是崩溃!

<center>

<p align="center"> <img src="https://github.com/Emafire003/ParticleAnimationLib/assets/29462910/f3614984-c6c8-4fd1-ac5b-0ed9adef732a" alt="Demo of some of the effects from version 0.0.1" /> </p>

</center>

0.0.1 版本部分效果演示

如何操作动画效果?

每个效果都有自己的 getter 和 setter,因此你可以在调用 run 方法之前用它们更改设置。你还可以向 run/runFor 方法提供一个 lambda,它会在效果处于活动状态的每个 tick 执行。关于每个设置的作用的更多信息,请参阅该效果构造函数的 javadoc。

我如何使用这些命令?

你可以使用 pal 或 particleanimationlib,然后用 Tab 补全来创建你的效果。除了参数名称之外,它们基本没有文档,所以我建议你去查看效果的对应类,从 javadoc 中了解每项内容的作用。抱歉 :P

注意:那些接受旋转之类内容的命令,会把整数值改成“x.5”,因为游戏认为它们是位置。你可以通过输入 double 而不是整数来绕过这个问题,比如“x.0”(例如 2.0 或 0.0)

面向开发者:

将此库作为依赖项添加到你的 build.gradle 中

repositories {
    maven {
        name = "Modrinth"
        url = "https://api.modrinth.com/maven"
        content {
            includeGroup "maven.modrinth"
        }
    }
}

dependencies { modImplementation "maven.modrinth:particleanimationlib:&lt;version&gt;" }

你可以在 Modrinth 的版本页面获取版本号。

致谢

本模组基于 elBukkit 团队制作的 Bukkit 插件 EffectLib,也请去看看它!效果取自那里,并经过调整以兼容模组开发,偶尔还会添加额外功能。

许可证

本库以 MIT 许可证提供