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