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