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 为中心
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
使床在所有维度中爆炸的模组
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