Troubleshooting Guide: Difference between revisions
From Vintage Story Wiki
Mirotworez (talk | contribs) (add translate tag) |
Mirotworez (talk | contribs) (Marked this version for translation) |
||
| Line 1: | Line 1: | ||
<languages/><translate> | <languages/><translate> | ||
<!--T:1--> | |||
__TOC__ | __TOC__ | ||
<!--T:2--> | |||
Having trouble getting the game to run correctly? Here's a list of common problems and fixes. | Having trouble getting the game to run correctly? Here's a list of common problems and fixes. | ||
==Game Client== | ==Game Client== <!--T:3--> | ||
===Game is crashing=== | ===Game is crashing=== <!--T:4--> | ||
'''Did you recently update Vintage Story?''' | '''Did you recently update Vintage Story?''' | ||
Vintage Story releases new updates several times each year. Normally updates add new features and fix older bugs, but very occasionally something breaks in the process. You could try asking other players on Discord, or if all else fails, try re-installing a previous version of Vintage Story which was stable. If you are playing with mods and you update Vintage Story without also updating the mods, some of the mods may have issues: see the next question! | Vintage Story releases new updates several times each year. Normally updates add new features and fix older bugs, but very occasionally something breaks in the process. You could try asking other players on Discord, or if all else fails, try re-installing a previous version of Vintage Story which was stable. If you are playing with mods and you update Vintage Story without also updating the mods, some of the mods may have issues: see the next question! | ||
<!--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.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! | ||
<!--T:6--> | |||
Tip: ''If there's a crash report and in the report the top line of the code ends with _patch0 or similar (look for the word patch!) then it's probably a mod issue.'' | Tip: ''If there's a crash report and in the report the top line of the code ends with _patch0 or similar (look for the word patch!) then it's probably a mod issue.'' | ||
<!--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. | ||
<!--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.<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.'' | ||
<!--T:9--> | |||
'''NullReferenceException in Entity*.FromBytes()'''<br> | '''NullReferenceException in Entity*.FromBytes()'''<br> | ||
Load your savegame in repair mode, fly to the crashing spot, leave the world and run the game normally again. | Load your savegame in repair mode, fly to the crashing spot, leave the world and run the game normally again. | ||
<!--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 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. | ||
<!--T:11--> | |||
'''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.'' | 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=== | ===Screen Freezes=== <!--T:13--> | ||
If you sometimes experience 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. The game is intended to run well and be fully playable on standard laptops, as long as the graphics settings are suitable. There is no shame in using "Low" or "Medium" graphics settings on a laptop, the game still looks great with these settings.<br> | If you sometimes experience 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. The game is intended to run well and be fully playable on standard laptops, as long as the graphics settings are suitable. There is no shame in using "Low" or "Medium" graphics settings on a laptop, the game still looks great with these settings.<br> | ||
<!--T:14--> | |||
''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 may then also need to exit the main menu by looking for the Quit button on the left side of the menu screen in the same way.'' | ''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 may then also need to exit the main menu by looking for the Quit button on the left side of the menu screen in the same way.'' | ||
===Game Runs Slow=== | ===Game Runs Slow=== <!--T:15--> | ||
<!--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. | * 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. | ||
* 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. | ||
| Line 59: | Line 71: | ||
* 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. | ||
===Multiplayer lag / Host not responding messages === | ===Multiplayer lag / Host not responding messages === <!--T:17--> | ||
<!--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 | ||
* If you are the server owner: | * If you are the server owner: | ||
| Line 66: | Line 79: | ||
** Also check out the [[Debugging]] page. | ** Also check out the [[Debugging]] page. | ||
===Multiplayer connection issues=== | ===Multiplayer connection issues=== <!--T:19--> | ||
<!--T:20--> | |||
* Make sure your Firewall does not block internet access | * Make sure your Firewall does not block internet access | ||
* If you are hosting locally, you either need to set up port forwarding or use a VPN, like hamachi | * If you are hosting locally, you either need to set up port forwarding or use a VPN, like hamachi | ||
===AccessViolation (0xC0000005)=== | ===AccessViolation (0xC0000005)=== <!--T:21--> | ||
<!--T:22--> | |||
Access Violation error could be triggered for a variety of reasons. | Access Violation error could be triggered for a variety of reasons. | ||
A few possible causes: | A few possible causes: | ||
| Line 80: | Line 95: | ||
* Overclocking processors | * Overclocking processors | ||
==Game Server== | ==Game Server== <!--T:23--> | ||
===Error: Garbage collector could not allocate 16384u bytes of memory for major heap section.=== | ===Error: Garbage collector could not allocate 16384u bytes of memory for major heap section.=== <!--T:24--> | ||
<!--T:25--> | |||
If your server is on a Linux system, run <code>sudo sysctl -w vm.max_map_count=262144</code> | If your server is on a Linux system, run <code>sudo sysctl -w vm.max_map_count=262144</code> | ||
<!--T:26--> | |||
--- | --- | ||
Original version of this page inspired by [https://steamcommunity.com/sharedfiles/filedetails/?id=1620515354 Staxels Troubleshooting guide]. | Original version of this page inspired by [https://steamcommunity.com/sharedfiles/filedetails/?id=1620515354 Staxels Troubleshooting guide]. | ||
</translate> | </translate> | ||
