Back to mods
Refract project artwork

CurseForge · Minecraft mod

Refract

An all-in-one Forge performance mod: smart culling, an adaptive auto-tuner that holds your target FPS,Chunk loading optimisation and zero visual changes up close.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Refract release matches 26.1?

Updated today
Best match for your filters Refract 26.1.x
Game version 26.1, 26.1.1, 26.1.2
Loader Fabric

Refract 26.1.x targets 26.1, 26.1.1, 26.1.2 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Refract required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Refract 26.1.x need?

Refract 26.1.x on 26.1. Every mod below is checked against that same setup.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Refract without breaking your instance.

Built for Refract 26.1.x on 26.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Refract 26.1.x. It targets 26.1, 26.1.1, 26.1.2 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside Refract 26.1.x. It opens that exact file at the source.

About this project

What does Refract add?

🔍 Refract

*The all-in-one performance mod for Minecraft 1.19.2 (Forge). Instead of one big rewrite, Refract stacks many small, safe rendering optimizations and lets an adaptive auto-tuner hold your target FPS.*

✨ Everything close to you still looks completely vanilla. The cuts only happen at a distance or off-screen.


⚡ What It Does

🎯 Adaptive Auto-Tuner

Set a target FPS (default 60). Refract tracks your frame times and smoothly dials down entity render distance and particle limits when your FPS dips, then scales them back up once things clear. Under heavy load, it can temporarily hide clouds too.

🐄 Entity Culling & Frame Budget

Stops rendering entities beyond a set range and caps how many get drawn per frame. Huge mob farms and crowded bases no longer tank your framerate.

  • Anything near you always renders normally
  • Other players are never hidden unless you explicitly enable it

✨ Particle Control

  • Caps total particles
  • Skips particles that are too far away or behind the camera
  • Updates ambient effects (dripping water, lava sparks) less often

📦 Block Entities & Details

  • Distant chests, signs and banners are culled
  • Armor, held items, capes and entity shadows only render when you're close enough to notice

🌫️ Fog-Aware Chunk Culling

Skips chunks that are already completely hidden behind terrain fog. Optional adaptive fog can pull the fog line slightly closer during FPS drops, without forcing chunk reloads.

🌧️ Cheaper Water & Weather

  • Fewer translucent chunk re-sorts per frame (water, stained glass)
  • Smaller rain/snow radius
  • Animated textures (water, lava, fire) update every second tick

🧠 Lighter Client Ticking

Stops ticking distant entities on the client, while the server keeps handling them normally.

💤 Background FPS Cap

Drops to 10 FPS when the window isn't focused, so your fans stay quiet while you're tabbed out.

☕ Startup JVM Check

Scans your Java flags and RAM allocation on launch and logs quick warnings if you've allocated too much or too little memory, or are using a stutter-prone garbage collector.


🎨 Shader Support

Refract automatically detects active shader packs and disables fog-based chunk culling and adaptive fog, so distant terrain doesn't get cut off prematurely. Everything else stays active. You can override this in the config if needed.


🖥️ Optional Server-Side Activation Range

For servers or heavy singleplayer worlds, there's an optional Spigot-style activation range: mobs far away from any player are only ticked every few ticks.

  • Disabled by default
  • Blacklist specific mods by namespace so nothing breaks

🔧 Configuration

Every feature can be toggled or tweaked in:

  • ultrafps-client.toml
  • ultrafps-server.toml

📊 Early Benchmarks

  • 🐮 Heavy entity scene: ~45 FPS → ~62 FPS
  • 🌄 24-chunk terrain view: ~52 FPS → 60–90 FPS

Taken from early testing on a single test rig. Your mileage will vary depending on hardware and modpack.


⚠️ Early Beta: Still in active development. If you run into visual glitches or mod incompatibilities, please report them!

Project description from CurseForge.

Pick your setup

Refract by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

30 available setups

Showing the newest 12 of 29 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Refract versions and loaders

1 of 7 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.