ParticleNativeAPI [1.7+] icon

ParticleNativeAPI [1.7+] -----

A fast cross-version particle API for Spigot and Bukkit server.




Version 4.4.0 comes with:
  • update for MC 1.21.3 and 1.21.4
  • added 2 new particles
Spigot started to mark some particles as @Experimental due to possible significant changes in their implementation that might affect API. I will hesitate to add such particles unless they become stable, because those particles really changes internally in inconvenient way.
----------, Dec 22, 2024

Version 4.3.0 comes with:
  • fixes for PaperMC 1.20.6
  • added transparency param for ParticleTypeColor
----------, May 28, 2024

Version 4.2.0 comes with:
  • update for 1.20.6
  • added new particles
  • since 1.20.6: changed behavior of ENTITY_EFFECT (marked as not present in 1.8 and 1.13 lists)
  • since 1.20.6: removed AMBIENT_ENTITY_EFFECT (marked as not present in particle lists)
----------, May 13, 2024

Version 4.1.0 comes with few changes:
  • updated for Spigot 1.20.2
  • added 2 new particles: CHERRY_LEAVES and EGG_CRACK
----------, Oct 15, 2023

Version 4.0.0 comes with HEAVILY refactored API:
  • basically changed how particles are now accessed and being sent (check how-to-use doc for more info)
  • many, many API changes
Because of so many changes, I suggest looking into migration-v3-to-v4 doc to get around how to adapt to new API.

I may support 3.x.x versions for a while, but only for limited time (few months I think at most).
----------, Dec 29, 2022

Version 3.3.2 comes with support for MC 1.19.3
Current branch for 3.x.x is master-v3 on github
----------, Dec 28, 2022

Version 3.3.1 comes with few internal non-API changes:
  • reorganized most of code to make running unit tests in a more sophisticated way
----------, Jul 3, 2022

Version 3.3.0 comes with few changes:
  • updated for MC 1.19
  • added 5 new particles
  • added 2 new particle types
  • some internal non-API changes
----------, Jun 19, 2022

Version 3.2.1 comes with small changes:
  • fixed detecting synthetic methods on name inferrence
  • bumped compile target from 1.7 to 1.8 (well, it's high time)
----------, May 10, 2022

Version 3.2.0 comes with few changes:
  • updated for MC 1.18
  • added BLOCK_MARKER particle
  • BARRIER & LIGHT were removed in MC 1.18, but maintained forward compatibility using BLOCK_MARKER
  • some internal non-API changes
----------, Dec 26, 2021

Version 3.1.0 comes with few new features and internal (non-API) changes:
  • added new particles from MC 1.17
  • added new particle types: ParticleTypeDustColorTransition and ParticleTypeVibration
  • added new sendPacketIf variants of collection and location-radius related methods accepting PlayerPredicate, now packets can be send to selected players from player collections (or around location with radius) in a very efficient manner using lambdas! (API is still compatible with Java 7)
  • fixed presence of very small redundant local variable in ParticleTypeItem from MC 1.7
  • HUGE internal classes reorganization, internal ASM code is now much more readable and maintainable
----------, Jun 20, 2021

Version 3.0.0 comes with MANY changes:
  • refactored entire API into multi module project (api, core, plugin), by this, API can be used without runtime plugin dependency!
  • added MANY unit tests to make sure API works exactly like intended
  • fixed ParticleTypeNote near green color using unexpected xOffset
  • extended domain package from com.github.fierioziy to com.github.fierioziy.particlenativeapi to avoid class errors with my future plugins
For more informations, check updated README at plugins' github.
----------, Sep 4, 2020

Version 2.0.3 comes with improved packet method + ParticleTypeBlock 1.7 optimizations:
  • now packet method with doubles is being overridden instead of method with floats (a little bit faster)
  • ParticleTypeBlock in 1.7 is now a little bit faster due to removed one unnecessary check around meta parameter
  • overall reorganized code around packet method in particle types in all versions
----------, Jul 20, 2020

Version 2.0.2 comes with:
  • added 10 new particles from 1.16
  • ParticleTypeRedstone from Particles_1_8 will now work up to 1.16 (ParticleTypeDust is not backward compatible)
  • packet method from ParticleType that accepts floats is now deprecated and will be removed in a future
----------, Jun 26, 2020

Version 2.0.1 comes with few changes:
  • particles lists now can use sendPacket methods and should be used instead of ServerConnection
  • ServerConnection is deprecated now (will be removed in a future in terms of standalone object)
  • sendPacket methods that iterates over players are a little bit optimized
----------, Jun 16, 2020

Version 2.0.0 comes with moved all the code from package me.fierioziy.* to com.github.fierioziy.* to be synced with Github domain and Maven.
  • it will be probably last update prior to MC 1.16 release,
  • simply replace all me.fierioziy with com.github.fierioziy in the code.
----------, May 24, 2020

Version 1.3.1 comes with:
  • fixed META-INF for Maven deploy,
  • plugins that imported this API using Maven will now properly reference internal ASM classes (for any reason would you do it).
----------, May 23, 2020

Version 1.3.0 comes with some restructuring changes:
  • removed few useless packet method overloads and added more appropriate ones,
  • added support for Player collections in ServerConnection
  • some typo/javadocs changes.
----------, May 22, 2020

Version 1.2.0 comes with few fixes and huge rename changes:
  • documented code a little bit more
  • fixed ParticleTypeRedstone displaying wrong colors,
  • fixed invalid color check in ParticleTypeNote,
  • any ParticleType with "Dir" is renamed to ParticleType with "Motion" at the end,
  • all create[Dir/Colored/Note] methods renamed to packet[Motion/Colored/Note] (so at first glance you see it returns packet, duh),
  • ParticleNativeAPI's getInstance method renamed to getPlugin
----------, May 17, 2020

Version 1.1.1 comes with added compatibility with MC 1.15.
----------, May 11, 2020

Version 1.1.0.0 (small API changes) comes with:
  • new (fast!) method sendPacket in ServerConnection that allows to send packet to players in given radius around Location,
  • javadoc comments on ParticleType related class to give insight of their purpose,
  • ParticleTypeDust now returns ParticleType instead of ParticleTypeDir (dir parameters doesn't bother its motion).
----------, Mar 27, 2020

Resource Information
Author:
----------
Total Downloads: 2,547
First Release: Mar 25, 2020
Last Update: Dec 22, 2024
Category: ---------------
All-Time Rating:
5 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings