Troubleshooting Guide: Difference between revisions

From Vintage Story Wiki
No edit summary
No edit summary
Line 39: Line 39:
<!--T:7-->
<!--T:7-->
'''Are you on the latest Graphics drivers?'''<br>
'''Are you on the latest Graphics drivers?'''<br>
Updating graphics drivers may help if there are visual issues or graphics (OpenGL) related crashes. Vintage Story uses many OpenGL features. Vintage Story also makes heavy use of shaders.
Updating graphics drivers may help if there are visual issues or graphics (OpenGL) related crashes. Vintage Story uses many OpenGL features. Vintage Story also makes heavy use of shaders. Try an OpenGL test program (FurMark, OpenGLChecker, GpuTest etc) to make sure that OpenGL is generally working properly on your system.


<!--T:8-->
<!--T:8-->
'''Do you have enough hard disk space?'''<br>
'''Do you have enough hard disk space?'''<br>
The game will crash if you run out of disk space during a save, and likely also corrupt your savegame.  A Vintage Story savegame varies in size depending on how much of the map you have explored, it could be a few GB in size.<br>''If you update game versions, and the 'remapping' dialog pops up asking if you want to make a backup (backup enabled by default), make sure you have plenty of disk space free for the backup, the backup process will need a lot of space on the hard drive where your Temp files folder is located.''
The game will crash if you run out of disk space during a save, and likely also corrupt your savegame.  A Vintage Story savegame varies in size depending on how much of the map you have explored, it could be a few GB in size.  It's best to have plenty of disk space free.<br>''If you update game versions, and the 'remapping' dialog pops up asking if you want to make a backup and you choose to backup, make sure you have plenty of disk space free for the backup, the backup process will need a lot of space on the hard drive where your Temp files folder is located.''


<!--T:9-->
<!--T:9-->
Line 51: Line 51:
<!--T:10-->
<!--T:10-->
'''Out of Memory exception'''<br>
'''Out of Memory exception'''<br>
The game needs around 4 GB of free RAM to run smoothly, or more than that if you use integrated graphics (because it uses system memory as GPU memory). You can try to free up memory by closing all other applications, setting the in-game viewing distance lower, setting the music volume to 0 and set RAM optimization to "aggressive" in the game's graphics settings. If your computer does not have 4 GB of free RAM, you can perhaps still play on minimum settings, for example a view distance of 96 or less.
The game needs at least 4 GB of available (free) RAM to run smoothly, or more than that if you use integrated graphics (because integrated graphics uses system memory as GPU memory), we recommend at least 8-16GB free. You can try to free up memory by closing all other applications, setting the in-game viewing distance lower, setting the music volume to 0 and set RAM optimization to "aggressive" in the game's graphics settings. If your computer does not have 4 GB of free RAM, you can perhaps still play on minimum settings, for example a view distance of 96 or less.


<!--T:27-->
<!--T:27-->
A graphics card can also run out of memory, causing the game to crash. Possible causes include: other active games or processes on your computer which also use graphics card resources (including some webpages or video players); two copies of Vintage Story running at the same time; a previous hard crash of any game or application such that graphics resources were not properly freed (try re-starting your system!); ultra-high view distances; fancy shader mods. If it happens repeatedly without any of these causes and even after re-starting your system, then try reducing graphics settings in Vintage Story: you can access the settings from the Main Menu before starting the game.
A graphics card can also run out of memory, causing the game to crash. Possible causes include: lack of system memory (the graphics card sometimes checks that at least 2GB of system memory are free); other active games or processes on your computer which also use graphics card resources (including some webpages or video players); two copies of Vintage Story running at the same time; a previous hard crash of any game or application such that graphics resources were not properly freed (try re-starting your system!); ultra-high view distances; fancy shader mods; video recording while playing the game. If it happens repeatedly without any of these causes and even after re-starting your system, then try reducing graphics settings in Vintage Story: you can access the settings from the Main Menu before starting the game.


<!--T:11-->
<!--T:11-->
Pro tip: ''Some extreme gameplay actions and settings (e.g. fast travel across the map, with 1024 view distance and other settings maximised; huge modlists) could make the game run out of memory even on a powerful PC with plenty of RAM. If this is you, try setting up your game as a dedicated local server on your own PC, and connect to it (127.0.0.1) as if connected to a multiplayer game: this helps with performance on extreme settings because the server and the game client then each have their own memory space.  Or set up a multiplayer server on a separate system.''
Pro tip: ''Some extreme gameplay actions and settings (e.g. fast travel across the map, with 1024 view distance and other settings maximised; huge modlists) could make the game run out of memory even on a powerful PC with plenty of RAM. If this is you, try setting up your game as a multiplayer server on a separate computer system either on your local network, or a hosted multiplayer server.''


<!--T:12-->
<!--T:12-->
'''System.MissingMethodException: Method not found: '!!0[]'''<br>
'''System.MissingMethodException: Method not found: '!!0[]'''<br>
Please install the [https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net462-web-installer .net Runtime 4.6.2]
This is relevant only to older (pre. 1.18.8) versions of Vintage Story.  Please install the [https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net462-web-installer .net Runtime 4.6.2].  On newer versions of Vintage Story you should be using the .Net 7 runtime from Microsoft.


'''System.DllNotFoundException: Unable to load DLL 'glfw''''<br>
'''System.DllNotFoundException: Unable to load DLL 'glfw''''<br>