ParticleAnimationLib
Have you ever watched a Minecraft server and thought the atmosphere could use a little more magic? Perhaps a swirling vortex at a spawn point, a shimmering sphere around a legendary item, or a cone of light beaming down from the sky. For most players, creating these effects seems like a complex puzzle reserved for seasoned developers. That is where ParticleAnimationLib steps in, offering a powerful yet accessible toolkit for both creators and players to bring their worlds to life with dynamic particle animations.
This library is a developer's utility at its core, but its beauty lies in its accessibility. Even if you have never written a line of code, you can jump into the game and use the built-in commands to experiment with a variety of stunning effects. It is the perfect sandbox for testing visuals before you ever decide to implement them into a mod or datapack. The mod is entirely server-side, meaning your friends and other players on your server do not need to install anything on their clients to see the magic happen.
What Can You Create with ParticleAnimationLib?
Inspired by the popular EffectLib plugin for Bukkit, ParticleAnimationLib for Minecraft brings a host of pre-built animation shapes to the Fabric and Quilt modding ecosystem. The current alpha stage offers a fantastic range of effects, including:
- 3D Effects: Animated Sphere, Sphere, Cuboid, Vortex, and Cone.
- 2D Effects: Arc, Line, Animated Circle, and even Colored and Black & White Images.
These shapes are not just static; they are fully animatable. You can control the density of particles, the rotation, the speed of the animation, and much more. Whether you want a slow, menacing vortex or a rapid, flickering circle, the control is in your hands. The mod is currently in its alpha stage, so you can expect changes and new features as the developer works towards a stable release. While the documentation is currently focused on javadocs for developers, the command system provides enough in-game feedback to start experimenting right away.
For Players: The Command Interface
You don't need to be a developer to have fun with this mod. Once installed on your server, you can use the /pal or /particleanimationlib command. The command features full tab-completion, guiding you through the arguments needed to build your effect. While the in-game documentation is sparse, you can easily look at the names of the arguments to guess their function. A helpful tip from the developer: when the command asks for rotations or positions, input a double value like "2.0" or "0.5" instead of a whole number to ensure the game treats it correctly as a coordinate.
For those looking to get started quickly, the foxygame.net launcher offers a one-click install for ParticleAnimationLib, bundling it with the correct game version and dependencies so you can skip the manual setup and jump straight into your creative testing.
For Developers: A Simple API
If you are a mod developer, integrating ParticleAnimationLib into your project is straightforward. You can add it as a dependency in your build.gradle file using the Modrinth maven repository. The API is designed to be intuitive, following patterns familiar to Minecraft modding. You can create a new effect object or use a builder method, similar to how Block properties are set up.
Here is a quick look at the code structure to give you an idea:
// Using the builder pattern
Effect effect = Effect.builder(world, particleEffect, originPos)
.particles(10)
.anotherOption(true)
.build();
effect.setIterations(5 * 20); // 5 seconds
effect.run();Every effect has its own getters and setters, allowing you to tweak the settings before calling the run method. You can also provide a lambda function to the run() or runFor() methods to execute custom logic every tick the effect is active. The library is based on the MIT license, giving you the freedom to use it in your projects.
How to Install ParticleAnimationLib
Installing the mod is a simple process. Since it is a server-side mod, you only need to place the jar file into the mods folder of your Minecraft server. It is compatible with the latest Fabric and Quilt loaders for recent Minecraft versions. To ensure you get the correct build, always check the version compatibility on the Modrinth page before downloading. The process is the same for both a single-player world opened to LAN and a dedicated server.
For a seamless experience, the foxygame.net launcher automatically handles version compatibility for ParticleAnimationLib, checking for the correct Minecraft version and loader, and even offering auto-updates so you never miss a new effect or bug fix.
How to Download ParticleAnimationLib
Ready to add some visual flair to your server? You can easily download ParticleAnimationLib from the official Modrinth page. The page provides all the necessary version files, a changelog, and links to the source code. Just remember to select the file that matches your server's Minecraft version and mod loader. As the mod is in alpha, it is wise to back up your world before experimenting, but the developer assures that they are working to minimize breaking changes between versions.
This library is a fantastic bridge between the creative vision of server owners and the technical reality of particle effects. Whether you are a developer looking to add a unique visual identity to your mod or a server admin wanting to create a memorable spawn area, ParticleAnimationLib provides the tools to make it happen. With its simple command interface for players and a clean API for developers, it democratizes the creation of complex particle animations. So dive in, experiment with the commands, and see what kind of breathtaking visuals you can conjure up for your Minecraft world. The only limit is your imagination.