ParticleLib

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