适用于 Minecraft 1.20.1, 1.21.1 的 AsyncParticles 模组

AsyncParticles

• 它将在未来保持测试阶段，以提醒潜在的模组冲突问题。
• 现在兼容 Particle Core（v20.1+）。
• 现在兼容 Valkyrien Skies v2.4。

核心功能

GPU 加速

• 将粒子顶点变换卸载到 GPU，减少每帧上传到 GPU 的数据量，降低 CPU 负载，并提高帧率。
• 这基本上取代了之前的异步粒子顶点提取，同时还提高了兼容性（异步粒子提取现在默认禁用）。
• 填满 1331 个营火（16,000+ 粒子，你可以通过配置界面更改限制）：

测试平台：Ultra5 225H + RTX 5060 Laptop，1080p。

Create 集成

• Create 装置现在可以阻挡原版天气。（v20.1.0a+）
• 等我有空时会把它移到一个新模组中。
• 粒子现在可以与装置发生碰撞。

其他功能

• 灵活的 mixin 选项。
• Minecraft
• 粒子剔除。
• 异步粒子 tick。
• 异步粒子光照缓存。
• 将纹理 tick 延迟一帧以减少客户端 tick 耗时。

配置

可以通过 ModList/ModMenu 访问设置。

故障排除

• 我们引入了诊断功能，不应用推荐设置通常不会导致崩溃，你会在聊天栏收到更改它们的提示。

与 Bosses Rise 一起使用

• 启用 GPU Only Async Particle Tick。

与 BadOptimizations 一起使用

• 在 badoptimizations.txt 中设置 enableparticlemanageroptimization: false
• 自 20.1.1.0/21.1.1.0 起已修复。

与 C2ME 崩溃

• 在 c2me.toml 中设置 enforceSafeWorldRandomAccess = "false"
• 仅在你遇到崩溃时才设置此项。

与 LodestoneLib 崩溃

• 在 lodestone-client.toml 中设置 bufferparticles = false。

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

• 请在 GitHub issue 中分享日志或崩溃报告。
• 作为变通方法，启用该选项：

Mixin → Make 'ClassInstanceMultiMap' Thread-Safe

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

• 请在 GitHub issue 中分享日志或崩溃报告。
• 作为变通方法，启用该选项：

Mixin → Make 'LevelChunkblockEntities' Thread-Safe

ConcurrentModificationException

最常见的原因

此异常通常发生在粒子渲染和 tick 并发访问同一个线程不安全的容器时。

如何修复

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

详情请参阅配置指南

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

其他可能的原因

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

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

需要帮助？

如果你不确定如何识别或修复该问题，请打开 GitHub Issue 或发起 Discussion。

推荐模组

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

模组兼容性

✅ 兼容（主动）

• Sodium/Embeddium
• Flerovium
• Iris/Oculus
• Create
• Create: Aeronautics
• Valkyrien Skies
• Particle Rain
• Particle Core
• ...

❌ 不兼容

• OptiFine
• MadParticle

鸣谢

• MixinSquared
• MixinExtras
• MixinConstraints