ParticleLib — Advanced Shape-Based Particle API for Bukkit/Spigot
ParticleLib is a lightweight, developer-friendly particle utility library for Bukkit / Spigot / Paper plugins. It lets you render complex geometric particle shapes with just a few lines of code — no math headaches, no repeated boilerplate.
From circles and stars to DNA helixes, spheres, cuboids, bursts, and Bézier curves, ParticleLib is built for devs who want clean visuals fast.
Features
• Chainable & intuitive API • Supports DUST particles with color • Built-in rotation system (X / Y / Z) • Tons of ready-made shapes • Zero dependencies beyond Bukkit • Perfect for abilities, spells, cosmetics, bosses, and animations
Included Shapes
Stars (configurable points)
Circles & Ellipses
Squares & Rectangles
Lines & Curved (Bezier) lines
Particle bursts
DNA Helix (with strand connectors)
Spheres
Cuboid outlines
Installation
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>
Basic Usage 1️⃣ Create a ParticleShape
ParticleShape shape = new ParticleShape(player.getLocation())
.setParticle(Particle.DUST)
.setColor(Color.AQUA)
.setSize(2.5)
; 2️⃣ Display a Shape
Circle
shape.displayCircle(100);
Star
shape.displayStar(5, 20);
Sphere
shape.displaySphere(400);
DNA Helix
shape.displayDNAHelix(4.0, 120);
🔄 Rotation Support
All shapes support 3D rotation (radians):
shape.setRotation(
Math.toRadians(45), // X
Math.toRadians(0), // Y
Math.toRadians(30) // Z
);
Rotation is applied before spawning each particle, making it perfect for spinning or tilted effects.
Advanced Example (Spell Effect)
new ParticleShape(player.getLocation())
.setParticle(Particle.DUST)
.setColor(Color.PURPLE)
.setSize(3)
.setRotation(0, Math.toRadians(90), 0)
.displayStar(6, 25);
If you’ve ever written 100 lines of trigonometry just to draw a circle — this library is for you.
Notes
• Rotation values are in radians • DUST particles use Particle.DustOptions • Shapes are centered on the provided Location
