When launching a game with the Vulkan graphics backend, Citron crashes

Page Navigation

<aside> 📔 TABLE OF CONTENTS

</aside>

Error Details

Error Message:

None - immediate crash of the program.

no-gpu.webp

Log Entries

[  70.166135] Render.Vulkan <Error> video_core\\vulkan_common\\vulkan_instance.cpp:CreateInstance:118: Vulkan library not available
[  70.166331] Render.Vulkan <Error> video_core\\renderer_vulkan\\renderer_vulkan.cpp:RendererVulkan:133: Vulkan initialization failed with error: VK_ERROR_INITIALIZATION_FAILED
[  70.166506] HW.GPU <Error> video_core\\video_core.cpp:CreateGPU:58: Failed to initialize GPU: Vulkan initialization error VK_ERROR_INITIALIZATION_FAILED
[  70.167694] Core <Critical> core\\core.cpp:Load:352: Failed to initialize system (Error 5)!

Cause

This is caused by the program being unable to access the Vulkan Renderer of your device. This results in a fatal system exception which ultimately terminates the program. While this can affect any GPU, it has only been observed in AMD products.

Resolution Steps

Issue: Outdated Graphics Drivers

Ideally, this would be resolved by the manufacturer of your GPU with a driver update, if this is your issue.

  1. Check your manufacturer’s website for an updated driver for your GPU
    1. If the driver update did not resolve your issue, or there is no update available - proceed to the next Issue.

Issue: Faulty Vulkan DLL

If your graphics drivers are up to date and this is still an issue, you can attempt the following. This should only be done as a last resort.

  1. Navigate to the Vulkan SDK Downloads

  2. Download and extract the Vulkan Runtime Archive to somewhere on your computer for your platform.

    vulkan-runtime.png

  3. Copy this file into the C:\\Windows\\System32 directory.

    1. You will get a warning that you will have to accept as an administrator, this is normal behavior.

  4. Restart Citron, you should now be able to see your device and launch games successfully.

    gpu-found.webp

If the above steps do not help, it is possible that there is a new resolution or cause that has not been reflected in the guides. Additional help can be found in the Citron discord

Resources

Citron Website

Download Citron

Citron Source Code

Citron Discord