Log in to reply

Troubleshooting Issues such as "my addon won't run, my game crashes".

  • Section 1- Before you start
    Ask yourself, does my game run properly without mods installed – let’s call this plain vanilla mode?

    If the answer is no, it could be a bad installation or perhaps your system doesn’t meet minimum requirements (CPU, memory, graphics, OS, disk space, outdated video drivers, etc.). A corrupt saved game file can also cause unexpected crashes - and reinstalling will not generally overwrite saved games.

    And of course mods are unlikely to work with a cracked version. So if your game doesn't run "modless", this is the wrong post. You’ll likely have better luck on a Windows 10 Forum or just searching Youtube.

    How can I run my game without my mods? Simply rename the file dinput8.dll in your root/installation folder and start the game. Once you are confident it runs without issues, stable, then rename the file back (rename it whatever you want or move it out to your desktop). This process also allows you to play GTA Online.

    Take home: don’t install any mods if you can’t even run the game without mods – in other words if the game won’t run out of the box, don’t expect it to run with mods.

    Section 2 - Getting Ready
    2.1 Is your file structure correct for installing mods?
    It is strongly suggested you watch some modding videos or read some tutorials to get you ready to install your first mod. If that's the case, without going through all those necessary steps, the first thing you did was to find the folder where a file called GTA5.exe is located. This is your installation folder or game folder. (Some people call it your root folder). This folder will vary depending on whether you use Steam or Epic and also if you install GTA 5 other than in the default installation path. This is very basic stuff and beyond the scope of this post.

    2.2. Did you create all the required folders for modding?
    There are many excellent “how to videos” on youtube and many tutorials on forums as well. I’ll link to one below. We will not duplicate this information here, rather we will just provide some troubleshooting information. Your folder structure, to support mods, should look like this:

    Installation folder\mods\update\x64\dlcpacks Remember, the Installation folder is the folder where your GTA5.exe is located.

    Mods is a folder you will create to store your addons and mods. Update is a second folder (subfolder of Mods) that you will need to create. Keep in mind that your game also contains an update folder. Make sure you always work in the mods update, not the game one. X64 is another folder you needed to create (subfolder of Update). The last one is dlcpacks. Your mods/addons will end up in that final folder which you will also create.

    Just as an example, yours will look different:
    C:\SteamLibrary\steamapps\common\Grand Theft Auto V\mods\update\x64\dlcpacks\MyFastCar
    where MyFastCar is the name of your addon. It will contain a file called dlc.rpf.

    Step 2.3. Did you install Scripthook, do you have the latest version.
    Without this file, in its latest version, you will not be able to install mods. Make sure dinput8.dll, included with your download, is there as well. Both go in the installation folder where your GTA5.exe is located. This link will give you the current version:


    Step 2.4. Did you install the mod with Open IV (not Open intravenous, roman numeral 4)
    Did you follow the instructions of the mod creator, usually included in a read me text file. When using Open IV remember to always work in the mods folder. If not you will overwrite game files instead and your mods will not work.

    Step 2.5. Did you update the dlclist.xml properly in Open IV.
    Again follow the instructions that came with the mod or addon. Two important things to keep in mind. For cars and peds, the name of the addon folder and the name used to spawn the entity should be the same but there are often exceptions. Also, remember to be in your mods folder. There is another dlclist.xml in the installation folder, you don’t update that one.

    One final point and possibly the most important. Before you add your second mod, ensure your game is stable running the first one. Only then should you add your second mod. The reason behind this is that when your game crashes, and it will inevitably do so, you will be pretty sure it was the last mod installed that crashed it. So no reason to uninstall and reinstall your game and all your mods when you know it is the last one that caused the issue. Likewise, when something goes wrong, ask yourself what changes you made recently. A windows update, a game update, a new mod, and so on.

    Other references:

    1. Excellent guide for dlclist by a63nt-5m1th (yes, the one from the Matrix).

    2. A very good video for installation in general.

    1. Forum FAQ

    2. Asking for Help on the Forums

  • @JohnFromGWN Some additional information specific to Open IV.

    Note: if you're using some Addon to install mods, your path could be different. Follow the instructions of the mod creator.

    Where are my car addons?
    installation folder\mods\update\x64\dlcpacks

    Where are my ped addons?
    installation folder\mods\update\x64\dlcpacks\addonpeds\dlc.rpf\peds.rpf

    Where is my gameconfig.xml file?
    installation folder\mods\update\update.rpf\common\data

    Where is my dlclist.xml file?
    same as your gameconfig.xml
    installation folder\mods\update\update.rpf\common\data

    Finally, don't use Addon Peds mod because there is a much better, easier, and more flexible way of adding peds. Refer to this post.

    If you use the method and template from that post you will need to edit the file called peds.meta from Open IV.
    installation folder\mods\update\x64\dlcpacks\addonpeds\dlc.rpf\

    Addon Props however, is a good addon if you are creating your own props. In Open IV:
    installation folder\mods\update\x64\dlcpacks\addonprops\dlc.rpf\props.rpf\

    WARNING: Make sure, when using Open IV, or if placing mods in your folder using Windows Explorer, that you are in the mods folder and not the game folder. Both contain files with exactly the same names such as dlclist.xml, gameconfig.xml, and both have Update folders.

  • @JohnFromGWN If your game still crashes after all the steps above it is very likely because you are missing some critical files or addons.

    If you are running script addons, you will need to ensure you meet the requirements for that addon, for example ScriptHookVDotNet and a Scripts folder as well.


    If you are installing vehicles, cars, you will certainly need:

    Large map addons, MLOs, may require no boundaries addons.

    Keep in mind that there are many gameconfig file addons in the mods section and you may need to try several ones before getting the right combination. As you get more experienced you can edit those files yourself but that's pretty advanced stuff. Remember that the best thing to do is one mod at a time. Install, test, runs stable? Yes, you can install the next one.

    Please feel free to add any tips, missing information, corrections, or clarifications to this thread.

    Update after reading another posting here: It could be an issue with your Rockstar Profile if your game doesn't launch, even without Mods. I'm adding this here although as I said before, this post was meant to address issues with mods, not issues with un-modded installations.

    So, If you choose to uninstall your game (using Windows Uninstall or a software uninstaller) and reinstall your game, it is very likely that your profile folder will not be deleted and recreated. If there are corrupt files in your profile folder (ex. a saved game), that might be causing game not to load. So, when all else fails you might want to backup that folder and let the installer recreate it. Having said, make sure your game starts and runs stable before adding back any files (ex. saved games) from the backed up copy of your profile folder in case they are corrupt or causing the problem.

    Update: As we just learned from another user experience here on the forums, a corrupt saved game file can also cause your game to crash.

  • alt text

    and this what the mods folder structure will look like

    alt text

  • Update: Noticing all the issues around random crashes on the forums together with all the threads on how to tweak or even just edit critical files such as settings.xml or gameconfig.xml or dlclist.xml etc. - they are very likely related.

    If you are going to tweak/modify game settings, even your graphics settings, make sure you know what you're doing, Backup your files before tweaking, and hopefully don't make wholesale changes - in other words do one change at a time. For example, if you increase your vehicle density or a similar change, ensure your system is stable before you start making other changes.

    It's next to impossible to get help on these forums if you've made dozens of changes and don't even keep track of what has changed.

  • @JohnFromGWN Another thing I've noticed recently is that there are definitely some "bad" mods out there - either due to poor conversion, outdated, or maybe polygon counts in the millions.

    A bad vehicle model can be harder to troubleshoot because it may only crash your system as you spawn other vehicles - rarely when they are spawned alone.

  • @JohnFromGWN said in Troubleshooting Issues such as "my addon won't run, my game crashes".:

    @JohnFromGWN Another thing I've noticed recently is that there are definitely some "bad" mods out there - either due to poor conversion, outdated, or maybe polygon counts in the millions.

    A bad vehicle model can be harder to troubleshoot because it may only crash your system as you spawn other vehicles - rarely when they are spawned alone.

    This may be my problem... I'm currently trying to trouble shoot a problematic "mod", a car mod which I'm sure is the culprit of my crashing. I don't want to hijack this thread with the plethora of questions I have but, I will agree with your statement on trouble shooting bad models.

  • Unbelievable number of issues after the new update - and everyone is creating their own threads.

    Reinstalling the game is not the solution, very rarely is. What is more likely is that that your mods are no longer reflected in dlclist.xml because you overwrote update.rpf in your mods folder based on what OpenIV told you to do or you need a new gameconfig (which is now available).

    So check your dlclist.xml, in your mods folder, to make sure it is complete and intact.

    For those who have issues without the update, this post should be a good start.

Log in to reply

Looks like your connection to GTA5-Mods.com Forums was lost, please wait while we try to reconnect.