Troubleshooting Guide: Difference between revisions

From Vintage Story Wiki
Line 24: Line 24:


'''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. ''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 for the backup, the backup process will also need plenty 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.<br><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 for the backup, the backup process will also need space on the hard drive where your Temp files folder is located.''


'''NullReferenceException in Entity*.FromBytes()'''<br>
'''NullReferenceException in Entity*.FromBytes()'''<br>
Line 30: Line 30:


'''Out of Memory exception'''<br>
'''Out of Memory exception'''<br>
The game ideally needs at least 4GB of free RAM to run properly.  If you have limited RAM on your computer (e.g. 4GB or 8GB), try closing down your browser and other applications while playing the game. ''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.''
The game ideally needs at least 4GB of free RAM to run properly.  If you have limited RAM on your computer (e.g. 4GB or 8GB), try closing down your browser and other applications while playing the game.<br><br>''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===
If you keep experiencing screen freezes after playing for a few seconds or a few minutes (can be an issue with some Intel Iris or Intel HD integrated graphics, common on modern laptops) try switching off some of the visual effects like God Rays, SSAO, Bloom and Foam & Shiny Effect in the game's graphics settings - or generally just try easier graphics settings like "Low".  The graphics settings are accessible through Settings in the main menu, before you start playing a game.  There appears to be no specific cause for these screen freezes, just that the laptop's GPU is overwhelmed.<br><br>
''If your screen freezes but the mouse still works, you may still be able to exit the game by hitting the Esc key, then moving your mouse pointer to the center of the screen where the 'Save and Exit Game' button would normally be seen - try clicking around that area and listening for a button-click sound.  You will then also need to exit the main menu by looking for the Quit button on the left side of your screen in the same way.''


===Game Runs Slow===
===Game Runs Slow===


* 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.
* 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.
* If you're playing on a laptop which has both integrated and dedicated video cards, be sure that Vintage Story is set to use the dedicated card in your gpu's driver utility program. 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.
* Lower the quality settings in the Graphics options.
* Lower the quality settings in the Graphics options.
* Ensure your system meets the minimum requirements
* Ensure your system meets the minimum requirements
Line 41: Line 46:
* 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
* Close other programs to free up resources
* 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)
* 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 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.
* 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 significant resources.
* Mods can use significant resources.
* Check that the system is not overheating or thermal throttling.
* Check that the system is not overheating or thermal throttling.
* 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.


===CPU or GPU runs too hot===
* The main way to control CPU and GPU usage is using the '''Vsync''' and '''Max FPS''' settings in the graphics settings.
* One path to optimise both: pick a framerate you want e.g. 60 fps.  Now with '''VSync''' off and '''Max FPS''' unlimited, adjust the graphics settings that heavily affect framerate (view distance, godrays & bloom, shadows, SSAO) to hit a framerate that's about 15%-20% better than you want, e.g. 70 fps or 80 fps.  When the game can comfortably hit that, now set '''Max FPS''' to 60fps and '''VSync''' to 'On + Sleep'.  This should produce a stable 60fps, a smooth game with no lag spikes, and less than 100% CPU and GPU usage so that your fans run quiet.
* The Occlusion Culling graphics setting is recommended on modern multi-core CPUs - it uses one additional CPU thread but leads to less work for the GPU.


===Multiplayer lag / Host not responding messages ===
===Multiplayer lag / Host not responding messages ===
Line 52: Line 62:
* Vintage Story currently can have latency issue if players connect from a different continent to where the server is hosted
* Vintage Story currently can have latency issue if players connect from a different continent to where the server is hosted
* If you are the server owner:
* If you are the server owner:
** The Server might be struggling. Be sure to meet the servers minimum requirements. Many concurrent players requires extra hardware.
** The Server might be struggling. Be sure to meet the server's minimum requirements. Many concurrent players requires extra hardware.
** Also check out the [[Debugging]] page.
** Also check out the [[Debugging]] page.


Confirmedusers, editor
345

edits