troubleshooting:commonproblems
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
troubleshooting:commonproblems [2019/02/09 20:08] – [Generic Fixes] admin | troubleshooting:commonproblems [2022/06/16 12:22] (current) – [Windows] admin | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | Here are some common issues your computer that can be resolved by you! | + | Here are some common issues |
====== Game Does Not Start ====== | ====== Game Does Not Start ====== | ||
- | If you are launching the game from Steam, you may not get any error messages. | + | If you are launching the game from Steam or Galaxy, you may not get any error messages. |
You'll need to access the main folder. Follow these directions: | You'll need to access the main folder. Follow these directions: | ||
- | [[Troubleshooting: | + | [[Troubleshooting: |
==== Windows ==== | ==== Windows ==== | ||
+ | |||
Follow these directions: | Follow these directions: | ||
- | [[Troubleshooting: | + | [[Troubleshooting: |
Now you need to run the program. Please double click on GearCity.exe. | Now you need to run the program. Please double click on GearCity.exe. | ||
- | If there is an error on your system preventing the game from loading, you should get a Windows error message popup. Please carefully read the error message. If you need to ask for help on the forums or email, please include the text of this error message. | + | If an error on your system preventing the game from loading, you should get a Windows error message popup. Please carefully read the error message. If you need to ask for help, please include the text of this error message. |
- | Here are the three most common issues and their solutions: | + | Here are the most common issues and their solutions: |
* [[Troubleshooting: | * [[Troubleshooting: | ||
* [[Troubleshooting: | * [[Troubleshooting: | ||
+ | * [[Troubleshooting: | ||
* [[Troubleshooting: | * [[Troubleshooting: | ||
+ | * [[Troubleshooting: | ||
+ | * [[Troubleshooting: | ||
- | If the game does start and you get a black window before the game stops working, please see [[troubleshooting: | + | If the game does start and you get a black window before the game stops working, please see [[troubleshooting: |
==== Linux/BSD ==== | ==== Linux/BSD ==== | ||
+ | |||
Follow these directions: | Follow these directions: | ||
- | [[Troubleshooting: | + | [[Troubleshooting: |
For Linux users, open a terminal to this location. Next run ./ | For Linux users, open a terminal to this location. Next run ./ | ||
- | What does the terminal say? If there is a missing library please run ldd GearCityStart to get a list of all your missing libraries. The game should ship all the needed libraries as of 2019. However, you may need to install some libraries on your system depending on how the *nix ecosystem evolves in the coming years. | + | What does the terminal say? If there is a missing library, please run ldd GearCityStart to get a list of all your missing libraries. The game should ship all the needed libraries as of 2019. However, you may need to install some libraries on your system depending on how the *nix ecosystem evolves in the coming years. |
- | he GearCity binary is rpath' | + | The GearCity binary is rpath' |
If you run into a segment fault, please send us the log file for help: [[Troubleshooting: | If you run into a segment fault, please send us the log file for help: [[Troubleshooting: | ||
Line 40: | Line 45: | ||
==== MacOS ==== | ==== MacOS ==== | ||
- | Follow | + | * If you have extra peripherals attached to your mac, please disconnect them. This includes Steering wheels, joysticks, peddles, gamepads, etc. If your game works after disconnecting these devices, plug in each device until the game no longer starts again. If you narrow down a device that prevents the game from starting, please email me the device model so I can investigate. |
- | [[Troubleshooting: | + | |
+ | |||
+ | If that is not the issue, follow | ||
+ | [[Troubleshooting: | ||
For MacOS users, follow these steps: | For MacOS users, follow these steps: | ||
Line 50: | Line 58: | ||
- Click on the GearCity binary file. | - Click on the GearCity binary file. | ||
- | This should open a terminal window and the game should run. What does the terminal stop on? If it says a library or framework is missing, please [[https:// | + | This action |
\\ | \\ | ||
Line 66: | Line 74: | ||
- | ==== INTEL HD VIDEO CARDS! ==== | ||
- | If you are using an Intel Video Card on Windows. **PLEASE** make sure you have the latest drivers from [[https:// | + | ==== Windows |
- | Older Intel GPUs have notoriously bad OEM drivers and OpenGL support. If you are running Windows 8.1 or older, please replace your OEM drivers with Intel drivers. Also running | + | DirectX9 renderer may lose GPU state if you do anything outside the game. This includes alt-tabbing, clicking the taskbar, surfing the internet, minimizing |
- | ==== Dual Laptop GPUs ==== | ||
- | Some laptops ship with two GPUs. Generally one dedicated GPU for gaming and an Intel GPU for general usage. If your laptop has this configuration be sure that you are running the game with your dedicated GPU. In most cases this has to be done in your driver settings. Running the game on Intel GPUs, while it may work, is generally not recommended unless you have up-to-date drivers. | + | ==== 32-Bit |
- | ==== 32-Bit | + | |
- | DirectX9 renderer in the 32-bit | + | Due to Apple' |
+ | ==== Intel HD GPUs ==== | ||
- | ==== 32-Bit MacOS ==== | + | If you are using an Intel Video Card on Windows 8 or older. **PLEASE** make sure you have the latest drivers from [[https:// |
- | Due to Apple' | + | Older Intel GPUs have notoriously bad OEM drivers |
- | ==== Other Crashing | + | ==== Dual Laptop GPUs ==== |
- | For any other crashing issues, [[Troubleshooting: | + | Some laptops ship with two GPUs. Generally, one dedicated GPU for gaming and an Intel GPU for general usage. If your laptop has this configuration, |
+ | |||
+ | |||
+ | ==== Other Crashing ==== | ||
+ | For any other crashing issues, [[Troubleshooting: | ||
\\ | \\ | ||
Line 107: | Line 117: | ||
==== Mouse does not move ==== | ==== Mouse does not move ==== | ||
- | Restarting the computer will resolve this issue. It has something | + | |
+ | Restarting the computer will resolve this issue. It has to do with the steam installer not releasing the mouse after installation. | ||
+ | |||
+ | |||
+ | ==== Mouse does not show up ==== | ||
+ | |||
+ | If you're on Windows, be sure that Mouse Pointer Trails are disabled. Beyond that, you can disable the Hardware Mouse setting to get a software-emulated mouse. | ||
==== High FPS or Monitor Refresh Issues ==== | ==== High FPS or Monitor Refresh Issues ==== | ||
Line 115: | Line 131: | ||
==== Using a Different Display ==== | ==== Using a Different Display ==== | ||
- | Windows users, use external settings editor to select which monitor to use. Linux and OSX users, please set the primary monitor to the one you wish to use before starting the game. | + | Windows users use the external settings editor to select which monitor to use. Linux and OSX users, please set the primary monitor to the one you wish to use before starting the game. |
==== Linux Reports Fonts Unreadable ==== | ==== Linux Reports Fonts Unreadable ==== | ||
- | Due to changes in libpango, the 32-bit version of the game may have font selection issues. You will either | + | Due to changes in libpango, the 32-bit version of the game may have font selection issues. You will need to downgrade libpango, remove the offending font, or switch to the 64-bit build. |
==== 64-Bit Windows OpenGL Slow Browser ==== | ==== 64-Bit Windows OpenGL Slow Browser ==== | ||
- | Sadly, the CEF pixel format pushes our OpenGL renderer to its limits on 64-Bit Windows systems. | + | Sadly, the CEF pixel format pushes our OpenGL renderer to its limits on 64-Bit Windows systems. |
Line 143: | Line 159: | ||
Occasionally Steam screws up downloading files. In such cases, file verification can normally catch issues. See here for instructions on how to do that. | Occasionally Steam screws up downloading files. In such cases, file verification can normally catch issues. See here for instructions on how to do that. | ||
- | If you attempt to uninstall the game, please note that uninstalling from Steam **does not** remove user generated files, including settings, GPU caches, saved GUIs, etc. For a truly clean reinstall of the game, please follow the steps outlined here: [[Troubleshooting: | + | If you attempt to uninstall the game, please note that uninstalling from Steam, Galaxy, or GOG Offline Installers |
Line 158: | Line 174: | ||
\\ | \\ | ||
====== None of These Fixes My issues! ====== | ====== None of These Fixes My issues! ====== | ||
- | Email me your log files, I'll be happy to help. I may not be able to reply right away, but I can pretty much guarantee a reply within 24 hours. [[Troubleshooting: | + | If you can't find your issue on this page, email me your log files. I'll be happy to help. I may not be able to reply right away, but I can guarantee a reply within 24 hours. [[Troubleshooting: |
troubleshooting/commonproblems.txt · Last modified: 2022/06/16 12:22 by admin