Some Technical Stuff

Even though Stonehearth is still in its Beta 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.


Stonehearth System Requirements (PC)

About 20 hearthlings, and lowest graphics settings.

    • OS: Windows 7/8/8.1/10 (32-bit or 64-bit)
      • OS Updates: Windows 7 SP1
    • Processor: Intel or AMD Dual-Core, 1.7 GHz+
    • Memory: 4 GB RAM
    • Graphics: nVidia GeForce GT 430, Radeon HD 7570M, Intel HD 4000
    • Hard Drive: 2GB available space

About 40 hearthlings, and good graphics settings! Minimum recommended for hosting a multiplayer server.

    • OS: Windows 10
    • Processor: Intel or AMD Quad-Core or better, 2.8GHz+
    • Memory: 16 GB RAM
    • Graphics: nVidia GeForce 780 or better, AMD Radeon RX 580 or better
    • Hard Drive: SSD, 5GB 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.

Stonehearth System Requirements (Mac/OSX)

About 20 hearthlings, and lowest graphics settings.

    • OS: macOS 10.11 (El Capitan) or later
    • Processor: Intel i5 1.7 GHz+
    • Memory: 8 GB RAM
    • Graphics: Radeon HD 5870 or GeForce 630, or Intel HD Graphics 4000
    • Hard Drive: 2GB available space

About 40 hearthlings, and good graphics settings! Minimum recommended for hosting a multiplayer server.

    • OS: macOS 10.13 (Sierra) or later
    • Processor: Intel 2.8 GHz Intel Core i7
    • Memory: 16 GB RAM
    • Graphics: nVidia GeForce
    • NVIDIA GeForce GT 750M or better
    • Hard Drive: SSD, 5GB available space

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
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‘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.


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!