Some Technical Stuff

Even though Stonehearth is still in its Alpha phase, and you may expect to find a few things rough around the edges, we at Team Radiant strive to make your game as fun and engaging as possible. You can keep goblins problems away and  help ensure a great Stonehearth experience by double-checking that your PC meets our system requirements, and that your drivers are up-to-date.

fight

Stonehearth System Requirements

Minimum:

    • OS: Windows Vista/7/8/8.1 (32-bit or 64-bit)
      • OS Updates: Windows 7 SP1; Windows Vista SP2
    • Processor: Intel or AMD Dual-Core, 2.0 GHz+
    • Memory: 4 GB RAM
    • Graphics: nVidia GeForce 200 512MB, Radeon HD 3450 512MB, Intel HD 3000
    • Hard Drive: 500 MB available space

Recommended:

    • OS: Windows Vista/7/8/8.1 64-bit
      • OS Updates: Windows 7 SP1; Windows Vista SP2
    • Processor: Intel or AMD Quad-Core or better, 2.6GHz+
    • Memory: 8 GB RAM
    • Graphics: nVidia GeForce 560 1024MB or better, AMD Radeon HD 7790 1024MB or better
    • Hard Drive: 500 MB available space

Updating your drivers

Microsoft has a helpful Windows 7 video cards explanation page that provides more than you may ever want to know about your video card and how to keep it current.

AMD’s driver page provides support and driver updates for a wide range of their cards.

Intel has a nifty automatic driver update utility.

And if you’re an Nvidia customer, get your drivers here.

Crashing on startup? Read this.

UPDATE OCTOBER 2016: Some players who have experienced crashing on startup have resolved the issue by resetting the built-in firewall, the TCP/IP interface, and Windows Sockets.

If you’re having this issue, try running all three of the below in an admin command prompt:

netsh advfirewall reset

netsh int ip reset c:\resetlog.txt

netsh winsock reset

If this does fix things for you, we’d like to know! Please drop us a line on Discourse.

UPDATE JULY 2016: When starting up Stonehearth for the first time in a new Alpha, please make sure you don’t have any mods installed; often, mods have not been updated by their creators to work with the latest builds and this may create errors, crashes, or even cause Stonehearth to fail to launch at all. If you’re not sure whether the mods you use are up-to-date, check the modding discussion on Discourse.

If you are still experiencing crashes when starting Stonehearth, the main causes are outdated drivers and/or your privacy software or anti-malware programs.

Stonehearth runs a version of the Chrome browser to render the user interface. Some anti-malware or privacy programs inject code into Stonehearth and Chrome in an attempt to provide their services; sadly, many of these injection techniques cause crashing issues on startup.We are actively working to circumvent these injection techniques completely, but providing a stable and efficient solution may take some time. In the
interim, disabling these programs should allow you to play the game.

Some example programs that we have found cause this crashing:
LavaSoft WebCompanion
Webroot
Hide My IP
AVG Antivirus

A full list of offending programs is can be found in this forum thread.

If you can’t even start Stonehearth, and you are running one of the programs above (or something like it), try disabling it to see if it will help. If it does, let us know in this thread!

If this doesn’t solve the crashing issue for you, here are a couple of other things that have worked for folks:

1.) Update your graphics card drivers (see above!).

2.) If you’re running Windows 7, make sure you have at least SP1. (For Vista, at least SP2.)

3.) If you have an Intel card, make sure you update those drivers also (some laptops may have a built-in Intel chipset as well as separate graphics card).

4.) Try turning off fullscreen mode. You can do this from the settings screen. If you can’t even get to the settings screen, find your user_settings.json file in the Steam Stonehearth folder, and add the following:

"renderer" : {

        "enable_fullscreen" : false
}
If all else fails, we added a bunch more error reporting in our latest hotfix, which we put on both the regular and Steam Latest branches. If you’re experiencing a crashing bug, please get the latest version of the game, opt into crash reports, get the game to crash, and let us know we should take a look for your data.

Still having problems? Send us some info.

Okay. So your rig meets Stonehearth requirements, and your drivers are up to date, and you’ve disabled programs that may be interfering with gameplay. But somehow, you are still encountering difficulty. Here’s what to do.

First, check discourse.stonehearth.net‘s bug report category. There, you’ll find details about existing bugs or you can file a new bug! Please make sure you include the Release number of the Version you’re playing (it’s on the splash screen when you start your game, and also in the upper left of your screen as you play).

Sometimes, to help us find the source of a bug or cause of a crash, it helps us if you can send us your stonehearth.log file. How do you find the stonehearth.log file (you may ask)? If you play on Steam, you can find stonehearth.log this way:

– Right click Stonehearth in your Steam library
– Select ‘Properties’
– Select the ‘Local Files’ tab
– Select ‘Browse Local Files’

You’ll find stonehearth.log nestled among your local files.

If you play via Humble Bundle download, you should find it in a path like: C:\Users\YourNameHere\AppData\Local\stonehearth\stonehearth.log
You can open stonehearth.log in a text editor, and copy/paste out things that look suspicious.

craft

Sometimes, a bug thread may recommend altering your user settings file in order to work around an existing problem. But where is your user settings file? If you’re playing on Steam, you’ll find it at something like: Program Files (x86)\Steam\steamapps\common\Stonehearth\user_settings.json

If you install via Humble Bundle, it will be at:  C:\Users\YourNameHere\AppData\Local\stonehearth\user_settings.json

This file can also be opened in any text editor. You can make adjustments to the file exactly as it says in the suggested fix/workaround; mind all spaces and capitalization and punctuation (pesky, yes, but important). After editing the file, restart the game to make sure your changes take effect.

If you make changes to user_settings.json, and the game doesn’t seem to behave correctly therafter, don’t worry! User_settings.json is just a text file, so if you’ve typed something wrong or missed punctuation, all you’ve got to do is close the game and edit the file until it does work the way you intended. (If all else fails, you can just delete the user settings file and restart the game; it will spawn a sparkly new user settings file.)

Please help us identify issues so that we can fix them. And enjoy the game!