Smart Particles

🛡️ Smart Particles 是一款轻量级客户端优化模组，旨在提升粒子效果密集场景下的帧率稳定性。

当 Minecraft 负载过高时，Smart Particles 不会只是阻止新粒子生成，而是会智能管理现有粒子，优先保留距离玩家更近、与当前视野更相关的效果。

它同时适用于原版粒子和其他模组添加的粒子。

✨ 功能

智能剔除粒子：
Smart Particles 不会随机删除粒子，而是根据粒子与玩家的距离进行评估，并优先保留附近的效果。超出设定上限时，会先移除不太重要的远处粒子。

智能镜头剔除：
可以提前移除远离镜头视野的粒子，减少对玩家身后或视野之外粒子的无谓处理。

🧠 _专业提示：如果启用智能镜头剔除后发现粒子意外闪现，可以单独关闭此功能，同时保留全局粒子数量上限。_

硬性上限保护：
通过强制限制活跃粒子的数量，防止粒子数量过多导致客户端不堪重负。上限可自行配置。

这有助于减少以下情况造成的 FPS 下降：

• 大型爆炸
• 生物农场
• 天气效果
• 粒子效果密集的生物群系
• 模组添加的法术效果
• 粒子发射器
• 安装大量模组的环境

性能优化：
Smart Particles 在设计时尽可能降低自身的处理开销。

近期版本包含：

• 粒子数量未达到设定上限时，采用轻量级 O(n) 处理
• 减少临时内存分配
• 缓存镜头和视野角度（FOV）计算结果
• 更高效地检查粒子位置
• 减少临时对象占用
• 改善对超多粒子效果的处理

只有在粒子数量确实超出设定上限时，才会运行开销更大的最近粒子筛选逻辑。

完全可配置：
默认粒子上限为 5,000，你可以根据硬件、整合包和个人偏好调高或调低上限。

模组菜单集成：
Fabric 用户可以选择安装 Mod Menu，方便地打开 Smart Particles 的配置界面。

客户端模组：
Smart Particles 完全在客户端运行，服务器无需安装此模组。

兼容性：
本模组旨在与其他添加或修改粒子效果的模组协同工作。大多数使用 Minecraft 标准粒子系统的模组无需额外配置即可兼容。

已测试并确认与 Smart Particles 兼容的模组：

• Particle Effects
• Particle Moths
• Particle Rain
• Particle Tweaks
• Particle Core
• Particular
• Visuality
• Particle Interactions
• Effective
• Subtle Effects
• Falling Leaves
• Cave Dust
• Wakes
• Vanilla Fireflies
• Cool Rain
• Better Combat
• Async Particles
• ……以及更多！

几乎所有使用 Minecraft 标准粒子系统的模组都应当兼容。

⚙️ 配置

在支持的情况下，你可以通过游戏内配置界面调整粒子上限，也可以直接编辑配置文件。

• 默认粒子上限： _5000_
• 智能镜头剔除： 默认 _True_

较新版本的配置文件位置：

.minecraft/config/smart_particles/config.json

较旧版本的 Smart Particles 可能使用以下位置：

.minecraft/config/smartparticles.cfg

较旧的配置路径仅适用于较早的 Minecraft 版本。

📦 Fabric

必需：

• Fabric Loader

可选：

• Mod Menu，方便访问配置界面

在 Minecraft 26.2 中，Smart Particles 不需要 Fabric API 和 Cloth Config。

部分较旧版本的 Smart Particles 可能有不同的依赖要求，请查看你要下载的具体文件的要求。

📦 NeoForge

NeoForge 版本只需要相应的 NeoForge 加载器。

Smart Particles 的配置界面已集成到模组菜单中。

📦 Forge

较旧的 Forge 版本只需要相应的 Forge 加载器，除非该版本另有说明。

🚀 Minecraft 26.2 性能优化

Minecraft 26.2 版本包含多项内部优化：

• 当当前粒子数量低于配置上限时，采用更快的处理路径
• 减少粒子处理过程中的临时内存分配
• 复用摄像机方向数据，而不是每个游戏刻都重新创建
• 缓存视场角计算结果，直到玩家的视场角发生变化
• 减少重复的粒子坐标查询
• 改进临时粒子筛选数据的清理
• 降低配置的粒子上限后，改进内存管理表现
• 增加对无效或过大的配置值的防护
• 改进对格式错误的配置文件的恢复处理

这些改动旨在减少 Smart Particles 在正常游戏过程中执行的工作量，同时保留其智能粒子优先级处理功能。

🔧 支持的加载器

Smart Particles 提供以下加载器的版本：

Fabric • NeoForge • Forge

具体支持哪些加载器取决于你使用的 Minecraft 版本。

📖 开源

Smart Particles 为开源项目，采用 MIT License。

你可以：

• 在整合包中使用
• 查看并修改源代码
• 依据许可证分发修改后的版本
• 报告问题或兼容性故障

如果你喜欢这个模组，欢迎考虑支持该项目！