# AsyncParticles<\/p>\n
– It will remain in the beta stage in the future to alert potential mod conflict issues.
\n – Not yet compatible with Particle Core.
\n– The compatibility for Valkyrien Skies v2.4 is still in progress.
\n– Now support for GPU acceleration.(v21.1.0a+)
\nFill 1331 campfires (16,000+ particles, you can change the limit via config screen):
\nTested on: Ultra5 225H + RTX 5060 Laptop.
\n
\n– Create contraptions can now block vanilla weather.(v21.1.0a+)
\n
\n## Configuration
\n### Settings can be accessed via the ModList\/ModMenu.<\/p>\n
## Troubleshooting<\/p>\n
### Use with C2ME
\n– Set `enforceSafeWorldRandomAccess = “false”`<\/p>\n
### Crash with LodestoneLib
\n– Set `buffer_particles = false` in `lodestone-client.toml`.<\/p>\n
### Crashes related to `ClassInstanceMultiMap` or `Level.getEntities(…)`
\n– Please share the logs or crash report on the GitHub issue.
\n– As a workaround, enable the option:
\n `Mixin` \u2192 `Make ‘ClassInstanceMultiMap’ Thread-Safe`<\/p>\n
### Crashes related to `Level.getBlockEntity(…)`
\n– Please share the logs or crash report on the GitHub issue.
\n– As a workaround, enable the option:
\n `Mixin` \u2192 `Make ‘LevelChunk#blockEntities’ Thread-Safe`<\/p>\n
### ConcurrentModificationException<\/p>\n
#### The Most Common Cause
\nThis exception typically occurs when particle rendering and ticking concurrently access the same **thread-unsafe container**.<\/p>\n
#### How to Fix
\n– Add the fully qualified particle class names to both `particle$lockProvider` and `particle$lockRequired` in the mod’s Mixin settings.
\n See the configuration guide for details<\/p>\n
> **Note**: This enables fine-grained locking for specific particle types, allowing safe asynchronous execution between the `tick()` and `render()` methods.<\/p>\n
#### Other Potential Causes
\nStarting 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.<\/p>\n
– If you’re using an older version (**\u2264 vX.3.0**), consider manually setting the mode to `SYNCHRONOUSLY` in the config screen for improved stability.
\n– **For modpack authors**: If you\u2019d like to test whether `FASTEST` provides a noticeable FPS boost in your setup, you can switch to it in the config screen\u2014**but use with caution**, as it may trigger crashes with incompatible mods.<\/p>\n
### Need Help?
\nIf you\u2019re unsure how to identify or fix the issue, please open a GitHub Issue or start a Discussion.<\/p>\n
– In version x.4.0, changed the default particle rendering mode to `SYNCHRONOUSLY` to avoid rare and confusing `ConcurrentModificationException`s when used with certain mods.
\n – If you’re still using an older version (\u2264 x.3.0), you may want to manually set it to `SYNCHRONOUSLY` in the config screen.
\n – If you’re a modpack author or want to test whether a different rendering mode (e.g., `ASYNCHRONOUSLY`) provides a noticeable FPS boost in your modpack, you can manually select another enum value in the config screen\u2014use with caution.<\/p>\n
## Features
\n– Flexible mixin options.
\n– Minecraft
\n – Particle culling.
\n – GPU particle acceleration(v20.1+ only).
\n – Async particle tick&rendering.
\n – Async particle light cache.
\n – Delayed texture tick by one frame to reduce client tick duration.
\n – Async rain&snow tick&rendering(buffer filling). (currently only supported in MC1.21.5+)
\n– Create
\n – Contraptions now block vanilla rains(v20.1+ only).
\n– Valkyrien Skies\/Create
\n – Particles can now collide with ships\/contraptions.
\n– Valkyrien Skies\/Create + Simple Weather\/Pretty Rain\/Particle Rain
\n – Modded weather particles can now collide with ships\/contraptions.<\/p>\n
## Mods Recommended<\/p>\n
– ModernFix
\n– Sodium\/Embeddium
\n– Flerovium
\n– Startlight\/ScalableLux<\/p>\n
## Mod Compatability<\/p>\n
### \u2705 Compatible (Proactively)<\/p>\n
– Sodium\/Embeddium
\n– Flerovium
\n– Iris\/Oculus
\n– Create
\n– Create: Aeronautics
\n– Valkyrien Skies
\n– Particle Rain(in progress)
\n– Simple Weather
\n– …<\/p>\n
### \u274c Incompatible
\n– OptiFine
\n– MadParticle
\n– Particle Core<\/p>\n
## Credits<\/p>\n
– MixinSquared
\n– MixinExtras
\n– MixinConstraints<\/p>\n","protected":false},"excerpt":{"rendered":"
Async particle tick, GPU accelerated particle rendering.<\/p>\n","protected":false},"featured_media":21672,"template":"","meta":{"_minecraft_slug":"asyncparticles","_minecraft_project_id":"c3onkd5k","_minecraft_author":"Harvey_Husky","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":3967298,"_minecraft_follows":461,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"asyncparticles.zip","_minecraft_size_bytes":155637617,"_minecraft_version_count":174,"_minecraft_updated_at":"2026-05-16T03:21:57.976367Z","_minecraft_date_created":"2025-03-12T16:20:10.505411Z","_minecraft_date_modified":"2026-05-14T05:48:53.250477Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/asyncparticles","_minecraft_icon_attachment_id":21672,"_minecraft_imported_at":"2026-05-31T21:37:19+00:00","_minecraft_import_hash":"032a63a976da814ed81a1ef7f197552a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,89,158,90],"mod_loader":[99,106,160],"minecraft_version":[36,62,37,40,41,38,78,79,80,81,82],"class_list":["post-21671","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-neoforge","mod_category-optimization","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n