Bukkit

// get API from plugin instance
ParticleNativeAPI api = ParticleNativePlugin.getAPI();

// ... or generate it using core module ("this" is Your plugin instance)
particleApi = ParticleNativeCore.loadAPI(this);

Player player = ...;
Location loc = player.getLocation();

// as simple as that
particleApi.LIST_1_8.FLAME  // from desired list get particle
        .packet(true, loc)  // make particle packet
        .sendTo(player);    // send it to certain player(s)

I've made test on localhost to measure execution time of 400 000 particles in random locations around my character.

Notable environment:

• localhost server MC 1.17
• JDK 17
• Intel i5-12600
• 32 GB RAM DDR4

All tests were made after an extensive warmup of executing them several times to allow JVM to optimize frequently used code.

However, it is still simple benchmark (not JMH or something), so results should be taken with a little pinch of salt.

All code used to test is found on my repository here.

Tests consist of 4 methods to send particle:

• nms - uses directly NMS and OBC to send packet,
• particle_native_api - uses this api to send particle with simple method,
• spigot_api - uses Spigot API's spawnParticle method (to player) to send effect,
• reflection - uses NMS and OBC reflected classes (with accessibility set to true) to send particle. Those classes/methods/fields are cached for multiple use.

As you can see, at least on my machine, ParticleNativeAPI is comparable to Spigot API and very close in speed to version specific implementation.

public class PluginName extends JavaPlugin {

    // loaded particle API
    private ParticleNativeAPI particleApi;
 
    @Override
    public void onEnable() {
        // load API and store it for later use
        particleApi = ParticleNativeCore.loadAPI(this);

        // or get it from running plugin api instance
        // check if everything is fine with it
      
        // if (ParticelNativePlugin.isValid()) {
        //     particleApi = ParticleNativePlugin.getAPI();
        // }
        // else {
        //     getLogger().log(Level.SEVERE, "Error occurred while loading dependency.");
        //     this.setEnabled(false);
        //     return;
        // }
    }
 
    // example usage
    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (!command.getName().equalsIgnoreCase("somecmd")) return true;
 
        if (!(sender instanceof Player)) {
            sender.sendMessage(ChatColor.RED + "You must be player to use this command!");
            return true;
        }
 
        Player pSender = (Player) sender;
        Location loc = pSender.getLocation();
 
        // particle spawning
        particleApi.LIST_1_8.FLAME             // select particle from list
                .packet(true, loc)             // create particle packet
                .sendInRadiusTo(player, 30D);  // send it to player if in 30 block radius
 
        return true;
    }
}

   <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-shade-plugin</artifactId>
                <version>3.2.0</version>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>shade</goal>
                        </goals>

                        <configuration>
                            <!-- replace shaded version with main artifact -->
                            <shadedArtifactAttached>false</shadedArtifactAttached>

                            <!-- relocate API classes to avoid same-classpath-conflicts -->
                            <!-- with other plugins using this core API -->
                            <relocations>
                                <relocation>
                                    <pattern>com.github.fierioziy.particlenativeapi</pattern>
                                    <shadedPattern>me.yourpluginpackage.particleapi</shadedPattern>
                                </relocation>
                            </relocations>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
          
            <!--  other plugins ... -->
        </plugins>
      
        <!-- other build config ... -->
    </build>
    <dependencies>
        <dependency>
            <groupId>com.github.fierioziy.particlenativeapi</groupId>
            <artifactId>ParticleNativeAPI-core</artifactId>
            <version>4.1.0</version>
            <scope>compile</scope>
        </dependency>

        <!-- other dependencies -->
    </dependencies>

    <dependencies>
        <dependency>
            <groupId>com.github.fierioziy.particlenativeapi</groupId>
            <artifactId>ParticleNativeAPI-plugin</artifactId>
            <version>4.1.0</version>
            <scope>provided</scope>
        </dependency>

        <!-- other dependencies -->
    </dependencies>