ParticleLib 1.6.2 | 1.17 and ParticleTasks

New Particles

• Dripping Dripstone Lava
• Dripping Dripstone Water
• Dust Color Transition
• Falling Dripstone Lava
• Falling Dripstone Water
• Falling Spore Blossom
• Glow
• Glow Squid ink
• Snowflake
• Spore Blossom Air
• Vibration
• Electric Spark
• Scrape
• Wax off
• Wax on
• Light

New Features

• PlayerConnection caching
• ParticleBuilder doesn't require location in the constructor
• Added ParticleBuilder#setOffset(int, int, int) and ParticleBuilder#setOffset(Vector)
• ParticleEffect#NMS_EFFECT and ParticleEffect#VALUES are now immutable
• Added ParticleEffect#getAvailable() which returns a list of all supported effects on the current server
• Added ParticleTasks which automatically cache and resend particle packets Wiki
• Added more dust options like size and color (Also color fade)
• Added vibration particle options

Javadoc

Latest Javadoc can be found here.

Installation

Maven

<dependencies>
    <dependency>
        <groupId>xyz.xenondevs</groupId>
        <artifactId>particle</artifactId>
        <version>1.6.2</version>
    </dependency>
</dependencies>

Gradle

dependencies {
    implementation 'xyz.xenondevs:particle:1.6.2'
}

If you're using Maven or Gradle I'd recommend shading the library into your plugin or using the newly added Library Loader.

If you're not using Maven, you can download the jar here.

ParticleLib 1.5.1 | 1.16 Update

New Features

• New Particles
  • Ash
  • Crimson Spore
  • Dripping Obsidian Tear
  • Falling Obsidian Tear
  • Flash (1.14 particle I didn't notice)
  • Langing Obsidian Tear
  • Soul
  • Soul Fire Flame
  • Warped Spore
  • White Ash
• 1.16 Support

Maven

On maven central, no external repos are required.

<dependencies>
    <dependency>
        <groupId>xyz.xenondevs</groupId>
        <artifactId>particle</artifactId>
        <version>1.5.1</version>
    </dependency>
</dependencies>

Info

If you choose not to use maven you will find a ParticleLib plugin and a headless version below.

If a plugin on your server depends on this library you should download the plugin and drag it into the plugins folder. If you are a developer you can download the headless version and add it as a library to your project. You can also extract the jar into you plugin. However if multiple plugins do this it won't work because bukkit can't load the same package twice.

ParticleLib 1.3 | 1.15 Update

New Features

• New Particles
  • Dripping Honey
  • Falling Honey
  • Falling Nectar
  • Landing Honey
• 1.15 Support

Info

Below you will find a ParticleLib plugin and a headless version.
If a plugin on your server depends on this library you should download the plugin and drag it into the plugins folder. If you are a developer you can download the headless version and add it as a library to your project. You can also extract the jar into you plugin. However if multiple plugins do this it won't work because bukkit can't load the same packages twice.

ParticleLib 1.2 | Random Update

New Features

• Random Color generation in RegularColor
• Random Color generation in NoteColor

Bugfixes

• Fixed NoteColor IDs not working properly

Info

Below you will find a ParticleLib plugin and a headless version.
If a plugin on your server depends on this library you should download the plugin and drag it into the plugins folder. If you are a developer you can download the headless version and add it as a library to your project. You can also extract the jar into you plugin. However if multiple plugins do this it won't work because bukkit can't load the same packages twice.

The Javadoc can be found here: http://xenondevs.xyz/particledoc/

1.1 Release

ParticleLib 1.1

If you want to extract the library into your jar after building use the Headless version. The Plugin file should be used, if you want to use this API on your own server and can add the library into the plugins folder.

Javadoc: http://xenondevs.xyz/particledoc/

ParticleLib 1.0

Full release of the first ParticleLib 1.0

JavaDoc: http://xenondevs.xyz/particledoc/