1. Get Fabric
Head to fabricmc.net/use/installer and download the Fabric Installer. Run it, pick your Minecraft version from the dropdown (use the latest stable release for best results), and click Install.
Fabric automatically creates a new profile in your Minecraft launcher called something like "fabric-loader-1.21.x". You’ll see it in the bottom-left of the launcher next time you open it.
You’ll also need the Fabric API mod — download it from Modrinth. This is a separate file that goes in your mods folder (we’ll do that in the next step).
⚠ Common Mistake Make sure you download the Fabric INSTALLER, not the API. The installer sets up Fabric Loader in your launcher. The API is a separate mod you add to your mods folder afterwards.
💡 Tip Fabric supports Minecraft 1.16 and above. For the best experience with Optimum Realism, use the latest stable Minecraft release.
2. Install the mods
You need these mods for the full Optimum Realism experience. Download them all from Modrinth:
Required:
• Iris — shader loader (this is what makes shaders work)
• Sodium — massive performance boost (doubles your FPS in most cases)
• Fabric API — required by most Fabric mods
Needed for full pack features:
• Continuity — connected textures (glass, bookshelves, etc.)
• Polytone — custom colors for water, grass, and sky
• Entity Model Features (EMF) — custom entity models
• Entity Texture Features (ETF) — custom entity textures
Drop all the .jar files into your mods folder:
.minecraft/mods
On Windows, press Win + R and type %appdata%\.minecraft\mods to get there fast.
On Mac: ~/Library/Application Support/minecraft/mods
On Linux: ~/.minecraft/mods
⚠ Make sure every mod matches your Minecraft version. Mixing versions (e.g., a 1.20.4 mod on Minecraft 1.21) will crash the game on launch. Check the version number before you download.
⚠ Common Mistake Don’t put mods in the resourcepacks folder — they go in mods/. Resource packs and mods are completely different things.
💡 Tip If you’re on a lower-end PC, Sodium alone can double your frame rate. It’s the single most impactful performance mod you can install.
3. Add the resource pack
Take the Optimum Realism .zip file and drop it into your resource packs folder. Do not unzip it — Minecraft reads it directly from the .zip.
.minecraft/resourcepacks
On Windows: press Win + R and type %appdata%\.minecraft\resourcepacks
On Mac: ~/Library/Application Support/minecraft/resourcepacks
On Linux: ~/.minecraft/resourcepacks
You can also add packs from inside Minecraft: go to Options → Resource Packs → Open Pack Folder.
⚠ Common Mistake Do NOT unzip the .zip file. Minecraft reads it as-is. Unzipping it breaks the folder structure and the pack won’t show up in the game.
💡 Tip If you have multiple resource packs, make sure Optimum Realism is at the top of the list (highest priority). Other packs loaded above it will override its textures.
4. Pick a shader
Just want it to work? Get Kappa Shaders. It has top-tier LabPBR and POM support, looks excellent with Optimum Realism, and is free. Download it from shaderLABS (or search "Kappa Shader" on Modrinth), drop the .zip into your shaderpacks folder, and skip to the next step. That’s the whole decision — you do not need to compare the rest.
Your shaderpacks folder:
.minecraft/shaderpacks · on Windows: %appdata%\.minecraft\shaderpacks
Why a shader at all? Optimum Realism uses LabPBR to describe realistic materials. Without a LabPBR-compatible shader you only see about a third of the pack’s detail — no depth, reflections, or realistic lighting.
More shader options (advanced)
All of these support LabPBR and pair well with the pack — pick one only if you have a reason to:
• Complementary Reimagined — lighter than Kappa, great for everyday play on mid-range GPUs
• Complementary Unbound — the cinematic version of Reimagined
• BSL — clean, stylized look
• Sundial / Sundial Lite — newer, lightweight options for lower-end hardware
• KappaPT / SEUS PTGI HRR 2.1 — path-traced lighting for high-end GPUs (heavy)
Full tier comparisons and pack-resolution pairings are on the shader guide, and there’s a deeper walkthrough at which shader is best.
⚠ Common Mistake Only use LabPBR-compatible shaders. Sildur’s Vibrant and some older shaders won’t show PBR materials correctly — your textures will look flat without proper reflections or depth.
💡 Tip Stick with Kappa unless your GPU struggles — then drop to Complementary Reimagined. Either one looks great; you don’t need to try them all.
5. Activate everything
Launch Minecraft using your Fabric profile (check the bottom-left of the launcher).
Step 1 — Turn on the resource pack:
Go to Options → Resource Packs. You’ll see Optimum Realism in the "Available" column on the left. Click the arrow to move it to the "Selected" column on the right. It should be at the top of the list.
Step 2 — Turn on the shader:
Go to Options → Video Settings → Shader Packs (or just Video Settings → Shaders depending on your Iris version). Click on your shader to select it, then click Apply.
Give the game a moment to load — shaders take a few seconds to compile the first time.
⚠ Common Mistake If you don’t see the Fabric profile in your launcher, go back to Step 1 and make sure Fabric installed correctly. The profile should appear automatically.
6. Configure shader settings
This is the step most people skip — and then wonder why things don’t look right. Open your shader’s settings and check these:
Must enable:
• POM / Parallax Occlusion Mapping: This gives blocks real 3D depth (bricks pop out, cracks sink in). Without it, textures look flat.
• PBR / LabPBR Materials: Set this to LabPBR (not "OldPBR" or "Integrated PBR"). This is what makes materials look like real stone, metal, wood, etc.
• Emissive Textures: Makes glowstone, lava, and other light sources actually glow.
Nice to have:
• Reflections / Specular: Gives wet surfaces and metals realistic shine
• POM Depth / Parallax Quality: Higher = more 3D depth, but uses more GPU
• Normal Map Strength: Controls surface detail intensity
Where to find these settings:
Go to Video Settings → Shader Packs → Shader Pack Settings (the gear icon next to your shader name). The exact names vary between shaders, but look for sections like "Materials", "Lighting", or "Surface".
⚠ If textures look flat or "painted on", POM is probably off. This is the #1 issue people run into. Also check that PBR mode is set to LabPBR, not OldPBR.
⚠ Common Mistake Each shader uses slightly different names for the same settings. In one shader it might be called "Parallax", in another "POM Quality", and in another "Parallax Occlusion Mapping". Look around — it’s there somewhere.
7. Allocate enough RAMOptional
Only do this if Minecraft is stuttering, freezing, or crashing. If the game is running fine, you’re done — you can stop here and go build something. Most players never need to touch RAM.
If you are running into memory problems, match your RAM to the resolution you’re using:
| Resolution | Minimum RAM | Recommended RAM |
|---|
| 64x (Free) | 2 GB | 2–4 GB |
| 128x | 2 GB | 4–6 GB |
| 256x | 4 GB | 6–8 GB |
| 512x | 6 GB | 8+ GB |
Most players are on 256x — that’s our Basic tier. Worked example: 16 GB total RAM running 256x → set -Xmx6G. Rule of thumb: pick the number from the table and never go above half your total system RAM.
Show me how to change RAM allocation
In the Minecraft Launcher, go to Installations → Edit → More Options. Find the JVM Arguments field. Look for -Xmx2G and change it to the amount you need, like -Xmx6G for 6 GB. Save, then relaunch.
Don’t over-allocate: giving Minecraft more than half your total RAM (e.g. 12 GB on a 16 GB system) starves your OS and GPU drivers and can make performance worse.
⚠ If the game crashes on startup with an "Out of Memory" error, this is almost always the fix. Increase your RAM allocation.
⚠ Common Mistake Don’t allocate too much RAM either. Giving Minecraft 12 GB on a 16 GB system leaves almost nothing for your operating system and GPU drivers, which can cause worse performance.
💡 Tip Also make sure you’re running Java 21 or newer. Older Java versions can cause crashes with newer Minecraft releases. Download from adoptium.net if needed.