Oculus Particle Fix
Oculus Particle Fix stops particles from showing through walls when the Oculus shader mod is active and an item is picked up.
What it does
The Oculus Particle Fix mod addresses a visual glitch in the Forge port of the Iris shader mod, which Oculus builds on. Since Minecraft 1.18.2, particles from item pickup could show through walls, and with shaders disabled the particles still appeared black. The fix targets only that effect and is meant to remove the glitch without introducing another one.
The author notes that an earlier option, disabling item pickup particles altogether, removed the glitch but had side effects, which is why this mod takes a different approach. Oculus is required, because the fix works on top of its shader pipeline. The author notes that Oculus version 1.19.2 and later reportedly contain a similar fix, which works imperfectly and is absent from the 1.18.2 build.
The mod is published for Forge only, in 7 release versions covering 1.18.2 – 1.20.1, with 1.0 for 1.20.1 as the latest file. Players add it to their own game, and a server needs no copy. The code is open source under the MIT License, and the source code and issue tracker are public.
Key features
Item pickup particle fix
Particles created when items are picked up no longer appear through solid blocks while Oculus shaders are running.
Black particle correction
The particles that appear dark when shaders are turned off are handled by the same fix.
Targeted scope
The change is limited to the pickup particle effect, so other particle behavior is left as it was.
Public source code
The source code and issue tracker are linked publicly for anyone who wants to check how the fix works.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
How it compares
Days In The Middle Ages is a Fabric and Forge mod for 1.18.2 – 1.20.1 that runs on client and server, and it is not open source under an All rights reserved license. Biome Particle Weather is client-side only, open source under the Mozilla Public License 2.0, and covers 1.18.2 – 1.21.8 on Fabric and Forge. Iris & Oculus Search is also client-side only and open source under the GNU Lesser General Public License v3.0 only, with builds 1.20 – 26.3 on four loaders.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Oculus Particle Fix | Forge | 1.18.2 – 1.20.1 | Client-side only | 2023-10-08 |
| Days In The Middle Ages | Fabric and Forge | 1.18.2 – 1.20.1 | Client and server | 2023-11-06 |
| Biome Particle Weather | Fabric and Forge | 1.18.2 – 1.21.8 | Client-side only | 2025-09-03 |
| Iris & Oculus Search | Fabric, Forge, NeoForge and Quilt | 1.20 – 26.3 | Client-side only | 2026-10-10 |
Questions
Does Oculus Particle Fix need Oculus?
Does the server need Oculus Particle Fix?
Which game versions have a build?
In the catalog
Oculus Particle Fix is one of 12,078 Decoration mods on ModsFinder, and one of 6,149 Decoration mods for Forge. 34,764 mods support Minecraft 1.20.1.
More from LaidBackSloth
Similar mods
What the author says
Important: With the new 1.20.1+ Versions of Oculus, this mod is not needed anymore, but will rather result in a crash. Since Minecraft version 1.18.2, the shader mod Oculus (a Forge port of Iris ) had a bug where all particles would be visible through walls during item pickup. With shaders disabled, they would even…
Official listing
- Modrinth page
- modrinth.com/mod/oculus-particle-fix
- Owner
- LaidBackSloth
- Published
- 2023-10-08
- Updated on Modrinth
- 2023-10-08
- Facts verified
- 2026-10-15