Help
Help for every setting, and guides for the bigger questions about shaders on a Mac. New here? Start with download and install, then the first launch. How the renderer itself is built is on how it works.
Setup and settings
Everything the pack can do, one topic per page, in the order the settings screen shows them.
Getting started
First launch: the Vulkan prompt and the master switch
Rockstar Shaders setup on a Mac: start the game once, accept the Vulkan prompt, start again, press K in a world and read the header under the title.
Keys and shortcuts
Rockstar Shaders controls: K opens the settings, hold C to zoom 4x while the wheel adjusts it, F1 hides a settings page, F3 hides the overlays. Both rebind.
Quality settings: what ships, and what to lower first
No Low to Ultra chooser: Rockstar Shaders ships at Ultra. The 13 keys the profile tables move, what buys frame time on the M4 Max, and how a change applies.
The settings, screen by screen
View distance and the extended horizon
Rockstar Shaders' View Distance page: Extended horizon keeps every chunk you have seen on the horizon, out to 128 chunks; Generate horizon fills the gaps.
The Sky and Clouds page
The 16 settings on the Sky and Clouds page in Rockstar Shaders: the square sun, sunsets, stars, Milky Way, aurora, moon glow and the blocky cloud deck.
The Water page
The 10 Water settings in Rockstar Shaders: the wave ladder, ripple simulation, screen reflections, falling water, spray and surf, and what each one costs.
The Lighting and Shadows page
The 11 Lighting and Shadows settings in Rockstar Shaders: ray-traced sun shadows through Metal, shadow cascades, entity and player shadows, dynamic lights.
The Reflections and Materials page
The 7 Reflections and Materials settings in Rockstar Shaders: ray-traced reflections for water, metal and ice, the screen trace, glass, gold and iron.
The Fog and Volumetrics page
Rockstar Shaders' Fog and Volumetrics page: Fog steps, Fog range, Fog density, Horizon fade and Underwater shafts, with defaults and what the fog costs.
The Foliage and Weather page
Rockstar Shaders' Foliage and Weather page: waving leaves and crops, wind strength, wind in rain, snow on leaves, sea grass sway, and the pack's own rain.
The Textures and Details page
Rockstar Shaders' Textures and Details page: connected glass, connected sandstone, Better Grass and natural textures, built in, no OptiFine or Continuity.
The Post-processing page
Rockstar Shaders' Post-processing page: Depth of field, DoF taps, Exposure key and Film grain, plus what TAA, bloom, AgX and the bob warp do with no setting.
The Performance and Overlays page
Rockstar Shaders' Performance and Overlays page: Render scale, Target FPS, leaf culling, the FPS and pass-timing overlays, and what each costs on an M4 Max.
The Advanced page, tune keys and the config file
The Rockstar Shaders config: about 600 tune keys on the Advanced page, config/rockstarshaders.json, command line overrides, and the two reset buttons.
Packs, dimensions and problems
Resource packs: the OptiFine features that work without OptiFine
Rockstar Shaders reads OptiFine-format packs on Fabric with no OptiFine, Continuity, EMF or ETF: connected and emissive textures, entity models, skies.
The Nether and the End
The Nether and the End in Rockstar Shaders: each has its own sky, fog and ambient light. The Overworld is the tuned target; the other two have three shots.
Troubleshooting: when the world looks like vanilla
Rockstar Shaders not working? Press K and read the header, then search logs/latest.log for RockstarShaders. OpenGL, disabled after an error, slow.
Reporting a bug
How to report a Rockstar Shaders bug: send logs/latest.log, a screenshot with F3 open and what you expected to GitHub issues; add pass timings for speed.
Guides
Longer pages for a particular question: shaders on a Mac, ray tracing, Apple silicon, the packs people compare it with, and why it exists.
Shaders on a Mac
Minecraft shaders on a Mac in 2026: what runs, what does not, and why
Minecraft shaders on a Mac in 2026: Iris packs need OpenGL, which Apple deprecated and Iris does not support on Apple Silicon; Rockstar Shaders uses Vulkan.
Minecraft shaders on M1, M2, M3 and M4: what to expect from each
Minecraft shaders on M1, M2, M3 and M4 Macs: what Apple says each chip has, what Rockstar Shaders measured on an M4 Max, and which settings buy frames.
Ray tracing in Minecraft on a Mac: what Bedrock cannot do here, and what Java can
Bedrock's ray tracing is Windows only and Bedrock is not on macOS. On Java 26.3, Rockstar Shaders traces shadows, GI, reflections and fog on Metal on a Mac.
Minecraft RTX on a Mac: the honest answer, and the nearest thing
There is no Minecraft RTX on a Mac: it is a Bedrock feature for Windows and ray tracing GPUs. The nearest thing on Java is Rockstar Shaders, traced on Metal.
How to install Minecraft shaders on a Mac
How to install Minecraft shaders on a Mac: Iris or OptiFine on OpenGL, or Rockstar Shaders on Vulkan for Apple Silicon. Facts read on 2026-09-19.
Minecraft's Vulkan renderer on a Mac
Minecraft Java 26.2 added a Vulkan backend; on a Mac it runs through MoltenVK on Metal. Rockstar Shaders requires it. How to switch, and why.
Getting more frames from Minecraft shaders on a Mac
Why shaders lag on a Mac and what to change first: render scale, Target FPS, the pass-timings overlay, and what each setting costs, measured on an M4 Max.
Minecraft water shaders: what the water engine does
What realistic Minecraft water takes: a wave spectrum limited by how much open water there is, a simulated ripple field, traced reflections and caustics.
The best Minecraft shaders for a Mac in September 2026
The best Minecraft shaders for a Mac in 2026, ranked by what each pack's own page says about Macs: one on Vulkan, six on OpenGL via Iris. Checked 2026-09-19.
Compared with other packs
Iris Shaders on a Mac
Iris on a Mac in 2026: it runs on OpenGL and lists Apple Silicon as not supported. Rockstar Shaders renders only on Vulkan, so the two never share a backend.
OptiFine on a Mac
OptiFine on a Mac in 2026: the newest build is a preview for 26.1.2, on OpenGL. The pack formats people keep it for, Rockstar Shaders reads on 26.3.
Complementary Shaders on a Mac, and what I built instead
Complementary Shaders runs on a Mac through Iris or OptiFine on OpenGL. Rockstar Shaders is a Mac-only mod that renders on Vulkan and traces in Metal.
BSL Shaders on a Mac, and what I built instead
BSL Shaders runs on a Mac through Iris or OptiFine on OpenGL, newest listed version 26.2. Rockstar Shaders is a Mac-only Vulkan and Metal renderer for 26.3.
SEUS PTGI on a Mac, and the nearest thing I can offer
SEUS PTGI is an OptiFine pack last listed in 2020. On an Apple Silicon Mac on Minecraft 26.3, Rockstar Shaders traces shadows, GI and reflections in Metal.
Rockstar Shaders compared with the packs people know
Rockstar Shaders next to Complementary, BSL, SEUS PTGI, Iris, OptiFine and Bedrock ray tracing: what each is, what it needs, and what runs on a Mac.