Difference between revisions of "Troubleshooting"
m (→Game Won't Start (Linux)) |
|||
(6 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | =Connection To Server has Timed Out (Singleplayer)= | + | ==Connection To Server has Timed Out (Singleplayer)== |
'''Problem:''' You try to start a singleplayer game and you get the message "connection to server has timed out". | '''Problem:''' You try to start a singleplayer game and you get the message "connection to server has timed out". | ||
Line 8: | Line 8: | ||
'''Possible Causes:''' | '''Possible Causes:''' | ||
* AntiVirus software is blocking communication between {{file|vtclient.exe}} and {{file|vtserver.exe}} (this has been confirmed to happen with McAffee and Comodo). | * AntiVirus software is blocking communication between {{file|vtclient.exe}} and {{file|vtserver.exe}} (this has been confirmed to happen with McAffee and Comodo). | ||
− | |||
* The server is hanging (it gets busy and loses the connection). After the timeout you can still find vtserver.exe running in the Task Manager | * The server is hanging (it gets busy and loses the connection). After the timeout you can still find vtserver.exe running in the Task Manager | ||
− | |||
* The server is crashing (either due to a lua script error or an application error). You may get a "vtserver has stopped working" message if windows feels like displaying one | * The server is crashing (either due to a lua script error or an application error). You may get a "vtserver has stopped working" message if windows feels like displaying one | ||
'''Work Arounds:''' | '''Work Arounds:''' | ||
* Antivirus: Either disable it or whitelist {{file|vtclient.exe}} and {{file|vtserver.exe}} | * Antivirus: Either disable it or whitelist {{file|vtclient.exe}} and {{file|vtserver.exe}} | ||
− | |||
* Server Hanging or Crashing: Email me your crash logs (find them in the {{file|Voxel Turf/logs/}} directory) (please zip everything in the folder!) to voxelturf AT gmail DOT com | * Server Hanging or Crashing: Email me your crash logs (find them in the {{file|Voxel Turf/logs/}} directory) (please zip everything in the folder!) to voxelturf AT gmail DOT com | ||
− | =Connection To Server has Timed Out (Multiplayer)= | + | ==Connection To Server has Timed Out (Multiplayer)== |
* First verify that the game works in singleplayer (both for the host and the joiner) | * First verify that the game works in singleplayer (both for the host and the joiner) | ||
− | |||
* See if you can connect to other multiplayer servers. | * See if you can connect to other multiplayer servers. | ||
− | |||
* If you can't connect to any of them then you my be behind a [https://en.wikipedia.org/wiki/Network_address_translation#Symmetric_NAT Symmetric NAT] and will then have to [[Port Forwarding|Set Up Port Forwarding]] to get a connection. | * If you can't connect to any of them then you my be behind a [https://en.wikipedia.org/wiki/Network_address_translation#Symmetric_NAT Symmetric NAT] and will then have to [[Port Forwarding|Set Up Port Forwarding]] to get a connection. | ||
− | |||
* Check that {{file|vtclient.exe}} and {{file|vtserver.exe}} are not blocked by windows firewall. | * Check that {{file|vtclient.exe}} and {{file|vtserver.exe}} are not blocked by windows firewall. | ||
− | =Game Crashes On Start (vtclient.exe has stopped working, Windows)= | + | ==Game Crashes On Start (vtclient.exe has stopped working, Windows)== |
'''Problem:''' Game crashes when it is started. | '''Problem:''' Game crashes when it is started. | ||
Line 34: | Line 28: | ||
'''Fix:''' Check that you are running Intel Graphics drivers. One way to check is to open the logs directory ({{file|Voxel Turf/logs/}}) and open {{file|glinfo.txt}}. If you see something like <tt>GL_VENDOR: Intel (blah)</tt> then you're running intel drivers. You can update your drivers by going to https://downloadcenter.intel.com/product/80939/Graphics-Drivers | '''Fix:''' Check that you are running Intel Graphics drivers. One way to check is to open the logs directory ({{file|Voxel Turf/logs/}}) and open {{file|glinfo.txt}}. If you see something like <tt>GL_VENDOR: Intel (blah)</tt> then you're running intel drivers. You can update your drivers by going to https://downloadcenter.intel.com/product/80939/Graphics-Drivers | ||
− | =Game | + | ==Could Not Connect To Server: Version or Checksum Mismatch (Multiplayer)== |
+ | '''Problem:''' Can't join a multiplayer game due to checksum or version. You may see the error message "Connection to server refused, checksum mismatch", or "Connection to server refused, Version mismatch". | ||
+ | |||
+ | '''Cause:''' Every patch of the game has a different version. The game also computes a checksum of all the lua scripts loaded by the client (as in all files in {{file|scripts/common/}} and {{file|scripts/client}}, and any mods that add client scripts). This is to insure that both the clients and the host are in sync. | ||
+ | |||
+ | '''Fix:''' First verify that both you the host and the client are playing the same version of the game (for example, version 1.2.3). Then verify that you have the same client script mods installed, disabling or uninstalling them if you are unsure. | ||
+ | |||
+ | [[LotPacks]], texture mods and sound mods do NOT affect the checksum, players with different LotPacks, texture mods or sounds mods can play on the same servers. | ||
+ | |||
+ | ==Game Launch Issues (Steam)== | ||
+ | ===Windows=== | ||
+ | '''Problem 1:''' Clicking "Play" on Steam does nothing | ||
+ | |||
+ | '''Problem 2:''' You can run vtclient.exe from the game folder and it launches, but steam can't launch it | ||
+ | |||
+ | |||
+ | '''Cause:''' vtserver.exe has failed to close, making steam think the game is running even though vtclient.exe has shut down. | ||
+ | |||
+ | '''Fix:''' Reboot your machine, or kill vtserver.exe from task manager | ||
+ | |||
+ | |||
+ | '''Cause:''' Steam is derping around | ||
+ | |||
+ | '''Fix:''' Try rebooting/closing and restarting steam? | ||
+ | |||
+ | ===Linux=== | ||
'''Problem 1:''' Clicking "Play" on Steam does nothing | '''Problem 1:''' Clicking "Play" on Steam does nothing | ||
'''Problem 2:''' Running vtserver does nothing | '''Problem 2:''' Running vtserver does nothing | ||
Line 51: | Line 70: | ||
Try running {{file|./vtclient --steam}} or {{file|./vtserver}} from the command line in the install directory to see what errors (if any) appear. | Try running {{file|./vtclient --steam}} or {{file|./vtserver}} from the command line in the install directory to see what errors (if any) appear. | ||
− | = | + | ==FPS issues (AMD Graphics Cards on Linux)== |
'''Problem:''' VERY bad framerate on AMD with shaders enabled. | '''Problem:''' VERY bad framerate on AMD with shaders enabled. | ||
Line 62: | Line 81: | ||
'''Note:''' Since version 1.0.8 this has been fixed on windows. | '''Note:''' Since version 1.0.8 this has been fixed on windows. | ||
− | =Flickering Screen= | + | ==Flickering Screen== |
'''Problem:''' Screen flashes black when in fullscreen mode | '''Problem:''' Screen flashes black when in fullscreen mode | ||
Line 68: | Line 87: | ||
'''Work Around:''' Run the game in windowed mode, or run the game in borderless fullscreen mode (use the {{file|--borderless}} [[Command Line Switches|Launch Option]]) | '''Work Around:''' Run the game in windowed mode, or run the game in borderless fullscreen mode (use the {{file|--borderless}} [[Command Line Switches|Launch Option]]) | ||
+ | |||
+ | ==Reset Graphics Settings To Default== | ||
+ | '''How To:''' Go to {{file|(Voxel Turf Install Directoy)/settings}} and delete every file of the form {{file|video_XXX.txt}} where XXX are numbers (for example {{file|video_150.txt}}). | ||
+ | |||
+ | ==Reset Controls To Default== | ||
+ | '''How To:''' Go to {{file|(Voxel Turf Install Directoy)/settings}} and delete every file of the form {{file|controls_XXXX.txt}} where XXXX are numbers (for example {{file|controls_XXXX.txt}}). | ||
+ | |||
+ | [[Category:Guides]] |
Latest revision as of 18:49, 28 January 2020
Contents
- 1 Connection To Server has Timed Out (Singleplayer)
- 2 Connection To Server has Timed Out (Multiplayer)
- 3 Game Crashes On Start (vtclient.exe has stopped working, Windows)
- 4 Could Not Connect To Server: Version or Checksum Mismatch (Multiplayer)
- 5 Game Launch Issues (Steam)
- 6 FPS issues (AMD Graphics Cards on Linux)
- 7 Flickering Screen
- 8 Reset Graphics Settings To Default
- 9 Reset Controls To Default
Connection To Server has Timed Out (Singleplayer)
Problem: You try to start a singleplayer game and you get the message "connection to server has timed out".
Explanation: This has nothing to do with your internet connection. The game uses two executables vtclient.exe
and vtserver.exe
to work. The client renders the screen, and the server handles the actual gameplay. If this message appears then the communication between the client program and the server program have become broken.
When you start a game (either singleplayer of multiplayer) the client starts the server and connects to it. "Singleplayer" is actually just a "Multiplayer" game but with only 1 player slot and only you are allowed to log in. Because the server is run locally on your machine this means that your connection does not matter. The game does not phone home in singleplayer and does not need to access anything on the internet to play.
Possible Causes:
- AntiVirus software is blocking communication between
vtclient.exe
and vtserver.exe
(this has been confirmed to happen with McAffee and Comodo).
- The server is hanging (it gets busy and loses the connection). After the timeout you can still find vtserver.exe running in the Task Manager
- The server is crashing (either due to a lua script error or an application error). You may get a "vtserver has stopped working" message if windows feels like displaying one
Work Arounds:
- Antivirus: Either disable it or whitelist
vtclient.exe
and vtserver.exe
- Server Hanging or Crashing: Email me your crash logs (find them in the
Voxel Turf/logs/
directory) (please zip everything in the folder!) to voxelturf AT gmail DOT com
Connection To Server has Timed Out (Multiplayer)
- First verify that the game works in singleplayer (both for the host and the joiner)
- See if you can connect to other multiplayer servers.
- If you can't connect to any of them then you my be behind a Symmetric NAT and will then have to Set Up Port Forwarding to get a connection.
- Check that
vtclient.exe
and vtserver.exe
are not blocked by windows firewall.
Game Crashes On Start (vtclient.exe has stopped working, Windows)
Problem: Game crashes when it is started.
Cause: If you are on a laptop you may be running Intel Integrated Graphics drivers. Windows does not update these drivers by default, and old versions of these drivers are buggy and unstable.
Fix: Check that you are running Intel Graphics drivers. One way to check is to open the logs directory (Voxel Turf/logs/
) and open glinfo.txt
. If you see something like GL_VENDOR: Intel (blah) then you're running intel drivers. You can update your drivers by going to https://downloadcenter.intel.com/product/80939/Graphics-Drivers
Could Not Connect To Server: Version or Checksum Mismatch (Multiplayer)
Problem: Can't join a multiplayer game due to checksum or version. You may see the error message "Connection to server refused, checksum mismatch", or "Connection to server refused, Version mismatch".
Cause: Every patch of the game has a different version. The game also computes a checksum of all the lua scripts loaded by the client (as in all files in scripts/common/
and scripts/client
, and any mods that add client scripts). This is to insure that both the clients and the host are in sync.
Fix: First verify that both you the host and the client are playing the same version of the game (for example, version 1.2.3). Then verify that you have the same client script mods installed, disabling or uninstalling them if you are unsure.
LotPacks, texture mods and sound mods do NOT affect the checksum, players with different LotPacks, texture mods or sounds mods can play on the same servers.
Game Launch Issues (Steam)
Windows
Problem 1: Clicking "Play" on Steam does nothing
Problem 2: You can run vtclient.exe from the game folder and it launches, but steam can't launch it
Cause: vtserver.exe has failed to close, making steam think the game is running even though vtclient.exe has shut down.
Fix: Reboot your machine, or kill vtserver.exe from task manager
Cause: Steam is derping around
Fix: Try rebooting/closing and restarting steam?
Linux
Problem 1: Clicking "Play" on Steam does nothing Problem 2: Running vtserver does nothing
Cause: Dependencies are not installed.
Fix: Run:
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install libsdl2-2.0-0
sudo apt-get install libsdl2-net-2.0-0
To install the dependencies.
Try running ./vtclient --steam
or ./vtserver
from the command line in the install directory to see what errors (if any) appear.
FPS issues (AMD Graphics Cards on Linux)
Problem: VERY bad framerate on AMD with shaders enabled.
Cause: Graphics drivers not handling shaders correctly. This is confirmed to be an issue on MESA Drivers on Linux, and may happen with old AMD cards or drivers on Windows but has not been reported to happen since Voxel Turf patch 1.0.8 (September 2017).
Work Around: Disable shaders and restart the game
Fixes: Make sure your graphics drivers are up to date. On Linux try the proprietary drivers.
Note: Since version 1.0.8 this has been fixed on windows.
Flickering Screen
Problem: Screen flashes black when in fullscreen mode
Cause: Something is wrong with your graphics driver's V-Sync settings
Work Around: Run the game in windowed mode, or run the game in borderless fullscreen mode (use the --borderless
Launch Option)
Reset Graphics Settings To Default
How To: Go to (Voxel Turf Install Directoy)/settings
and delete every file of the formvideo_XXX.txt
where XXX are numbers (for examplevideo_150.txt
).
Reset Controls To Default
How To: Go to (Voxel Turf Install Directoy)/settings
and delete every file of the formcontrols_XXXX.txt
where XXXX are numbers (for examplecontrols_XXXX.txt
).