Modrinth · Fabric, Forge, NeoForge · Client mod

AsyncParticles

AsyncParticles is a client-side mod. Install it on your computer; the server does not need it.

Async particle tick, GPU accelerated particle rendering.

Downloads
9.5M
Author
Harvey_Husky
Loader
Fabric, Forge, NeoForge
Minecraft
1.20.1 – 26.3
Updated
–

Setup

Install AsyncParticles on your client

Client-side mods only run on your computer. More server RAM does not change their performance.

  1. 01

    Install the loader locally

    Install Fabric or Forge or NeoForge for your Minecraft version in your launcher.

  2. 02

    Download the file

    Download the AsyncParticles file for your loader and your exact Minecraft version, for example 26.3-snapshot-7.

  3. 03

    Add it to the mods folder

    Put the .jar file in your local .minecraft/mods folder and remove older duplicates.

  4. 04

    Launch

    Launch Minecraft with the loader profile. Nothing needs to change on the server.

On the server
Not needed
On the client
Required
Loader
Fabric, Forge, NeoForge
Minecraft
26.3-snapshot-7, 26.3-rc-3, 26.3 +15 more
License
GNU Lesser General Public License v3.0 only

Releases

Published releases

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

AsyncParticles · Modrinth
Original description by the project author

AsyncParticles

  • It will remain in the beta stage in the future to alert potential mod conflict issues.
  • Now compatible with Particle Core(v20.1+).
  • Now compatible with Valkyrien Skies v2.4.

Core Features

GPU Acceleration
  • Offloading partricle vertex transformations to the GPU reduces per-frame data uploads to the GPU, lowers CPU load, and improves frame rates.
  • This essentially replaces the previous async partricle vertex extraction while also improving compatibility (async partricle extraction is now disabled by default).
  • Fill 1331 campfires (16,000+ particles, you can change the limit via config screen):
    Tested on: Ultra5 225H + RTX 5060 Laptop, 1080p.
    Frame rate with 1331 campfires(16,000+ particles).
Create Integrations
  • Create contraptions can now block vanilla weather.(v20.1.0a+)
    • Will move this to a new mod when I get free time.
  • Particles can now collide with contraptions.
    A Create contraption blocking vanilla weather.

Other Features

  • Flexible mixin options.
  • Minecraft
    • Particle culling.
    • Async particle tick.
    • Async particle light cache.
    • Delayed texture tick by one frame to reduce client tick duration.

Configuration

Settings can be accessed via the ModList/ModMenu.

Troubleshooting

  • We've introduced Diagnostics, not applying the recommended settings usually won't cause a crash, you'll get a prompt in the chat bar to change them.
Use with Bosses Rise
  • Enable GPU Only Async Particle Tick.
Use with BadOptimizations
  • Set enable_particle_manager_optimization: false in badoptimizations.txt
  • Fixed since 20.1.1.0/21.1.1.0.
Crash with C2ME
  • Set enforceSafeWorldRandomAccess = "false" in c2me.toml
    • Only set this if you are experiencing crashes.
Crash with LodestoneLib
  • Set buffer_particles = false in lodestone-client.toml.
Crashes related to ClassInstanceMultiMap or Level.getEntities(...)
  • Please share the logs or crash report on the GitHub issue.
  • As a workaround, enable the option:
    Mixin → Make 'ClassInstanceMultiMap' Thread-Safe
Crashes related to Level.getBlockEntity(...)
  • Please share the logs or crash report on the GitHub issue.
  • As a workaround, enable the option:
    Mixin → Make 'LevelChunk#blockEntities' Thread-Safe
ConcurrentModificationException
The Most Common Cause

This exception typically occurs when particle rendering and ticking concurrently access the same thread-unsafe container.

How to Fix

Note: This enables fine-grained locking for specific particle types, allowing safe asynchronous execution between the tick() and render() methods.

Other Potential Causes

Starting in vX.4.0, the default particle rendering mode has been changed to SYNCHRONOUSLY to prevent rare ConcurrentModificationExceptions when used with mods that access external thread-unsafe containers (e.g., global maps or lists) during particle rendering.

  • If you're using an older version (≤ vX.3.0), consider manually setting the mode to SYNCHRONOUSLY in the config screen for improved stability.
  • For modpack authors: If you’d like to test whether FASTEST provides a noticeable FPS boost in your setup, you can switch to it in the config screen—but use with caution, as it may trigger crashes with incompatible mods.
Need Help?

If you’re unsure how to identify or fix the issue, please open a GitHub Issue or start a Discussion.

Mods Recommended

  • ModernFix
  • Sodium/Embeddium
  • Flerovium
  • Startlight/ScalableLux

Mod Compatability

âś… Compatible (Proactively)
  • Sodium/Embeddium
  • Flerovium
  • Iris/Oculus
  • Create
  • Create: Aeronautics
  • Valkyrien Skies
  • Particle Rain
  • Particle Core
  • ...
❌ Incompatible
  • OptiFine
  • MadParticle

Credits

FAQ

AsyncParticles questions

Question not listed? Ask our team.

Does AsyncParticles need to be installed on the Minecraft server?

No. Modrinth marks AsyncParticles as unsupported on the server side. Install it only in your local mods folder. Your server can stay unchanged unless the project page lists an additional dependency.

Which version and loader does AsyncParticles require?

Use a file for Fabric, Forge, NeoForge and your exact Minecraft version. Supported versions include 26.3-snapshot-7, 26.3-rc-3, 26.3. Files for different loaders are not interchangeable.

AsyncParticles is not working – what should I check?

First check the Minecraft version, loader version and required dependencies. Because the mod is client-side, more server RAM will not fix it.

Looking for mods for your own server?

The catalog lists mods that run on Minecraft servers.

Browse all mods