Upscale
Draw the world at a lower resolution, upscale it to your screen's, and get your frame rate back: made on and for the Mac.
Upscale renders Minecraft's world at a lower resolution and upscales it to your screen's, so heavy shader packs run faster. The HUD, your hand and screen overlays (fire, water, pumpkin) are drawn afterwards at full resolution and stay sharp. It brings FSR 2-style temporal upscaling, AMD's FSR 1 and Apple's MetalFX to Minecraft, with dynamic resolution on top.
- Made on and for macOS / Apple Silicon (OpenGL 4.1, no compute shaders). Tested only on macOS so far.
- Shader packs: Photon, Lanternlight, or none. With any other Iris shader pack loaded, Upscale is incompatible because i dont have enough time to fix the bugs. If you Get teir 2 patreon i will fix it for the shader you want tho
What it does
- Fewer pixels, same screen. At 67% (Quality) the world draws about 45% of the pixels; at 50% (Performance), a quarter. The upscaler fills in the rest.
- The HUD stays sharp. The GUI, screen overlays and your hand are drawn after the upscale, at full resolution. (If a shader pack draws the hand as part of the world, the hand is upscaled with it.)
- Textures keep their detail. While the world draws at a lower resolution, textures' mip bias is lowered to match, so blocks don't turn blurry in the distance.
- Anti-aliasing included. Temporal and AI Scaling smooth jagged edges as they upscale. At 100% scale, Temporal is plain TAA.
Upscalers
- Temporal (FSR 2-style). The default. Every frame is drawn shifted by a different fraction of a pixel (a Halton sequence, as FSR 2 and DLSS use). The frames are gathered into a history kept at your screen's resolution, found again through the depth buffer and the camera's motion, and sharpened with AMD's RCAS. Detail builds up over a few frames and edges come out smooth. It's the sharpest at low scales. Things that move on their own can look a little soft for a moment.
- AI Scaling. Temporal with a small learned network (332 weights) on top. In place of three of Temporal's fixed rules, the network decides pixel by pixel how much of the history to keep, how tightly to clip it, and whether to use history the depth test rejected. Sharper than Temporal while the camera moves, the same while it stands still. It costs a little more GPU time per frame than Temporal (measured at 1728×1117, 50%). It upscales only: it doesn't make extra frames (the Framegen mod does that, and works alongside it).
- FSR 1. AMD FidelityFX Super Resolution 1, AMD's own code (EASU and RCAS, MIT licence). Each frame is upscaled on its own along its edges, then sharpened. The cheapest; it never smears, but it can't add detail the smaller frame didn't have. Good with shader packs that have their own TAA.
- MetalFX (experimental, Apple). Apple's MetalFX temporal upscaler, the Mac's counterpart to DLSS, fed the same jittered frames, depth and camera motion as Temporal through surfaces shared between OpenGL and Metal. It upscales 1x to 3x (below 34% scale, Temporal draws the frame). It is slower than Temporal here, since OpenGL has to hand each frame over to Metal, and OpenGL and Metal sharing the GPU can crash the game in Apple's driver. So it's experimental, macOS only, and only chosen on purpose on the settings page.
- Off. The world at full resolution, as without the mod.
Dynamic resolution
Works with any upscaler. When the GPU can't keep up with your Target Frame Rate, the render scale goes down; when it can, it goes back up, to your Render Scale setting at most. It measures the GPU's own time per frame, so VSync and frame rate caps don't fool it. Temporal's history and MetalFX's scaler stay at screen resolution, so the picture holds steady while the scale moves. You choose the target frame rate and the lowest scale it may go to. Off by default.
Measured
All on an M3 Pro Mac.
Frame rates with Lanternlight (then called Voxlight), 1920×1080 game resolution, uncapped:
| Native | Temporal 67% | Temporal 50% | MetalFX 67% | MetalFX 50% | FSR 1 67% | FSR 1 50% | |
|---|---|---|---|---|---|---|---|
| Flat test world | 65 | 81 | 95 | 72 | 83 | 84 | 99 |
| Distant Horizons, forest | 49 | 62 | 72 | 56 | 65 | (noisy) | 74 |
With water in view (Lanternlight's reflections): native 37 fps, Temporal 56 at 67% and 68 at 50%.
Image quality against a 4× supersampled reference of the same scene (3840×2160 scaled down; PSNR over the scene without sky or hand, higher is closer; sharpness 1.0 means as crisp as the reference):
| PSNR | Sharpness, still | Flicker, still | Sharpness, turning | |
|---|---|---|---|---|
| Native 1920×1080, no AA | 31.2 dB | 1.19 (aliased) | none | 0.97 |
| FSR 1 67% / 50% | 29.9 / 28.0 dB | 1.02 / 0.87 | none | 0.86 / 0.72 |
| Temporal 67% | 34.4 dB | 0.93 | 43 dB | 0.89 |
| Temporal 50% | 32.5 dB | 0.85 | 39 dB | 0.92 |
Temporal at 67% is 3.2 dB closer to the supersampled image than native rendering, and even 50% (a quarter of the pixels) beats native. Turning, it stays nearly as crisp as native. Leaves and fences keep their history too, though the jitter alternates them with what's behind. (Measured with an earlier build that also sharpened the history while moving; 1.0.0 leaves that off, so the turning numbers may differ a little.)
AI Scaling against Temporal, 1728×1117 window at 50%, 27 fixed camera paths, compared with the native frame (luma PSNR, higher is closer):
| Temporal | AI Scaling | |
|---|---|---|
| All 27 paths | 28.19 dB | 29.05 dB |
| Slow camera (11) | 27.87 dB | 29.30 dB |
| Fast camera (7) | 27.00 dB | 27.75 dB |
| Standing still (9) | 30.11 dB | 30.11 dB |
Settings and keys
- Sodium's Video Settings has an Upscale page: Upscaler, Render Scale, Sharpness, Dynamic Resolution, Target Frame Rate and Minimum Scale, each with a tooltip.
- . (period) cycles the upscalers: Off, FSR 1, Temporal, AI Scaling. (MetalFX is picked on the settings page.)
- - and = step the render scale down and up through the named scales.
- The keys can be changed under Controls → Upscale.
- F3 shows the upscaler, the render and output sizes, and why Upscale is off when it is.
- Everything is also in
config/upscale.properties.
| Render scale | Name |
|---|---|
| 100% | Native |
| 77% | Ultra Quality |
| 67% | Quality (default) |
| 59% | Balanced |
| 50% | Performance |
| 33% | Ultra Performance |
Sharpness sets how much the upscaled image is sharpened (AMD's RCAS, which doesn't overshoot edges).
Compatibility
Shader packs: Photon and Lanternlight only, or no shader pack. Upscale was made and tested with these two packs. Other packs draw the world in ways it can't follow (their own TAA, depth, hand and sky), so when one of them is loaded Upscale turns itself off and shows a message saying so: "Upscale is off with (pack). It supports only the Photon and Lanternlight shader packs (or no shader pack)." F3 says it too. Switch back to Photon, Lanternlight or no pack and it comes back on. Lanternlight's earlier names, Voxlight and Emberlight, count as Lanternlight. Packs are recognised by their name.
With Lanternlight, nothing needs turning off: while Temporal, AI Scaling or MetalFX is running, the pack hands its own TAA and FXAA over to Upscale by itself, and Distant Horizons terrain is upscaled as sharply as the rest. With Photon, turn the pack's own TAA off for the sharpest picture.
Mods:
- Sodium: works with it, and gives Upscale its settings page.
- Iris: works with it (with the shader packs above).
- Distant Horizons: works, through Iris (see the forest numbers above).
- Framegen: works alongside it. Framegen makes the in-between frames; Upscale makes each frame cheaper to draw.
- Render Scale: not compatible. Both mods resize the world. Upscale stays off while Render Scale is installed and tells you so in game.
Not here, and why:
- DLSS runs only on NVIDIA RTX graphics cards under DirectX or Vulkan; Macs have neither. MetalFX is Apple's equivalent, and it's here.
- AMD's FSR 2 code needs compute shaders (OpenGL 4.3), and macOS stops at OpenGL 4.1. Upscale's Temporal upscaler is built on FSR 2's design instead, in fragment shaders.
Mac support
Upscale was made on a Mac, for Macs:
- It sticks to OpenGL 4.1, the newest version macOS has, and needs no compute shaders.
- It brings MetalFX, Apple's own upscaler, to Minecraft (experimental), with no native library: it calls Metal straight from Java.
- Every number on this page was measured on an M3 Pro.
It has only been tested on macOS / Apple Silicon. It may well run on Windows and Linux, but that hasn't been tried; if you do, please report how it goes. MetalFX isn't offered outside macOS.
Requirements
- Minecraft 26.3 with Fabric Loader 0.19.5 or newer
- Fabric API 0.162.0 or newer
- Java 25
- Sodium (optional, recommended): for the settings page. Without it, use the keys and
config/upscale.properties. - Iris (optional): for Photon or Lanternlight.
- Client only. Not needed on servers.
License
MIT. Includes AMD FidelityFX FSR 1 (MIT, © Advanced Micro Devices).