🤪 Unexpected Behavior
Empty launcher
- Try logging out and back in, or reset the launcher by pressing Ctrl+Shift+Alt+R
- Wine >=10.17 may cause launcher rendering issues. The launcher may be empty or only show the background video, music may work, and buttons are invisible.
- Use the LUG Helper to install a LUG-Wine runner
10.16or10.15.
- Use the LUG Helper to install a LUG-Wine runner
- If using the Cosmic DE beta, this is a known issue. Try using the LUG Helper’s
Open Wine prefix configurationoption in the Maintenance menu to turn on virtual desktop mode.
Launcher indicates You are currently offline
- Log out and back in
Launch Error - Settings.json not found
- Verify game files
Launch Error - %AppData% returned empty string
- Open a Wine maintenance shell then type
wineserver -kto terminate all lingering Wine processes. - If that doesn’t resolve it, try switching to a different Wine runner.
- Check that you haven’t changed the default install path in the RSI Launcher settings.
Visual glitches or semi-transparent lines, poor performance, possibly random crashes
- DXVK may be broken or disabled. Reinstall it using the LUG Helper DXVK and maintenance menus
- Your game shader cache may need to be cleared. Use the Delete Shaders option in the RSI Launcher > Settings > Games > {LIVE,PTU} > Delete Local Settings > Shaders folder
Account login failed (possible code 19000)
This is a generic error code representing any issue with logging in to CIG servers
- Expected when attempting launch/login during a patch release
- Kill the launcher and restart it and try again
- Ensure that IPv6 is not disabled
Required Vulkan Extensions are missing error / poor performance compared to windows / error code 3
- Check if you have amdvlk installed by running
vulkaninfo --summary. The vulkaninfo utility is part of the packagevulkan-toolson most distros. You can also check your package manager. - If your system is using amdvlk, uninstall that package and replace it with
vulkan-radeon. - For additional help with this, ask in our Discord tech support channel.
DirectX error message
- Error may read
Star Citizen requires DirectX feature level of 11.1 as a minimum which is not supported at present on this machine

- Check that the
Vulkan deviceis not set to an integrated gpu (ie, Intel)- Identify device name using command
vulkaninfo --summary | grep deviceName - Edit the launch script and set the device name environment variable:
DXVK_FILTER_DEVICE_NAME=yourdevicenamehere - Verify by setting the environment variable
DXVK_HUD=1and observing the device name in the upper left of the screen
- Identify device name using command
- Also make sure your GPU drivers (Mesa/nvidia) are up to date and DXVK is enabled/updated.
- Use the LUG Helper to update dxvk
- For AMD, be sure to use the open source radeon drivers (ie. vulkan-radeon), not the proprietary drivers (ie. amdvlk)
- Try switching to a non-staging wine runner from our recommended runners list
- Try downgrading to an older DXVK version
Failed to initialize dependencies error
- Make sure the
SDL_VIDEODRIVERenvironment variable is NOT set globally towaylandon your system:env | grep SDL_VIDEODRIVER - If it is set, remove it from whichever environment config(s) is setting it.
- Edit the launch script and add
unset SDL_VIDEODRIVERto the environment variables section
Black or flickering window, possible crash with errors 15006 or 30007
- Check for larger resolutions and scaling settings. See CIG’s support article
Black/transparent window after clicking ‘Launch’
- Check our latest news for gpu driver issues, necessary workarounds, and currently recommended runner/DXVK versions.
- Make sure DXVK is installed and enabled
Launcher crashes/hangs after entering login info when running Niri WM and/or xwayland-satellite
- See upstream issue report
- Workarounds: Use xwayland-run, gamescope, an alternative to xwayland-satellite, or an alternative compositor.