🤪 Unexpected Behavior

Launcher empty or crash

  • Try logging out and back in, or reset the launcher by pressing Ctrl+Shift+Alt+R
  • Delete the rsilauncher directory in the wine prefix’s Appdata
    star-citizen/drive_c/users/<your username here>/AppData/Roaming/rsilauncher
  • If using Pop!_OS Cosmic, this is a known issue.
    • Try using the LUG Helper’s Open Wine prefix configuration
      option in the Maintenance menu to turn on virtual desktop mode
    • Try xwayland-run package
      ############################################################################
      # Launch the game
      ############################################################################
      xwayland-run -- "$wine_path"/wine "C:\Program Files\Roberts Space Industries\RSI Launcher\RSI Launcher.exe" > "$launch_log" 2>&1
      
    • Try switching to Experimental Wine Wayland
    • Try gamescope, or an alternative compositor

Launcher indicates You are currently offline

  • Log out and back in

Launch Error - Settings.json not found

  • Verify game files

RSI Launcher Error Code 60101

Launch Error - %AppData% returned empty string

  • Open a Wine maintenance shell then type wineserver -k to 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
  • Check that custom firewall rules on your host or router are not blocking outbound traffic to non-HTTP(S) ports

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
    image
  • If your system has an integrated gpu (ie, Intel), check that the Vulkan device is not set to the integrated gpu:
    • 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=1 and observing the device name in the upper left of the screen
  • Make sure your GPU drivers (Mesa/nvidia) are up to date
    • For AMD, be sure to use the open source radeon drivers (ie. vulkan-radeon), not the proprietary drivers (ie. amdvlk)
  • If using DX11 rendering instead of Vulkan, make sure DXVK is enabled/updated:
  • 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_VIDEODRIVER environment variable is NOT set globally to wayland on 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_VIDEODRIVER to the environment variables section

Infinite loading screen after clicking ‘Launch’

  • The game servers may be overloaded, especially after a new release.
  • If launching the game for the first time with a webcam plugged in, try unplugging the webcam, relaunching, then connecting it.

Black or white RSI Launcher window

  • Try editing the launch script to add the RSI Launcher flag --in-process-gpu. For example:
      "$wine_path"/wine "C:\Program Files\Roberts Space Industries\RSI Launcher\RSI Launcher.exe" --in-process-gpu > "$launch_log" 2>&1
    

Black game window after clicking ‘Launch’

  • Check our latest news for gpu driver issues or temporary workarounds.
  • Contribute to STARC-197175 (public) and STARC-189885 (evocati only), then use the LUG Helper to switch to a LUG Experimental Wine runner.
  • If using DX11 instead of Vulkan, make sure DXVK is installed and up to date.
  • If using Vulkan, you may need to revert to DX11 by creating a USER.cfg file.
  • If using lsfg-vk for frame gen, use LUG Wine Experimental or revert to DX11.
  • If using gamescope, you may need to disable it or double check your configuration.
  • If using a webcam, make sure V4L is installed (video 4 linux, package names may be similar to v4l-utils). If using V4L2 Loopback, try removing any loopback devices you have created.

Blackout or black screen on Vulkan when flying/boosting/braking/damaged

Laggy game when using Picom or Compton Compositors

  • If you use the Picom or Compton compositor, it may cause a laggy experience despite having high framerates. We recommend disabling the compositor.