User Tools

Site Tools


troubleshooting:commonproblems

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
troubleshooting:commonproblems [2019/07/12 01:08] – [Windows] admintroubleshooting: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 with your computer that you can resolve yourself!
  
 ====== Game Does Not Start ====== ====== Game Does Not Start ======
  
-If you are launching the game from Steam, you may not get any error messages. The first thing you'll need to do is directly run GearCity so that your operating system can tell you what went wrong.+If you are launching the game from Steam or Galaxy, you may not get any error messages. You will need to run GearCity directly so that your operating system can tell you what went wrong.
  
 You'll need to access the main folder. Follow these directions: You'll need to access the main folder. Follow these directions:
-[[Troubleshooting:Steam_InstallFolder|Steam: How to Access Installation Folder]]+[[Troubleshooting:Steam_InstallFolder|How to Access Installation Folder]]
  
 ==== Windows ==== ==== Windows ====
 +
 Follow these directions: Follow these directions:
-[[Troubleshooting:Steam_InstallFolder|Steam: How to Access Installation Folder]]+[[Troubleshooting:Steam_InstallFolder|How to Access Installation Folder]]
  
 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:OpenAL32|The code execution cannot proceed because OpenAL32.dll was not found. Reinstalling the program may fix this problem]]   * [[Troubleshooting:OpenAL32|The code execution cannot proceed because OpenAL32.dll was not found. Reinstalling the program may fix this problem]]
   * [[Troubleshooting:Missing64BitVCFiles|The Application cannot be started correctly (0xc000007b)]]   * [[Troubleshooting:Missing64BitVCFiles|The Application cannot be started correctly (0xc000007b)]]
 +  * [[Troubleshooting:RenderSystem_Direct3D9|Ogre::InternalErrorException::InternalErrorException: Could not load dynamic library ./RenderSystem_Direct3D9...]]
   * [[Troubleshooting:AntiVirus|Antivirus]]   * [[Troubleshooting:AntiVirus|Antivirus]]
   * [[Troubleshooting:RunAsAdmin|Ogre::FileNotFoundException::FileNotFoundException: Cannot locate resource in resource group General...]]   * [[Troubleshooting:RunAsAdmin|Ogre::FileNotFoundException::FileNotFoundException: Cannot locate resource in resource group General...]]
Line 24: Line 26:
  
  
-If the game does start and you get a black window before the game stops working, please see [[troubleshooting:commonproblems#Game Crashing|Game Crashes]] or email us the logfile for help: [[Troubleshooting:Steam_LogFile|Sending Logfile.log]]+If the game does start and you get a black window before the game stops working, please see [[troubleshooting:commonproblems#Game Crashing|Game Crashes]] or email us the log file for help: [[Troubleshooting:Steam_LogFile|Sending Logfile.log]]
  
  
  
 ==== Linux/BSD ==== ==== Linux/BSD ====
 +
 Follow these directions: Follow these directions:
-[[Troubleshooting:Steam_InstallFolder|Steam: How to Access Installation Folder]]+[[Troubleshooting:Steam_InstallFolder|How to Access Installation Folder]]
  
 For Linux users, open a terminal to this location. Next run ./GearCityStart For Linux users, open a terminal to this location. Next run ./GearCityStart
  
-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 libraryplease 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'd to the origin folder. So you may dump any needed libraries without installing them to the main folder. +The GearCity binary is rpath'd to the origin folder. So you may dump any needed libraries without installing them in the main folder. 
  
 If you run into a segment fault, please send us the log file for help: [[Troubleshooting:Steam_LogFile|Sending Logfile.log]] If you run into a segment fault, please send us the log file for help: [[Troubleshooting:Steam_LogFile|Sending Logfile.log]]
Line 42: Line 45:
 ==== MacOS ==== ==== MacOS ====
  
-Follow these directions: +  * 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:Steam_InstallFolder|Steam: How to Access Installation Folder]]+   
 + 
 +If that is not the issue, follow these directions: 
 +[[Troubleshooting:Steam_InstallFolder|How to Access Installation Folder]]
  
 For MacOS users, follow these steps: For MacOS users, follow these steps:
Line 52: 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://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335|verify your game cache]]. If this issue continues or if you run into a segment fault crash, please send of the log file for additional help: [[Troubleshooting:Steam_LogFile|Sending Logfile.log]]+This action should open a terminal windowand the game should run. What does the terminal stop on? If it says a library or framework is missing, please [[https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335|verify your game cache]]. If this issue continues or if you run into a segment fault crash, please send the log file for additional help: [[Troubleshooting:Steam_LogFile|Sending Logfile.log]]
  
 \\ \\
