APEL

模组

· 作者 McBrincie212

Apel 全称为 Animative Particle Engine Library(动画粒子引擎库),用于实现复杂的粒子动画,且无需深入掌握线性代数。它为开发者提供了直观的接口和丰富的文档支持。

0 本站下载 0 关注 更新于 1 年前

需要前置:Fabric API

最新 mc1.21.8-0.1.5 · 1.21.8 · Fabric

一键开服(送7天)

本项目已于 2026 年 6 月 20 日归档。详情请参阅 GitHub README。

# 简要概述

APEL 全称为 Animative Particle Engine Library(动画粒子引擎库)。它的目标是通过集成一个强大的动画引擎,赋予开发者巨大的生产力提升,从而实现对复杂粒子动画的管理。因此,该库旨在提供:

# 为什么使用 APEL? 简单来说,APEL 允许你仅用极少量的代码就能完全实现这些动画:

APEL 的核心优势具体包括:

  • 易用性: 该库将组件简化为其最基本的根源。这提供了一个直观且易于使用的开发者接口,使得任何开发者都能轻松上手。
  • 灵活性: 另一个目标是使库尽可能灵活,同时不破坏其他目标因素。该库允许在不涉及额外语法糖的情况下组合复杂的场景。
  • 丰富的文档: 我们的团队致力于提供详细的文档,清楚地解释每个功能的工作原理。我们积极改进文档,您可以通过 JavaDocs 或 GitHub 中的 Markdown 文档阅读相关说明。
  • 高性能: 由于该库旨在用于创建错综复杂的粒子场景,因此经过高度优化,对性能非常友好。

## 安装

开发者

本节面向将 APEL 作为库使用的开发者。

  1. 在你的 gradle.properties 文件中,添加以下行:
    apel_version=0.1.5+1.21.8
    
  2. 在 build.gradle 中,找到顶层的 repositories 块,如果你尚未从 Modrinth 安装任何其他依赖模组,请添加以下行:
    repositories {
     // ...
       maven {
           url = "https://api.modrinth.com/maven"
       }
     }
    
  3. 同样在 build.gradle 中,在 dependencies 块下添加依赖项:
    dependencies {
       // ...
       modImplementation "maven.modrinth:apel:${project.apel_version}"
       // ...
    }
    
  4. 刷新 Gradle(在 IntelliJ IDEA 中,点击带有旋转子图标的 Gradle 图标)
  5. 尝试输入 Apel 并让 IDE 自动补全,或者导入 net.mcbrincie.apel.Apel。如果所有步骤都已完成,一切应按预期工作。

玩家

通过常规方式下载模组并将其放入你的 mods 文件夹中。

## APEL 使用示例 对于一个沿直线从一个点移动到另一个点、绕 Y 轴旋转,并通过在 3 条边到 30 条边之间动画循环的正方形多边形粒子,代码如下(这不是一个简单的入门示例,但展示了其可能性):

AtomicBoolean reverse = new AtomicBoolean(false);

ParticlePolygon polygon = ParticlePolygon.builder()
  .particleEffect(ParticleTypes.END_ROD)
  .sides(3)
  .scale(3.0f)
  .amount(100)
  .beforeDraw((data, obj) -> {
    if (data.getCurrentStep() <= 15) {
      return;
    }
    boolean isStepZero = data.getCurrentStep() % 15 == 0;
    int sides = ApelUtils.getValueFromEasingCurve(obj.getSides());
    if (isStepZero && !reverse.get()) {
      obj.setSides(sides + 1);
      if (sides >= 30) {
        reverse.set(true);
      }
    } else if (isStepZero && reverse.get()) {
        obj.setSides(sides - 1);
        if (sides == 4) {
          reverse.set(false);
        }
    }
    Vector3f newRot = ApelUtils.getValueFromEasingCurve(obj.getRotation()).add(0, 0.002f, 0);
    obj.setRotation(newRot);
})
  .build();
        
LinearAnimator linearAnimator = LinearAnimator.builder()
  .endpoint(new Vector3f())
  .endpoint(new Vector3f(10, 0, 0))
  .particleObject(polygon)
  .delay(1)
  .stepsForAllSegments(1000)
  .build();

ApelServerRenderer renderer = ApelServerRenderer.client((ServerWorld) world);
linearAnimator.beginAnimation(renderer);

我们定义了粒子对象 (ParticlePolygon),指定了要使用的粒子效果、多边形的边数、多边形的大小以及要在多边形上使用的粒子数量。

之后,我们利用库在每一帧渲染之前修改对象的能力。这是通过一个接收某些上下文和要渲染对象的 lambda 函数实现的。此示例通过检查动画处于哪个步骤,来确定多边形应有的边数,从而修改多边形的边数。它还展示了如何增加旋转角度(以每个轴的欧拉角表示),在这种情况下,是在每个刻度的 Y 轴上进行轻微旋转。

注意:我们使用 ApelUtils.getValueFromEasingCurve 提取旋转和边数的值,在我们的案例中,我们知道这不是空值,所以可以完美运行。

然后,我们创建一个线性路径动画器,并提供帧之间的延迟(以刻度为单位)、直线的起始位置、直线的结束位置、要使用的粒子对象以及动画的渲染步骤数。

最后,我们播放线性路径动画器,并为服务器端渲染提供一个渲染器实例。

注意

根据开发者是否选择使用 Apel 的客户端渲染器(它比服务器端渲染器更优化粒子,但需要人们安装客户端模组),可能需要客户端安装该模组。如果他们不选择客户端渲染器,则无需客户端模组。

## 链接 / 社交媒体

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源