Problem database

stubb edited this page Oct 12, 2014 · 13 revisions
Clone this wiki locally

On this page, we try to collect several problems players or devs came across while trying to run UH in various environments and the solutions we found.

The game won't start because there is something wrong with the settings

  • Remove your settings file (Where is it?)
  • Command line users can alternatively do: unknown-horizons --restore-settings

I keep getting "No handlers could be found for logger ..."

This is a warning that you get when logging is turned off, just disregard it.

I keep getting "AL lib: pulseaudio.c:612: Context did not connect: Access denied"

Your OpenAL configuration tries to load pulse before the sound driver you actually use. Edit the drivers= line in the config file (usually found in /etc/openal) and put your sound system on pole position in the list.


I can't join a LAN multiplayer game

  • Currently, a master server is used to set up games. Your router might not support 2 players joining from the same network.
  • You can circumvent this by using your own master server and then connecting to it (a more convenient GUI-only version of this is planned but not implemented yet): ./ -h <your-ip> -p <any-port> - now start UH as unknown-horizons --mp-master=<server-ip:server-port>


[Windows 8] Clicking on "random maps" crashes

Replace horizons\gui\widgets\ with this file: [] (

See the [report in our forums] ( for details.


Clicking on the Singleplayer button crashes

Traceback (most recent call last):
  File "C:\Program Files\Unknown Horizons\horizons\gui\modules\", line 79, in set_color
    self.gui.findChild(name='selectedcolor').background_color = Color[color_id]
  File "C:\Program Files\Unknown Horizons\python\lib\site-packages\fife\extensions\pychan\", line 65, in __set__
    color = fife.Color(color.r,color.g,color.b,color.a)
AttributeError: 'NoneType' object has no attribute 'r'

We have no idea how this happened, but your settings file contains a weird ColorID. Replace the 0 in this line with a 1:

<Setting name="ColorID" type="int"> 0 </Setting>

AL lib error upon start

Traceback (most recent call last):
  File "/usr/lib64/python2.7/site-packages/fife/", line 55, in _swig_getattr
    raise AttributeError(name)
AttributeError: getSoundClipManager

You're using FIFE older than 0.3.4 which is incompatible with our release. Please uninstall any older FIFE versions in your system (package manager!) and install 0.3.4 either from source or as nightly build.


Traceback (most recent call last):
NameError: global name 'InitializationError' is not defined

Update FIFE to current svn revision (unless you are currently following our source install guide) and remove older FIFE versions from your system. Make sure you also remove the ones installed through your package manager!


YamlCache problems related to special characters in paths on windows

Please replace your file Unknown Horizons/horizons/util/ with the contents of this [patched] (

Mac OS X: Locale crash at startup

Traceback (most recent call last):
  File "/Library/Frameworks/Python.framework/Versions/2.x/lib/python2.x/", line 435, in _parse_localename
    raise ValueError, 'unknown locale: %s' % localename
ValueError: unknown locale: UTF-8

In the "advanced" tab in Terminal's preferences, uncheck "Set LANG environment variable on startup"


Crash on startup

Traceback (most recent call last):
  File "/usr/lib/python2.6/dist-packages/fife/", line 3531, in createFont
    return _fife.GUIChanManager_createFont(self, *args)
RuntimeError: _[SDLException]_ , SDL reported something bad :: Fatal Error when
loading image into a SDL_Surface: Unsupported image format

This is caused by an old FIFE somewhere in your system. If you compiled the recent FIFE sources from svn, try removing the package fife-python from your system. If you use the latest FIFE release: Sorry, that's not compatible with current UH HEAD anymore. Please check our homepage for a guide on how to compile the svn sources.


Problems startup on windows

To fix it, please install [cPython] ( to C:\python2 and copy the contents of it to your unknown horizons installdir into the python folder Python27/

Black screen and ATI card

This is a known bug with some older ATI drivers and newest FIFE. To solve, locate <Module name="FIFE"> in your settings file (Where is it?) and add these two new entries:

<Module name="FIFE">
  <Setting name="GLUseFramebuffer" type="bool"> False </Setting>
  <Setting name="GLUseNPOT" type="bool"> False </Setting>
Use SDL instead of OpenGL

If that fails, find the following line near the top of the settings file:

  <Setting name="RenderBackend" type="str">OpenGL</Setting>

Change it to:

  <Setting name="RenderBackend" type="str">SDL</Setting>

Graphical glitches on windows

If you have graphical glitches [like this one] (, please install the last offical driver for your graphic card from the manufacturer's website.

I use a 1024x600 resolution and the game crashes while opening the settings dialog

Quite annoying, but there's a commit missing in the last FIFE release.

To fix this, add 1024x600 to the list of valid resolutions; see [this commit] ( for the details. No rebuild of FIFE is required!

Alternatively, do not open the settings dialogue and directly edit your settings file ;)

Game Doesn't Start: ValueError: plural forms expression could be dangerous

This is probably a bug in the translation you are using (we currently know of the danish translation that has this bug). To solve this, please play in english. You have to edit the settings.xml file manually to fix it.

  <Setting name="Language" type="unicode">YOURLANGUAGE/System Default</Setting>


  <Setting name="Language" type="unicode">English</Setting>
  • Save the file


UH won't start

There is a bug related to updating old settings file. This is the most likely cause for UH 2011.2 not starting. The command line output contains something like this:

Updating settings.xml to the default, it is missing the entry: ($entry) for module unknownhorizons
Traceback (most recent call last):
AttributeError: 'NoneType' object has no attribute 'show_popup'

The fix is explained in detail here: [Fix in the forums] (

Fix for Windows

Remove your old settings file: C:\Users\USERNAME\.unknown-horizons\settings

A new settings file with default values will be generated by the next start of Unknown Horizons.


required lib pyenet not found

Traceback (most recent call last):
AttributeError: 'module' object has no attribute 'enet'

The tutorial doesn't advance

If you saved the game during the tutorial, quit and then loaded it again the tutorial will not advance any further. This has been fixed in the development version and will be fixed with the next release.

  • Play the tutorial in one try. We're sorry for not noticing this bug earlier :(

Problems with FIFE* cannot open shared object file

Failed to use FIFE from <module 'fife' 
from '/home/kili/Repositories/fifengine/engine/python/fife/__init__.pyc'> cannot open shared object file: No such file or directory
Failed to find and/or load FIFE.

Seems like you updated the boost library on your system. Simply rebuild fife. Run scons -c to clean up the build directory and run scons to build fife again.

Required lib SDL_ttf not found!

  • Check out #865 including comments for the latest information

sh: o: command not found

  • (This line can appear during the build process, resulting in an error shortly thereafter.)
  • This usually means swig is missing, installing it should fix the issue.

YAML cache crash

This is the last part of a crash caused by our YAML cache being in a messed up state.

Traceback (most recent call last):
  File "/usr/lib/python2.7/", line 223, in __init__
    Shelf.__init__(self,, flag), protocol, writeback)
  File "/usr/lib/python2.7/", line 85, in open
    return, flag, mode)
error: (22, 'Invalid argument')

Delete yamldata.cache in the same folder as your settings to fix it.