One of the most common complaints from new Yuzu users is "stuttering" or "freezing" during gameplay.
You’ll find websites offering "complete shader caches." If you download a vulkan.bin file from a stranger with an RTX 4090 while you have an RX 6800, Yuzu will reject it. At best, it's ignored. At worst, it causes crashes, graphical corruption, or infinite loading screens.
Safe to share: Transferable caches (usually named 0000000000000000.bin or similar in the shader folder).
Not safe to share: Pipeline caches.
In Yuzu (and its forks), you’ll encounter two distinct types of shader caches. Confusing them is the #1 cause of performance issues.
| Feature | Transferable Shader Cache (.bin) | Pipeline Cache (vulkan.bin) | | :--- | :--- | :--- | | What it stores | The translated shaders (the code Yuzu created). | The GPU-specific binaries (the code your driver created). | | Portability | High. You can share this with friends. | Zero. Tied to your exact GPU model & driver version. | | File size | Smaller (MBs). | Larger (can be hundreds of MBs). | | Risk of corruption | Low. | High. Driver updates often break it. |
Incremental Compiler & Translator
Shader Pipeline Visualizer (Debug)
Shader Mods & Injection
Settings UI & Presets
Security & Integrity
Sometimes Yuzu will display an error saying the cache is invalid or corrupted.
Since compiling shaders causes stuttering, many users opt to download pre-compiled shader caches. This allows you to play a game smoothly from the start without needing to "play through" the stuttering phase.
