Skip to content

Smart Particles #1055

@chedidandrew

Description

@chedidandrew

CurseForge link

https://www.curseforge.com/minecraft/mc-mods/smart-particles

CurseForge Mod Distribution

Allowed

Modrinth link

https://modrinth.com/mod/smart-particles

Source/other link

https://github.com/chedidandrew/Smart_Particles

Mod file size

50 Kb

License

(any other license)

What it does

A performance mod that greatly optimizes particle rendering and particle limits.

Why should it be in the modpack

I'm the author of the mod and I'd like to invite you to use my mod I created. It does exacty what the Modpack aims for - best performance possible using smart particle culling to improve performance. It is also very vanilla friendly and Client side only.

Image Image

Why shouldn't it be in the modpack

Not available yet on Modrith - the mod project is still pending approval (under review). Mod also limits particles to 5000 by default (but this is configurable in settings to any amount!) which can cause players to notice missing particles if, for example, player using a lot of fireworks in minecraft and wants to see it all rendered in full view.

Mod may not be available in Forge if this is an issue for the latest minecraft versions. However, it is available for Fabric currently and sometime in the future - NeoForge.

Additional details

Smart Particles

  • Summary: A performance mod that caps the total particle count, keeping the nearest particles in the player's view visible.

Smart Particles is a lightweight client side optimization mod for Minecraft (Fabric) that keeps FPS stable in particle heavy areas. Instead of blocking new particles, it keeps the most important particles visible by removing the farthest ones first.


Features

  • Smart culling: When the limit is reached, the mod removes particles farthest from the player to make room for new nearby particles. Optional: Only keep particles in front of the camera and within the view frustum for improved performance.
  • Hard cap protection: Helps prevent freezes from massive particle spam (farms, explosions, modded effects).
  • Configurable limit: Change the maximum particle count anytime.
  • Mod Menu integration: In game settings screen support.

Configuration

  • Default limit: 5000
  • Minimum limit: 0
  • Smart Camera Culling: true (Default) - Aggressively removes particles outside the camera view.

Edit methods

  1. In game: Install Mod Menu, then click the settings button for Smart Particles.
  2. Manual: Edit .minecraft/config/smart_particles/config.json

Installation and dependencies

Requires Fabric Loader.

Dependency | Required | Purpose -- | -- | -- Fabric API | Yes | Core Fabric utilities used by the mod Cloth Config API | Optional | Settings screen and config support Mod Menu | Optional | Adds the in game Mods button and settings entry


Compatibility

  • Client side only: Not needed on servers. Works on vanilla and modded servers.
  • Shader friendly: Compatible with Sodium and Iris.

How it works

Smart Particles uses Mixins to hook into Minecraft’s ParticleManager. Each tick:

  1. If Smart Camera Culling is enabled, particles outside the view frustum are removed immediately.
  2. If the total particle count still exceeds the limit:
    • Measure distance from the player to each active particle
    • Identify the farthest particles
    • Remove the excess so the total stays under the cap

License

MIT License. Free to use in modpacks and to view or modify the source.

Discord discussion link

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    modNew Fabric mod to includetesters wantedMods that could use more feedback and testing by the users

    Type

    No type

    Projects

    Status

    Todo

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions