Modrinth · Fabric, Forge, NeoForge, Quilt

ParticleAnimationLib on your Minecraft server

ParticleAnimationLib runs on Minecraft servers with Fabric or Forge or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

A particle animation library mod to create cool particle effects super easily!

Downloads
13.5K
Author
Emafire003
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
1.17 – 26.3
Updated
–

Screenshots

What ParticleAnimationLib looks like

All 10 images on Modrinth

Images: ParticleAnimationLib on Modrinth, published by the project team.

Setup

Install ParticleAnimationLib on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Fabric or Forge or NeoForge or Quilt and choose the matching Minecraft version, for example 26.3.

  3. 03

    Install the mod

    Search the mod browser for “ParticleAnimationLib” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    ParticleAnimationLib is not needed on the client. Players connect using the server address from the panel.

On the server
Required
On the client
Not needed
Loader
Fabric, Forge, NeoForge, Quilt
Minecraft
26.3, 26.2, 26.1.2 +31 more
License
MIT License

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

ParticleAnimationLib · Modrinth
Original description by the project author

particle_animation_library_header

Do you want to create cool particle effects such as cones, cubes, spheres, and vortices but don't know how? Well, then this mod is for you!
It is mainly a developer utility, but as a player you can play around with the commands, especially to try out the effects before implementing them with code. It is also fully serverside, meaning you won't need it on the client. It is inspirerd by the EffectLib plugin as you may have guessed.

Currently available effects:

  • [3D] Animated Sphere, Sphere, Cuboid, Vortex, Cone, Donut
  • [2D] Arc, Line, Animated Circle, Colored and BW Images, Text

At present time this mod is in beta, meaning that stuff could still break or change a bit. And some effects are still missing
A forge/neoforge version may come in the future, but I first want to get the fabric/quilt all done before starting the port. Sorry! (It most likely will work with Syntra connector for the time being)

nodecraft
The best way to enjoy this mod is with other people on a server, so you can use the code EMALIGHTDEV on Nodecraft for discount!

How to use this mod

This mod on its own, is only intended for developers. But don't worry, if you are a player and still want to try out all of the amazing effects (albeit with some limitations currently) you can do so by install ParticleAnimationLibCommands.

Yes, I know, the commands are a bit long and confusing, that's why I've also started working on a wiki, that you can find right here!

How to create the effects?

All of the effects are in the effects package and you can create a new effect simply by creating a new effect object or you can use their builder method, kinda like the Block properties.

Then you can use your preferred flavour of #run() method to activate the effect:

//Constructor pseudocode with runFor example
Effect effect = new Effect(ServerWorld world, ParticleEffect effect, Vec3d originPos, int particles, Other stuff...)
effect.runFor(5);

//Builder pseudocode with run and setIterations example (20 ticks = 1 second)
Effect effect = Effect.builder(ServerWorld world, ParticleEffect effect, Vec3d originPos).particles(10).anotherOption(true).build;
effect.setIterations(5*20);
effect.run();

Note: when using the builder you will need to always supply the world particle effect and origin pos to the method, beacuse every animation effect uses them and it is assumed they are not null. You can change them later if you need to.
TLDR; you are forced to supply them in order to make the effect work instead of crashing!

Demo of some of the effects from version 0.0.1

Demo of some of the effects from version 0.0.1

How to manipulate the animation effect?

Every effect has its own getters and setters, so you can use those to change the settings before calling the run method. You can also provide a lamda that will execute each tickt that the effect is active to the run/runFor method. For more information about what each setting does please refer to the javadoc of the constructor for that effect.

How do I use the commands?

First of all, you must install the companion mod ParticleAnimationLibCommands.
You can use either pal or particleanimationlib and then use tab-completition to create your effects. You can even have a preview of each effect by using /pal <effect> demo <particle> <pos>!

Please refer to the wiki for more information!

For developers:

Add this library into your build.gradle as a dependency

repositories {
    maven {
        name = "Modrinth"
        url = "https://api.modrinth.com/maven"
        content {
            includeGroup "maven.modrinth"
        }
    }
}

dependencies {
    modImplementation "maven.modrinth:particleanimationlib:<version>"
}

You can get the version number from the modrinth versions page.

Credit

This mod is based on the bukkit plugin EffectLib by elBukkit team, check it out too! The effects are taken from there and tweaked to be compatible with modding, occasionally adding extra functionality.

License

This library is available under MIT license

FAQ

ParticleAnimationLib questions

Question not listed? Ask our team.

ParticleAnimationLib server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Which loader does ParticleAnimationLib run on?

According to Modrinth, ParticleAnimationLib supports Fabric, Forge, NeoForge, Quilt for Minecraft 26.3, 26.2, 26.1.2. Forge and Fabric files are not interchangeable: pick one loader for the server and clients.

How much RAM does a server with ParticleAnimationLib need?

As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.

Ready for your server with ParticleAnimationLib?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server