ParticleNativeAPI [1.7+]

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

Wszystkie kody użyte do testów znajdują się w moim repozytorium tutaj.

Testy składają się z 4 metod wysyłania cząstek:

• nms - używa bezpośrednio NMS i OBC do wysyłania pakietu,
• particle_native_api - używa tego API do wysyłania cząstek prostą metodą,
• spigot_api - używa metody spawnParticle API Spigot (dla gracza) do wysyłania efektu,
• reflection - używa klas uzyskanych za pomocą refleksji (z dostępnością ustawioną na true) do wysyłania cząstek. Te klasy/metody/pola są buforowane do wielokrotnego użycia.

Jak widać, przynajmniej na moim komputerze, ParticleNativeAPI jest porównywalny do Spigot API i bardzo zbliżony pod względem szybkości do implementacji zależnej od wersji.

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.2.0</version>
            <scope>compile</scope>
        </dependency>

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

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

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