Oleaf

Oleaf is now open source!
The complete source code is available on GitHub. If you encounter a bug, have a feature request, or want to contribute, please open an issue on the GitHub repository.

Oleaf is a client-side Fabric graphics mod for Minecraft designed to make video settings easier to manage while providing modern upscaling, frame generation, performance controls, and a customizable FPS overlay.

✨ Features

🎨 Graphics

• Graphics presets
• Graphics quality controls
• Render, simulation, and entity distance
• Maximum FPS
• VSync
• Brightness
• FOV
• GUI scale
• Fullscreen
• Particles
• Clouds
• Entity shadows
• View bobbing
• Performance and stability options
• Advanced Minecraft, Sodium, and Iris settings
• Automatically applies compatible Minecraft and Sodium options

🔍 Upscaling

Oleaf supports multiple upscaling methods:

• AMD FidelityFX FSR 1
• Qualcomm SGSR 1
• Bicubic
• Bilinear
• Nearest Neighbor
• Ultra Quality
• Quality
• Balanced
• Performance
• Ultra Performance
• Custom render scale
• Adjustable sharpening

⚡ Frame Generation

• 2×–6× Frame Generation
• Pace Frames
• Adaptive Frame Generation
• Recommended settings
• Designed to work alongside supported rendering configurations

📊 FPS Overlay

The built-in performance overlay can display:

• FPS
• Frame time
• Memory usage
• Ping
• Entity count
• FSR status
• Frame Generation status
• Adjustable position
• Adjustable scale
• Adjustable opacity
• Custom keybinds

💡 Why Not DLSS?

DLSS is NVIDIA's proprietary technology and cannot be directly integrated into an open-source Fabric mod in the same way as an openly licensed solution.

Oleaf instead uses AMD FidelityFX FSR 1, which is open source and MIT licensed. FSR 1 is a spatial upscaling technique that can be used across different GPU vendors, including:

• AMD
• NVIDIA
• Intel Arc
• Intel integrated graphics

📈 Performance Comparison

FPS Comparison

🎥 Video Comparison

See Oleaf in action:

📦 Dependencies

Required

• Minecraft 1.21.x or 26.x
• Fabric Loader 0.19.3+
• Fabric API
• Mod Menu
• Cloth Config
• Java 21+

Optional

• Sodium
• Iris Shaders

🧩 Compatibility

• Client-side only
• Minecraft 1.21.11
• Compatible with Sodium
• Compatible with Iris

Oleaf is designed to work alongside Sodium rather than being a replacement for it.

Configuration

The configuration file is located at:

```text config/oleaf.json