Line 68: 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://downloadcenter.intel.com/SearchResult.aspx?lang=&ProductID=3319&ProdId=3319|Intel]]! +==== Windows Alt-Tab ==== 
  
-Older Intel GPUs have notoriously bad OEM drivers and OpenGL support. If you are running Windows 8.1 or olderplease replace your OEM drivers with Intel drivers. Also running the game in DirectX will give you a bit more stability.+DirectX9 renderer may lose GPU state if you do anything outside the gameThis includes alt-tabbingclicking the taskbar, surfing the internet, minimizing the game, or anything else. We recommended users with alt-tab crash issues switch to the OpenGL renderer.
  
  
-==== 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 MacOS ==== 
-==== 32-Bit DirectX ==== +
  
-DirectX9 renderer in the 32-bit version of the game will lose GPU state if you do anything outside of the gameThis includes alt-tabbing, clicking the task bar, surfing the internet, minimizing the game, or anything else. It is recommended that 32-bit users switch to the OpenGL renderer.+Due to Apple's neglect and planned obsolescence of their system, the 32-bit build of GearCity on OSX is unstableWe recommended to switch to the 64-bit build if possible.
  
 +==== 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://downloadcenter.intel.com/SearchResult.aspx?lang=&ProductID=3319&ProdId=3319|Intel]]! 
  
-Due to Apple's neglect and planned obsolescence of their system, the 32-bit build of GearCity on OSX is fairly unstableIt is recommended to switch to the 64-bit build if possible if you are running OSX 10.or newer.+Older Intel GPUs have notoriously bad OEM drivers and OpenGL supportIf you are running Windows 8.or older, please replace your OEM drivers with Intel drivers. Also, running the game in DirectX will give you a bit more stability.
  
  
-==== Other Crashing ====+==== Dual Laptop GPUs ==== 
  
-For any other crashing issues[[Troubleshooting:Steam_LogFile|please email us the log file.]] Please include what you were doing at the time of the crashAnd if the crash is reproducible, the steps required to reproduce it. +Some laptops ship with two GPUs. Generallyone dedicated GPU for gaming and an Intel GPU for general usageIf your laptop has this configuration, be sure that you are running the game with your dedicated GPUIn most casesyou can do this 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
  
 +
 +==== Other Crashing ====
 +
 +For any other crashing issues, [[Troubleshooting:Steam_LogFile|please email us the log file.]] Please include what you were doing at the time of the crash. If the crash is reproducible, the steps we need to reproduce it. 
  
 \\ \\
Line 109: Line 117:
  
 ==== Mouse does not move ====  ==== Mouse does not move ==== 
-Restarting the computer will resolve this issue. It has something to do with the steam installer not releasing the mouse after installation. + 
 +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 ====  ==== 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.+ 
 +If you're on Windowsbe 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 120: Line 131:
 ==== Using a Different Display ==== ==== Using a Different Display ====
  
-Windows usersuse 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 need to downgrade libpango, remove the offending font, or switch to the 64-bit build. +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. It is recommended that if you have performance issues, switch to the DirectX9 renderer. If you must use OpenGL, the 32-Bit build should perform better in this respect. +Sadly, the CEF pixel format pushes our OpenGL renderer to its limits on 64-Bit Windows systems. We recommended that if you have performance issues, switch to the DirectX9 renderer. If you must use OpenGL, the 32-Bit build should perform better in this respect. 
  
  
Line 148: 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:Steam_CleanReinstall|Clean Reinstall]].+If you attempt to uninstall the game, please note that uninstalling from Steam, Galaxy, or GOG Offline Installers **do 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:Steam_CleanReinstall|Clean Reinstall]].
  
  
Line 163: Line 174:
 \\ \\
 ====== None of These Fixes My issues! ======  ====== None of These Fixes My issues! ====== 
-Email me your log filesI'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:Steam_LogFile|Sending Logfile.log]]+If you can't find your issue on this page, email me your log filesI'll be happy to help. I may not be able to reply right away, but I can guarantee a reply within 24 hours. [[Troubleshooting:Steam_LogFile|Sending Logfile.log]]
  
troubleshooting/commonproblems.1562908082.txt.gz · Last modified: 2022/02/15 17:58 (external edit)