Because not every system is the same, various problems can occur with the alt:V client. The first thing you should check if your system is meeting the Minimum Requirements, after that you should continue with the rest of this article. If nothing in this article helped, you can try to get help in our Discord.
Because alt:V is using additional technologies, we have a little bit higher Minimum Requirements, than GTA V itself. If your computer doesn't fulfill this requirements, you can still try to run alt:V but the chances are high that some problems will occur.
OS: Windows 10 64 Bit Processor: Intel Core i5 3470 @ 3.2GHz (4 CPUs)/ AMD X8 FX-8350 @ 4GHz (8 CPUs) Memory: 8 GB RAM Graphics: NVIDIA GTX 660 2GB / AMD HD 7870 2GB Storage: SSD for OS and Game
- You need to have Singleplayer launched at least once.
- Try Running as Admin
- Add an exception to your Anti-Virus for alt:V (This Includes Windows Defender).
- Avast is even blocking alt:V if you whitelist it!
- Ensure alt:V is installed in a directory that is not your Desktop, not your GTA:V Directory and the path does not include any special characters.
- Make sure Visual C++ 2015-2019 Redistributeable is installed. Downloadlink
- Ensure you've the latest drivers of all your devices, especially your graphics card
- Only use ASCII Characters in your alt:V Path.
- Keep Pathing short for alt:V ie.
- Use Windows 10.
- If the Steam version is stuck on "Load alt:V Client", try killing the Steam process(es). (Also try and remove Steam from autostart.)
- You must have a clean version of GTA V. Graphics mods like Redux or Natural Vision must not be present in your GTA V installation.
- If your game is crashing on joining a server try a server without mods (eg Freeroam servers). If its working on such server, contact the server team of the server you are crashing at.
Known Problems & Solutions
RageMP is starting
This happens when RageMP was installed in the GTA directory. You can install it afterwards in a seperate folder.
- Go to your GTA directory.
- Delete all RageMP files and folder from it.
Steam Version or Steam is launched
These steps are only for Rockstar Games Launcher and Epic Games Versions
- Go to your GTA directory
- Delete steam_api64.dll from the GTA directory
- Launch Singleplayer
- Go to Graphics Settings
- Set MSAA to Off
Webview not working
If you are stuck under the world after launching alt:V or see a grey world (Picture), then the webview from alt:V and GTA V aren't rendered on the same GPU. This can be solved by forcing Windows to render altv.exe, cef/altv-webengine.exe and gta5.exe on the same GPU. Here are some examples how this can be achieved:
For Laptops preferrably
- Press "Windows + R" on your Keyboard
- Enter "ms-settings:display-advancedgraphics" in the window which appeared
- Click on OK
- Click "Search" and select "altv.exe", "altv-webengine.exe"and "gta5.exe" one after another
- Select "Options" and select "High Performance" for both programs
NVIDIA Graphics cards
- Open NVIDIA Control Panel
- 3D Settings
- Manage 3D Settings
- Program Settings
- Add "altv.exe", "altv-webengine.exe"and "gta5.exe"
- Select the same graphics card for the Feature "OpenGL rendering GPU" for both programs.
AMD Graphics cards
- Right-Click on Desktop and select AMD Radeon Settings
- Select System
- Select Switchable Graphics
- Add "altv.exe", "altv-webengine.exe"and "gta5.exe" and select "High Performance"
- More detailed description can be found here
Signed out from Social Club
If you always get signed out of Social Club when playing alt:V, then monitor folder access from Windows is probably turned on. With these steps you can turn this feature off:
- Open windows security
- Select virus & threat protection setting
- Select controlled folder access
- Turn it off or whitelist alt:V folder
"altv-client.dll can't be loaded"
Kaspersky AntiVirus or Kaspersky Internet Security
If you are using Kaspersky AntiVirus or Kaspersky Internet Security, this can cause the "altv-client.dll can't be loaded" error to occur even though all possible exceptions have been taken. The only solution to this problem is to disable the virus scanner. Keeping the alt:V window in focus reduces the chance of the error occurring.
Another problem can be that your user don't have enough permission on the alt:V directory.
- Right click your alt:V folder and select "Properties".
- Select the tab "Security".
- Click the Button "Edit..."
- Select your user in the "Group or user names:" list.
- Select the Checkbox "Full control" under "Allow".
- Click the Button "Apply"
Mouse is trapped in middle of screen
- Launch Singleplayer of GTA V.
- Go to Mouse Settings.
- Change the mouse setting to another.
Something else hooked DirectX context. Try to shutdown programs that can do it... (Riva Tuner, Fraps, etc.)
Close Programms like Riva Tuner, Fraps or Streamlabs OBS
Failed to fetch updates
This is normally an error that occurs when your connection is interrupted while updating the alt:V client or an AntiVirus is blocking the download. Try disabling your AntiVirus, if that doesn't help try it again later.
Your game version is X, but only Y supported at the moment. Update your Game!
You need to update your GTA:V to the latest version. Try verifying game cache or figure out other ways to force update the game.
Widevine CDM registration failed
You can ignore this message as it doesn't cause any problems.
Client crashes/closes during start
This could mean program or service is blocking alt:V and causing it to crash. You should try to disable all non Microsoft related services.
- Press "Windows + R" on your Keyboard
- Enter "msconfig" in the window which appeared
- Click on OK
- Select the Tab called "Services"
- Check the box called "Hide all Microsoft services", located at the bottom of the window.
- Click the button "Disable all"
- Scroll and find "Rockstar Games Library Service" and check it.
- Click the button "Apply"
- Restart your PC
If alt:V is working, you can recheck some services, until you find the one that is causing the crashes. If you find the service that is causing the problem, please contact us on discord.
Services known to cause problems:
- NVIDIA Display Container LS
alt:V is asking for installation directory when launching from browser
This may happen if an old entry is saved as launch option in your browser.
- Press the Menu Button (Burger Menu)
- Select "Options"
- Select "General" on the left side
- Scroll to "Files and Applications"
- At "Applications" section select the entry "altv"
- At "Action" column select "Always ask"
- The next time you will be asked if you want to use the new entry.