AsyncParticles - AsyncParticles 异步粒子优化

AsyncParticles

配置

可通过 ModList/ModMenu 访问设置。

故障排除

与 LodestoneLib 一起崩溃

• 在 lodestone-client.toml 中将 buffer_particles = false。

与 ClassInstanceMultiMap 或 Level.getEntities(...) 相关的崩溃

• 请在 GitHub issue 中分享日志或崩溃报告。
• 作为临时解决方法，启用以下选项：

Mixin → 使 'ClassInstanceMultiMap' 线程安全

与 Level.getBlockEntity(...) 相关的崩溃

• 请在 GitHub issue 中分享日志或崩溃报告。
• 作为临时解决方法，启用以下选项：

Mixin → 使 'LevelChunk#blockEntities' 线程安全

ConcurrentModificationException

最常见的原因

当粒子渲染和 tick 并发访问同一个非线程安全容器时，通常会出现此异常。

如何修复

• 将粒子类的完整限定类名添加到该模组 Mixin 设置中的 particle$lockProvider 和 particle$lockRequired。

有关详细信息，请参阅配置指南

> 注意：这会为特定粒子类型启用细粒度锁定，从而允许在 tick() 和 render() 方法之间安全地进行异步执行。

其他可能原因

从 vX.4.0 开始，默认粒子渲染模式已更改为 SYNCHRONOUSLY，以防止在与某些会在粒子渲染期间访问外部非线程安全容器（例如全局 map 或 list）的模组一起使用时，出现罕见的 ConcurrentModificationExceptions。

• 如果你使用的是较旧版本（≤ vX.3.0），请考虑在配置界面中手动将模式设置为 SYNCHRONOUSLY 以提高稳定性。
• 对于整合包作者：如果你想测试 FASTEST 是否能在你的环境中带来明显的 FPS 提升，你可以在配置界面中切换到它——但请谨慎使用，因为它可能会导致与不兼容模组一起崩溃。

需要帮助？

如果你不确定如何识别或修复该问题，请提交一个 GitHub Issue 或发起一个 Discussion。

• 在版本 x.4.0 中，将默认粒子渲染模式更改为 SYNCHRONOUSLY，以避免与某些模组一起使用时出现罕见且令人困惑的 ConcurrentModificationException。
• 如果你仍在使用旧版本（≤ x.3.0），你可能需要在配置界面中手动将其设置为 SYNCHRONOUSLY。
• 如果你是整合包作者，或者想测试不同的渲染模式（例如 ASYNCHRONOUSLY）是否能在你的整合包中带来明显的 FPS 提升，你可以在配置界面中手动选择其他枚举值——请谨慎使用。

特性

• 灵活的 mixin 选项。
• Minecraft
• 粒子剔除。
• 异步粒子 tick 与渲染（buffer filling）。
• 异步粒子光照缓存。
• 将纹理 tick 延迟一帧，以减少客户端 tick 持续时间。
• 异步雨雪 tick 与渲染（buffer filling）。（当前仅支持 MC1.21.5+）
• Valkyrien Skies/Create
• 粒子现在可以与船只/机械装置发生碰撞。
• Valkyrien Skies/Create + Simple Weather/Pretty Rain/Particle Rain
• 模组天气粒子现在可以与船只/机械装置发生碰撞。
• Pretty Rain/Particle Rain/Effectual/Particular/Simple Weather
• 异步粒子生成。

推荐搭配的模组

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

模组兼容性

✅ 兼容（主动适配）

• Sodium/Embeddium
• Flerovium
• Iris/Oculus
• Create
• Valkyrien Skies
• Particle Rain/Pretty Rain
• Simple Weather
• Effectual
• Effective
• Particular
• Particle Core
• 会禁用 ParticleCore 的大部分优化，但保留其其他功能。

（这是由于与 AsyncParticles 的异步优化不兼容。）

• ...

❌ 不兼容

• OptiFine
• MadParticle

致谢

• MixinSquared
• MixinExtras
• MixinConstraints