๐ 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.tomlultrafps-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!