Troubleshooting Guide: Difference between revisions

From Vintage Story Wiki
Marked this version for translation
(Marked this version for translation)
(Marked this version for translation)
(13 intermediate revisions by one other user not shown)
Line 15: Line 15:
<!--T:5-->
<!--T:5-->
'''Do you have mods installed?'''<br>
'''Do you have mods installed?'''<br>
We encourage modding Vintage Story - see the amazing mods on the [https://mods.vintagestory.at/list/mod Mod DB].  But using 3rd-party mods may possibly cause issues with the game, especially if the mod is not updated for the current Vintage Story game version you are playing.  Generally if updating Vintage Story to a new version like 1.15, you should also update all of your mods at the same time (though, some mods are fine with game updates).  Checking that mods aren't the source of the problem is a good place to start.  See if an update for the mod is available, generally you should use the latest version.  Check the Mod DB comments and forum page for the mod, or talk to other players using the mod.  If disabling mods, you should keep the Vintage Story "vanilla" mods enabled, that's Creative, Essentials and Survival!
We encourage modding Vintage Story - see the amazing mods on the [https://mods.vintagestory.at/list/mod Mod DB].  But using 3rd-party mods may possibly cause issues with the game, especially if the mod is not updated for the current Vintage Story game version you are playing.  Generally if updating Vintage Story to a new version like 1.16.5, you should also update all of your mods at the same time (though, some mods are fine with game updates).  Checking that mods aren't the source of the problem is a good place to start.  See if an update for the mod is available, generally you should use the latest version.  Check the Mod DB comments and forum page for the mod, or talk to other players using the mod.  If disabling mods, you should keep the Vintage Story "vanilla" mods enabled, that's Creative, Essentials and Survival!


<!--T:6-->
<!--T:6-->
Line 34: Line 34:
<!--T:10-->
<!--T:10-->
'''Out of Memory exception'''<br>
'''Out of Memory exception'''<br>
The game needs around 3 GB of free RAM to run smoothly, more if you only have integrated graphics. 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 settings.
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.
 
<!--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.


<!--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.''
<!--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]
Please install the [https://dotnet.microsoft.com/en-us/download/dotnet-framework/thank-you/net462-web-installer .net Runtime 4.6.2]
<!--T:12-->
Tip: ''Some extreme gameplay actions and settings (e.g. fast travel across the map, with 1024 view distance and other settings maximised) 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 extreme RAM issues because the server and the game client then each have their own memory space.''


===Screen Freezes=== <!--T:13-->
===Screen Freezes=== <!--T:13-->
Line 52: Line 55:


<!--T:16-->
<!--T:16-->
* The game might be using the wrong videocard. Make sure your monitor is plugged into the dedicated graphics card on the back of your PC.
* Lower the quality settings in the Graphics options. Really. Lower them right down, make sure performance is OK at low settings, then increase / re-enable individual settings to see if the performance you want can be maintained.
* In the Graphics options, the game can run slow if the resolution is higher then 100% (check that first!)  High view distances, God Rays, SSAO and high quality shadows all have a big effect on framerate.
* The game might be using the wrong videocard. Make sure your monitor is connected to the dedicated graphics card on the back of your PC.
* Modern laptops generally run everything faster if they are plugged in; if unplugged, they slow everything down to conserve the battery.
* Modern laptops generally run everything faster if they are plugged in; if unplugged, they slow everything down to conserve the battery.
* On a laptop with both Integrated and High-performance GPU (e.g. Intel and Nvidia) make sure it is using the High-performance GPU.  There may be Nvidia Control Panel settings for this.  See also [https://nvidia.custhelp.com/app/answers/detail/a_id/2615/~/how-do-i-customize-optimus-profiles-and-settings%3F NVIDIA Optimus Profile].
* On a laptop with both Integrated and High-performance GPU (e.g. Intel and Nvidia) make sure it is using the High-performance GPU.  There may be Nvidia Control Panel settings for this.  See also [https://nvidia.custhelp.com/app/answers/detail/a_id/2615/~/how-do-i-customize-optimus-profiles-and-settings%3F NVIDIA Optimus Profile].
* '''On a Windows 10 laptop, make sure the Windows battery / power mode setting is set to 'Best performance'.  Click the battery icon to see this.'''  Especially do not use the 'best battery life' setting, this overrides most other settings on your computer and causes Vintage Story to run very slowly.
* '''On a Windows 10 laptop, make sure the Windows battery / power mode setting is set to 'Best performance'.  Click the battery icon to see this.'''  Especially do not use the 'best battery life' setting, this overrides most other settings on your computer and causes Vintage Story to run very slowly.
* Lower the quality settings in the Graphics options.
* Ensure your system meets the minimum requirements
* Ensure your system meets the minimum requirements
* Windows Update or Windows Defender might be active in the background doing updates or scans
* Windows Update or Windows Defender might be active in the background doing updates or scans
Line 62: Line 66:
* Antivirus/anti-malware/firewall programs may be affecting performance
* Antivirus/anti-malware/firewall programs may be affecting performance
* Close other programs to free up resources. Force unnecessary background programs to exit (or don't let them start at all...)
* Close other programs to free up resources. Force unnecessary background programs to exit (or don't let them start at all...)
* Please ensure the system is sufficiently cooled as some systems slow down if they get too hot. (Make sure air vents are not covered and cooling elements and fans are free from dust for example; if you have a laptop, raise it off the desk slightly so it has better airflow underneath it.)
* Please ensure the system is sufficiently cooled as some systems slow down if they get too hot. (Make sure air vents are not covered and cooling elements and fans are free from dust; if you have a laptop, raise it off the desk slightly so it has better airflow underneath it; do not use a laptop for gaming on a bed or other soft furnishings which hinder cooling!)
* Please ensure a sufficiently rated power supply is used.  Gaming on battery power is not recommended on laptops as they might choose to run slower in a lower power mode.  If you need to play on battery mode, you can extend the playable battery life by reducing the Max FPS to 30 fps and using VSync mode 'On + Sleep' in Vintage Story's graphics settings.
* Please ensure a sufficiently rated power supply is used.  Gaming ''on battery power'' is not recommended on laptops as they might choose to run slower in a lower power mode.  If you need to play on battery mode, you can extend the playable battery life by reducing the Max FPS to 30 fps and using VSync mode 'On + Sleep' in Vintage Story's graphics settings.
* Mods can use additional resources: fancy shader mods really need a high-powered gaming rig.
* Mods can use additional resources: fancy shader mods really need a high-powered gaming rig.
* Check that the system is not overheating or thermal throttling - see [[Framerate and Performance]].
* Check that the system is not overheating or thermal throttling - see [[Framerate and Performance]].
* Please do not run the game from an external drive or network share.
* Please do not run the game from an external drive or network share.
* Running on a virtual machine (VM) may also cause performance issues.
* Running on a virtual machine (VM) may also cause performance issues.
* Some people have reported that Windows 10 update version 2004 causes lag issues in games (especially in "Game Mode" in Windows Settings); if you have the choice, we recommend Windows 10 version 1903.
* The game requires 4GB of free memory (RAM) - or perhaps more like 6 GB if playing on a laptop with integrated graphics.  You can look in Task Manager how much you have before you start the game.  More RAM than that will not help greatly (except by ensuring that other system processes do not impact on Vintage Story's memory needs).  Exception: if you want to run a local Vintage Story server on the same computer - which can help performance - then you need 8GB of free memory.
* Some people have reported that Windows 10 update version 2004 causes lag issues in games (especially in "Game Mode" in Windows Settings); if you have the choice, we recommend Windows 10 version 1903 as the most stable Windows 10 version for gaming.
* If you're playing multiplayer, it's best to be in the same geographic region as the server you are playing on. See next section below.
* If you're playing multiplayer, it's best to be in the same geographic region as the server you are playing on. See next section below.


Line 75: Line 80:
<!--T:18-->
<!--T:18-->
* Vintage Story currently can have latency issues if players connect from a different continent to where the server is hosted
* Vintage Story currently can have latency issues if players connect from a different continent to where the server is hosted
* In game version 1.16.5, there are reports that a mod (we do not know which one!) can cause multiplayer connection issues or disconnects.  If playing with a large mod list and you have connection issues and you have control over the mods on the server as well, try reducing the mod list (for both the server and the players) until the issue is fixed: as a start, test whether you can connect to the server with no mods except Vintage Story's "vanilla" mods Survival, Creative and Essential
* If you are the server owner:
* If you are the server owner:
** The Server might be struggling. Be sure to meet the server's minimum requirements. Many concurrent players requires extra hardware. You can also try adjusting the Magic Numbers on the server.
** The Server might be struggling. Be sure to meet the server's minimum requirements. Many concurrent players requires extra hardware. You can also try [[Debugging#Improving_Server_Performance|adjusting the Magic Numbers]] on the server.
** Also check out the [[Debugging]] page.
** Also check out the [[Debugging]] page.  You can use tick logging (logticks) to perhaps identify the specific cause of lag.
** Auto-save every few minutes will cause 1-2 seconds of lag when it saves.  That is unavoidable if you want to protect the game progression using auto-save (strongly recommended).  A fast CPU and a fast solid state disk system can improve this but it will always take some time.
** Generally use the latest version of the game available: Tyron and team continually make performance improvements and optimisations to Vintage Story, including specific optimisations for multiplayer servers.


===Multiplayer connection issues=== <!--T:19-->
===Multiplayer connection issues=== <!--T:19-->


<!--T:20-->
<!--T:20-->
* Make sure your Firewall does not block internet access
If you are the server owner:
* If you are hosting locally, you either need to set up port forwarding or use a VPN, like hamachi
* Make sure your Firewall does not block internet access for VintagestoryServer.exe
* Test whether another computer on your local network (Wifi or directly plugged in) can connect to the server
* If you are hosting yourself for public access - making a multiplayer server at home, for friends or others outside your home to access - you either need to [[Setting_up_a_Multiplayer_Server|set up port forwarding on your router]] or use a VPN, like hamachi
 
<!--T:28-->
If you are the player:
* Make sure your Firewall does not block internet access for Vintagestory.exe
* Make sure your game version matches the server game version: you can download an update, or download an earlier version of the game, from the Client Area / Downloads at www.vintagestory.at
* The server might have a "whitelist" of allowed players: if you are a new player not on the list, try contacting the server owner
* Test whether you are able to connect to other multiplayer servers, for example the Official Public Test Server


===AccessViolation (0xC0000005)=== <!--T:21-->
===AccessViolation (0xC0000005)=== <!--T:21-->
Line 95: Line 112:
* Overclocking processors
* Overclocking processors


==Game Server== <!--T:23-->
==Game Servers on Linux== <!--T:23-->


===Error: Garbage collector could not allocate 16384u bytes of memory for major heap section.=== <!--T:24-->
===Error: Garbage collector could not allocate 16384u bytes of memory for major heap section.=== <!--T:24-->
Confirmedusers
13,514

edits