ParticleLib

插件

· 作者 crrupt_mc

一个面向开发者的库

0 本站下载 0 关注 更新于 9 个月前

最新 1.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

ParticleLib — 适用于 Bukkit/Spigot 的高级基于形状的粒子 API

ParticleLib 是一个轻量级、对开发者友好的粒子工具库,适用于 Bukkit / Spigot / Paper 插件。 只需几行代码即可渲染复杂的几何粒子形状——无需头疼数学公式,也无需重复编写样板代码。

从圆形和星形到 DNA 螺旋、球体、长方体、爆炸效果以及贝塞尔曲线,ParticleLib 专为追求快速呈现精美视觉效果而开发。

功能特性

• 链式调用且直观的 API • 支持带颜色的 DUST(尘埃)粒子 • 内置旋转系统(X / Y / Z 轴) • 提供大量现成形状 • 除 Bukkit 外零依赖 • 完美适用于技能、法术、装饰、Boss 特效及动画

包含的形状

星形(可配置点数)

圆形与椭圆

正方形与矩形

直线与曲线(贝塞尔线)

粒子爆炸效果

DNA 螺旋(含链连接)

球体

长方体轮廓

安装

Maven

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>
<dependency>
    <groupId>com.github.sidsteree</groupId>
    <artifactId>ParticleLib</artifactId>
    <version>v1.0</version>
</dependency>

基本用法 1️⃣ 创建 ParticleShape

ParticleShape shape = new ParticleShape(player.getLocation())
        .setParticle(Particle.DUST)
        .setColor(Color.AQUA)
        .setSize(2.5)

; 2️⃣ 显示形状

Circle
shape.displayCircle(100);
Star
shape.displayStar(5, 20);
Sphere
shape.displaySphere(400);
DNA Helix
shape.displayDNAHelix(4.0, 120);

? 旋转支持

所有形状均支持 3D 旋转(弧度制):

shape.setRotation(
    Math.toRadians(45), // X
    Math.toRadians(0),  // Y
    Math.toRadians(30)  // Z
);

旋转会在生成每个粒子之前应用,非常适合实现旋转或倾斜效果。

高级示例(法术特效)

new ParticleShape(player.getLocation())
        .setParticle(Particle.DUST)
        .setColor(Color.PURPLE)
        .setSize(3)
        .setRotation(0, Math.toRadians(90), 0)
        .displayStar(6, 25);

如果你曾为了画一个圆圈而写了上百行的三角函数代码——那么这个库就是为你准备的。

注意事项

• 旋转值单位为弧度 • DUST 粒子使用 Particle.DustOptions • 形状以提供的 Location 为中心

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源