MC-WIKI.net
Particle Core Wiki › Guides › Particle Core Guide: Culling Blacklist, Culling Mode, and Disabling Potion Particles

Particle Core Guide: Culling Blacklist, Culling Mode, and Disabling Potion Particles

guide

Particle Core gives you several ways to cut down on particle load, and this guide covers three of them: the culling blacklist, choosing how particles are culled, and turning off potion particles based on who produced them. All of these are handled through the mod's interface and its hotkeys rather than through any in-game crafting.

Particle Culling Blacklist

The cullingBlacklist setting holds a list of particles that culling should leave alone. If a particle type behaves oddly under culling — particularly when culling is set to be aggressive — adding it here keeps it rendering normally. Very large particles are the usual candidates for this list, since they tend to suffer most when culling is strict.

To use it, open the Particle Core interface and find the cullingBlacklist entry, then add the particle types you want excluded. Its performance impact is listed as non-performance, meaning it exists to fix visual problems rather than to save frames.

Selecting a Culling Mode

How Particle Core culls particles is controlled by the culling mode setting, which carries a HIGH performance impact. Leaving culling switched off will cost you a large amount of performance, so it is worth choosing a mode deliberately.

The available modes are:

  • Off — stops culling entirely. This is not recommended unless you genuinely need it.
  • Midpoint — culls based on each particle's midpoint. This gives the best performance, but it can cull particles that are only just inside the frame (less than halfway in). Most players never notice this; if you do, switch to Bounding Box.
  • Bounding Box — culls using the outer edges of each particle's bounding box. This still delivers a solid performance gain and reduces the problem of particles popping out at the screen edge.

Pick the mode that matches how much you value raw performance versus perfectly clean edges.

Disabling Potion Particles by Source

The turnOffPotionParticlesV2 setting lets you suppress potion particles, and it offers several degrees of suppression depending on where those particles come from. This setting has a Low performance impact.

The choices are:

  • Nothing is suppressed — potion particles remain fully enabled.
  • Particles from other players are suppressed, while your own are not.
  • Particles you emit are suppressed, while other players' are not.
  • Particles from non-player mobs are suppressed.
  • Every potion particle is suppressed, regardless of source.

Select the option that matches the sources you want silenced. If you only want to clear visual clutter from crowds, suppressing other players is usually enough; if you want the effect gone entirely, choose the option that disables all of them.

A few neighbouring options affect how much these features matter:

  • disableParticles — turns off every particle on the client. HIGH impact.
  • byTypeReductions — lets you reduce or disable individual particle types; for example, setting a type to 0.3 makes it appear at roughly a third of its usual rate. Medium impact.
  • maxParticlesPerSheet — caps how many particles can spawn at once. Default is 16,384. Medium impact.
  • particleRenderDistanceMultiplier — scales how far particles render relative to block render distance, from 0.1 to 1.0, with 1 being full distance. Medium impact.
  • asynchronousTicking — when enabled (the default), particles tick off the client's main loop, which can cause instability; Particle Core tries to switch this off automatically if that happens, and you can disable it yourself if it cannot. Medium impact.
  • reduceDecreasedChance — a dial between the ALL and DECREASED modes, from 0.0 to 1.0. Low impact.

For any hotkey mentioned above, use the corresponding hotkey and set it in the controls menu if you want to change it.