Sunless Skies: Troubleshooting

Welcome to the official Sunless Skies: Troubleshooting guide. If you are having technical issues with the game then you should find the help you need below.

Reporting Bugs

PC
Sunless Skies has an in-game bug reporting tool which is accessible by pressing F8, or via the Report A Bug button on the Pause Menu (press Esc or click the Cog icon on the HUD).

Once open, select an appropriate category from the drop-down list (Feedback, Narrative Issue, or Other Issue) before entering a description for the issue you are experiencing. The more information you can give us about the steps you took before encountering an issue the better.



If you cannot launch the game in order to access the bug reporter, then the information in this guide should help you resolve your issue.


Console
To report an issue on console please email [e-mail]

System Requirements

First, please make sure your system meets the requirements for the game. Check the System Requirements on Sunless Skies's Steam store page. The game has the same requirements on Steam, GOG and Epic.

Video Card Drivers

Please make sure your video card drivers are fully up to date. This is especially important for Intel integrated GPUs and it’s best to check the manufacturer’s website than rely on Windows:

Intel HD Graphics[downloadcenter.intel.com]
Nvidia GeForce[www.geforce.com]
Other Nvidia cards[www.nvidia.com]
AMD/ATI cards[www.amd.com]


If you have more than one graphics card Unity3D can sometimes fail to select the best one. Usually updating your graphics drivers or creating a profile for Sunless Skies in your graphics driver's control center can help.

You can check which graphics card Sunless Skies is using right at the top of your player log - look for 'Renderer'.

If you are experiencing exceptionally poor performance, it could be that your graphics card has defaulted to the Basic Render Driver. Microsoft Basic Render Driver is a fallback driver that Windows uses if it can not find the drivers for the graphics card.


You either need to enable your dedicated graphics card or update your graphics driver, there's a great guide for both here[www.drivereasy.com]

Sound Card Drivers

Sunless Skies uses the FMOD audio libraries and unfortunately FMOD crashes if the sound card is not installed properly. A good indication of a sound driver issue is when it crashes before the title screen is displayed.

Your player log will reference the issue with FMOD though it does not look like a normal exception so use Ctrl+F to look for FMOD.

Ensure your sound card drivers are up-to-date via the vendor's website. You should be able to find information about the sound card vendor in the Windows Device Manager.

Additionally there are sound issues with Windows 10 which will prevent the game from starting, though these are not specific to Sunless Skies. Please follow these instructions from Microsoft to fix sound card issues in Windows 10.

While most FMOD issues are resolved by updating the sound card, sometimes they can be a result of applications having exclusive access to your sound device. When this happens you'll typically see the following message in the player log:

 
FMOD failed to initialize. This may be because your sound card is configured to give applications exclusive access, thus preventing Unity from using this device. You can change this in Control Panel > Audio Devices and Sound Themes > Playback Device > Properties > Options ... : "Soundcard does not support the minimum features needed for this soundsystem (16bit stereo output)."

Disabling the Exclusive Mode options in Windows Sound Preferences can resolve this by preventing audio applications from taking exclusive control of the driver. To do this, do the following:

1. Open Control Panel > Hardware and Sound > Sound and click on the Playback tab
   
2. Select your speaker/headphones from the list of audio devices and then click Properties
   
3. In the Properties window, go to the Advanced tab and deselect the option to "Allow applications to take exclusive control of this device"
   
4. Click OK to Apply the settings
   
5. Back in the Sound window, click on the Recording tab and repeat steps 2-4
   
6. Once complete, restart your computer for the changes to take effect.

If that doesn’t work go to Control Panel > Hardware and Sound > Sound and go through the Playback and Recording tabs to disable any additional devices before giving Skies another try.

Where to find your save files

The save files for each 'Captain' within Sunless Skies can be found in a 'Lineage' folder within the character repository directory. Along with the avatar.png, each Lineage folder will contain the following three json files:

• autosave.json
  
• autosave_backup.json
  
• saveSnippet.json

The first save file you create in Sunless Skies will be named Lineage-1. If that Captain completes an ambition, or dies and passes on a legacy, then the data for the new captain will overwrite the data within the Lineage-1 folder. However if you click New Game on the Title Screen then this will create a completely new Lineage folder: Lineage-2.

The character repository directory can be found in the following locations depending on your operating system:

Windows

%userprofile%\AppData\LocalLow\Failbetter Games\Sunless Skies\storage\characterrepository

OSX

~/Library/Application Support/unity.Failbetter Games.Sunless Skies/storage/characterrepository

Linux / Steam Deck

~/.config/unity3d/Failbetter Games/Sunless Skies/storage/characterrepository

Hidden Directories

If you cannot find the file paths listed above then it could be because the directories are hidden.

Windows

The AppData folder is generally a hidden one, so if you haven't got Windows Explorer set to display hidden files then it's hiding from you. Try these steps:

1. Go to C:\Users\[username] - replace [username] with your actual user name.
   
2. On Windows Explorer, select the View tab and then click Options
   
3. The Folder Options window will pop up - select the View tab
   
4. Under Files and Folders, you'll see the Hidden files and folders directory and two radials - make sure the Show hidden files, folders and drives radial is selected
   
   
5. Click Apply and then OK
   
6. Close that down - you should now see the AppData folder in Windows Explorer

You should be able to find your way from there. Alternatively, you should just be able to copy the file location straight into the Windows Explorer bar and it'll take you straight there (%userprofile%\AppData\LocalLow\Failbetter Games\Sunless Skies\storage\characterrepository).

If you don't see it after turning the hidden files to 'Show', then it could be that all of this is on a different drive, like a D drive for example, but the above steps will apply just the same to any alternative drives you have.

MacOS

The ~/Library is hidden by default. Here are some steps to help you locate it:

1. Open the Finder
   
2. Choose Go from the menu bar
   
3. Choose Go to Folder (or Shift-CMD-G)
   
4. Type ~/Library into the text box and press go - you should now see and be able access the contents of the ~/Library which were previously hidden from sight.

Alternatively:

1. Open the Terminal (found in Finder > Applications > Utilities)
   
2. In Terminal, paste the following:

   defaults write com.apple.finder AppleShowAllFiles YES

3. Press return
   
4. Hold the ‘Option/alt’ key, then right click on the Finder icon in the dock and click Relaunch. This will show all hidden files.

On Sierra and later OSX versions you can also use the following shortcut when in Finder. Press once to show hidden files and again to hide them.

CMD + SHIFT + .

Locating the correct Library on MacOS

If you are copying the file path given above, make sure you include the ~/ before Library, otherwise you will be sent to the wrong location.

Entering Library into the Finder will take you here:


Entering ~/Library into the Finder takes you to a completely different directory:

Where to find your Player log

Below are details of where to find your player log (known as the output log on Windows prior to the Sovereign update) on your operating system.

To diagnose issues, you’ll need to look at the Player.log.

If you contact support directly and we ask for your logs, please send us both the Player.log and the Player-prev.log which are kept in the same location.

Windows

%userprofile%\AppData\LocalLow\Failbetter Games\Sunless Skies

OS X

~/Library/Logs/Failbetter Games/Sunless Skies

Linux / Steam Deck

~/.config/unity3d/Failbetter Games/Sunless Skies

Hidden Directories

If you cannot find the file paths listed above then it could be because the directories are hidden. Please see the Hidden Directories information within the Where to find your save files section above.

Where to find Crash Logs

If you experience a genuine crash (not a freeze or a hang) then crash files will be generated and your player log will tell you where they have been placed, for example:

Crash!!!
A crash has been intercepted by the crash handler. For call stack and other details, see the latest crash report generated in:
 %userprofile%\AppData/Local/Temp/Failbetter Games/Sunless Skies/Crashes

Please email all crash files directly to us at [e-mail], with details on what you were doing immediately prior to experiencing the crash.

(Note: A crash is when a software program stops working and then closes. While technically different, the terms hang and freeze are often used interchangeably to refer to when a program becomes unresponsive.)

Corrupt Game Files / Installation problems

Occasionally game files can become corrupted during installation or updates. This will present itself in a few ways, but most commonly in hanging or crashing (usually with the game closing before you even get to the title screen). Verifying the game files usually fixes these issues. To do this take the following steps:

Steam

1. Right click on Sunless Skies in your library
   
2. Select Properties
   
3. Click on the Installed Files tab
   
4. Click Verify Integrity of Game Files

GOG

1. Select your game from your library
   
2. Select the Settings icon next to the Play button
   
3. Highlight Manage Installation and select Verify / Repair

Epic

1. Locate the game in your library
   
2. Select the Settings Menu button next to the game's icon (three horizontal dots)
   
3. Select Manage
   
4. Click Verify

It's rare, but sometimes the installation may be broken even though all the files pass the validation. In these situations it's best to uninstall and reinstall the game, then verify the integrity of the files after re-installing.

Black Screen Issues: Corrupt Save Files

Sunless Skies save files can sometimes become corrupt when the game shuts down unexpectedly due to a hardware crash, a sudden power cut, or a Windows update that cannot be cancelled while the game is saving.

Corrupt save files manifest as a black screen on launch. Check your player log for an error and if you see an error which begins like the one below then you will know that one or more save files have become corrupt (if you have a different error please see our section: Other Black Screen Issues)

Uploading Crash Report
NullReferenceException: Object reference not set to an instance of an object
  at Skyless.Assets.Code.Skyless.Game.Data.CharacterRepository.ReturnAllSnippets () [0x00000] in <filename unknown>:0 
  at Skyless.Assets.Code.Skyless.Game.Data.CharacterRepository.EnsurePresenceOfSnippets () [0x00000] in <filename unknown>:0 

Please see the section Where to Find Your Save Files to locate the files on your machine. There are three files for each Sunless Skies save game, or 'Lineage':

• saveSnippet.json
  
• autosave.json
  
• autosave_backup.json

Diagnosing with Text Editors

To diagnose the level of corruption you will need to open all three files in a text editor. We recommend Notepad++[notepad-plus-plus.org], but make sure Word Wrap is on!

If a file has become corrupted it may be completely empty, or it will be full of NUL values and look something like the image below:


You will find yourself in one of four situations:

• The saveSnippet has corrupted
  
• The autosave file has corrupted
  
• The saveSnippet and the autosave file has corrupted
  
• All three files have corrupted

Steps for repairing save files are listed below, but first...

Turn off Cloud Saving

It's advisable that you temporarily turn off Steam / GOG / Epic cloud-saving services before repairing save files, or they will reinstate corrupted files on the game's launch.

Once cloud saving has been turned off, please follow these steps:

If on Steam:

1. Right click on Sunless Skies in your library
   
2. Select Properties
   
3. Click on the Installed Files tab
   
4. Click Verify Integrity of Game Files

If on GOG

1. Select your game from your library
   
2. Select the Settings icon next to the Play button
   
3. Highlight Manage Installation and select Verify / Repair

Epic

1. Locate the game in your library
   
2. Select the Settings Menu button next to the game's icon (three horizontal dots)
   
3. Select Manage
   
4. Click Verify

saveSnippet corruption

If your saveSnippet has corrupted then follow these steps:

1. Delete all the NUL values within the saveSnippet if present
   
2. Copy/paste the following data into the file:
   

   {"Name":"Failbetter","LegacyMode":"   (Merciful Mode)","Location":"Wolvesey Station","Region":"The Reach","SavedOn":"2019-09-07T13:36:55.7639699+00:00","GameVersion":"2.0.0.957eac2d"}
   

3. Save the file
   
4. Run the game and click Continue - the saveSnippet will now update with your own captain's data

autosave corruption

If the autosave file has corrupted then follow these steps:

1. Delete all the NUL values within the autosave file if present
   
2. Copy all the data from the un-corrupted autosave_backup file into the autosave file
   
3. Save the file
   
4. Run the game and click Continue

saveSnippet and autosave corruption

If both the autosave and the saveSnippet have become corrupted then you just need to repair the two files as outlined above.

All three files have corrupted

Occasionally all three save files will become completely nullified and sadly there is no way to recover save games in this state. You'll need to delete the lineage with these files in before you're able to create another save game, otherwise you'll continue to see the black screen on launch.

If playing on Steam we recommend checking out your Steam cloud saves for Sunless Skies on the Steam server. Steam usually keeps multiple saves on its servers, so while the latest cloud save will be the corrupted one, there may be earlier saves that you could recover. You’ll need to turn Steam cloud saving off before copying those save files into your Lineage folder and running the game again - otherwise it would re-download the corrupted files. You can check out all your Steam cloud saves here.

If you're experiencing frequent hardware issues then we of course recommend taking your machine to a professional so the issue can be diagnosed. However, until you are able to do that it might be a good idea to make regular manual back-ups of your save files after each play session. For details please see the Manual backups of save files heading in the Low Performance / FPS section below.

When to turn cloud saving back on

If you want to turn cloud saving back on, do the following:

1. Load the repaired save files.
   
2. Once in game you need to prompt the game to save by docking at a port (it's fine to just undock from your current port and dock again)
   
3. Close the game down completely
   
4. At this point you'll be ok to turn cloud saving back on

Troubleshooting: I've repaired the saveSnippet but I still see a black screen

This suggests that the autosave file has partial corruption. You'll see a different error in the logs in this instance. There errors will display differently depending on where the corruption is in the files, but they all begin with the following:

JsonSerializationException

Here are a couple of examples:

JsonSerializationException: Unexpected end when deserializing array. Path 'GeneratedWorld.Regions[3].FogBools[14484]', line 1, position 229376.

JsonSerializationException: Unexpected end when setting Name's value. Path 'PlayerProspects[0].DestinationSetting.Exchange.Shops[1].Availabilities[0].PurchaseQuality.Name', line 1, position 237568. 

If part of your save file has also become corrupted with non-compatible characters, then you'll see a slightly different error in the logs

JsonReaderException: Unexpected character encountered while parsing value: 
  at Newtonsoft.Json.JsonTextReader.ReadAsBoolean () [0x00000] in <filename unknown>:0 
  at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.ReadForType (Newtonsoft.Json.JsonReader reader, Newtonsoft.Json.Serialization.JsonContract contract, Boolean hasConverter) [0x00000] in <filename unknown>:0 
  at Newtonsoft.Json.Serialization.JsonSerializerInternalReader.PopulateList (IList list, Newtonsoft.Json.JsonReader reader, Newtonsoft.Json.Serialization.JsonArrayContract contract, Newtonsoft.Json.Serialization.JsonProperty containerProperty, System.String id) [0x00000] in <filename unknown>:0

Partial save file corruption presents in two ways; either the second half of the file will be full of NUL values or non-compatible characters, or it will be missing completely. The very last thing you should see in the autosave files is the name of your captain:

If there is no corruption but you cannot see your captain's name at the end of the file, then part of your data is missing.

If you have partial save file corruption then do the following:

1. Delete all the data within the autosave file
   
2. Copy all the data from the un-corrupted autosave_backup file into the autosave file
   
3. Save the file
   
4. Run the game and click Continue

N.B. If both your autosave and autosave_backup files have been partially corrupted then sadly there is no way to recover save games in this state.

Other Black Screen Issues

There are multiple causes of black screen issues. To diagnose them you need to look for errors in the player log. Details of where to find this on your machine can be found in the section: Where to find your player log.

Once you've located your player log you need to open it in a text editor and look for errors/exceptions. We recommend Notepad++[notepad-plus-plus.org], but make sure Word Wrap is on! (Go to View and click Word Wrap to select it).

Transit Relays & Character Creation

If you experience a black screen (or crash) when using Transit Relays or at the point of Character Creation, please see the advice in the Crashes: Transit Relays & Character Creation section below.

Empty lineage folders

If there is an empty Lineage folder within the character repository directory you will see a black screen on launch and an error in the player log which will begin as follows:

Uploading Crash Report
InvalidOperationException: Sequence contains no elements
  at System.Linq.Enumerable.First[TSource] (System.Collections.Generic.IEnumerable`1[T] source) [0x00000] in <00000000000000000000000000000000>:0 
  at Skyless.Assets.Code.Skyless.Game.Data.CharacterRepository.EnsurePresenceOfSnippets () [0x00000] in <00000000000000000000000000000000>:0 
  at Skyless.Assets.Code.TitleScreen.Setup () [0x00000] in <00000000000000000000000000000000>:0 
  at Skyless.Assets.Code.TitleScreen.LoadTitleScreen () [0x00000] in <00000000000000000000000000000000>:0 

If you see this error you need to open the character repository directory and go through the Lineage folders until you find one (or more) that's empty. Delete any that are empty and you should be good to go.

SteamAPI_init() failed

If you see

(SteamAPI_init() failed)

in your player logs then the Steam app may not be running correctly. If you see this try the following:

• Try restarting Steam.
  
• Try logging in and out of Steam and restarting.
  
• Check your Antivirus or Firewall settings. Updates have been known to put games in the AV/Firewall sandbox/quarantine. We recommend making an exception for Steam/GOG/Epic in your anti-virus to resolve this issue, rather than turning your anti-virus off.

If the above suggestions fail then the error is probably due to the Windows account that you are using not having administrative access. All you have to do is switch to your Windows account with “Administrative Access” and the issue will be resolved.

Game started outside of steam

If you see

Game started outside of steam (Sunless Skies). Restarting...

in your player logs then something has gone wrong with the Steam client. A simple restart of Steam is usually enough to resolve the issue, but you need to make sure the Steam Client Bootstrapper is actually closed (Ctrl+Alt+Del to open Task Manager, select the Bootstrapper and then click End Task). Alternatively a quick restart your machine usually sorts the problem out.

Microsoft Media Foundation

If you see

'Initializing Microsoft Media Foundation failed.'

in your player log then either:

1. Windows Media Player is not enabled
   
2. Microsoft Media Foundation is not installed on your machine
   
3. A newer version of Microsoft Media Foundation is required

First, ensure Windows Media Player is enabled. Sometimes it's not enabled automatically on some Windows operating systems or after some updates.

1. Open the Start menu
   
2. Open the Control Panel
   
3. Launch Programs and Features
   
4. Click “Turn Windows features on or off” in the left side of the window
   
5. Look for the “Media Features”
   
6. Expand the “Media Features”
   
7. Check the “Windows Media Player”
   
   
8. Click OK
   
9. Restart your computer

If the Windows Media Player is already enabled or you still cannot run the game after enabling it then it is likely that Microsoft Media Foundation is not installed on your machine, or it needs updating.

Please install the Media Feature Pack[www.microsoft.com] for your version of Windows. The Media Feature Pack that comes up upon a simple google search is NOT the correct version for Windows 10 after the Creators Update – it’s necessary to look for the newest Media Feature Pack from April 2017 (available here[support.microsoft.com]).

If you are on Windows 10 N, Sunless Skies may not run even after installing Microsoft Media Foundation pack and re-enabling Windows Media Player. Reinstalling Windows 10 resolves the issue.

Unity games on Windows 10 1709

If you see the following error in your player logs then this is due to a bug that was released in Windows 10 1709 that is causing this issue with a lot of Unity games.

IndexOutOfRangeException: Array index is out of range.
at UnityEngine.Display.RecreateDisplayList (System.IntPtr[] nativeDisplay) [0x00000] in :0

There is an excellent thread about it on Steam with lots of advice on how to resolve the issue. Check out the OP’s troubleshooting steps as it has resolved the issue for a lot of people.

Windows Video Media - missing video codec/media feature pack

If you see the following error in your player logs then you may be missing a media feature pack or a video codec pack.

WindowsVideoMedia error 0x800700ea while reading
C:/Program Files (x86)/Steam/steamapps/common/Sunless Skies/Sunless Skies_Data/sharedassets0.resource
Context: CreateObjectFromByteStream
Error details: More data is available.

There is a good thread about it on Steam with advice on how to resolve the issue. Some of our players have resolved this issue by going into the K-Lite Codec Tweak Tool, checking under Windows Media Foundation, and manually unchecking all of the boxes

Windows Video Media - NVIDIA graphics cards

If you experience a black screen after the loading screen when starting a new game then it’s possible you need to restore the 3D settings on your NVIDIA graphics card. The following error will be seen in your log, though the file path may be different.

WindowsVideoMedia error 0x887a0005 while reading C:/Program Files (x86)/Steam/steamapps/common/Sunless Skies/Sunless Skies_Data/resources.resource

Context: IMFSourceReader::WaitForSample in StepAllStreams
Error details: The GPU device instance has been suspended. Use GetDeviceRemovedReason to determine the appropriate action.

Track types:
   Unreadable Track

If you see this error then take the following steps:

1. Open the NVIDIA Control Panel
   
2. Select Manage 3D settings from the menu on the left
   
3. Click Restore
   

Missing Executable

When the executable goes missing from the installation folder then it's down to an overzealous anti-virus. Avast in particular is a well known culprit and can do this with Sunless Skies and a number of other Steam games. Occasionally you won’t even get the pop-up notification that the .exe has been moved to the virus chest, so you're just left with a missing executable and no clue as to what just happened.

You'll need to go into your virus chest and restore the executable and then add an exception so it doesn't happen again.

Crash/Freeze when using Transit Relays

If you experience a crash, black screen or a game freeze/hang when using a Transit Relay, (or at the point of Character Creation) please take the following steps:

1. Relaunch the game
   
2. On the Title Screen select Options > Graphics
   
3. Set the Texture Quality to Low
   
4. Click Apply
   
5. Back out of the menu and then click Continue
   
6. Try going through a relay/character creation again

N.B. If there is no improvement, particularly on low-spec machines, try also running the game in windowed mode rather than full screen.

A number of our players have also found it helpful to clear their Steam cache. You can do this as follows:

1. From your Steam Client, open the Settings panel by selecting "Steam > Settings" from the top left client menu.
   
2. In the Settings panel, select the Downloads tab and you'll find the "Clear Download Cache" button at the bottom.
   
3. Then select "OK" to confirm and acknowledge that you'll need to login to Steam again.

Crash/Freeze when entering Character Creation

If you experience a crash, black screen or a game freeze/hang at the point of Character Creation, please take the same steps in the Crashes when using Transit Relays section above.

Crash when launching from Steam client

If you experience a crash when launching Skies from the Steam client but not when launching from the .exe then it's possible this is a result of your DPI being set higher than 100%, with the game running on fullscreen. We understand you probably want to keep your DPI setting as is, however you may need to change the DPI when you play Skies, in order for it to work properly.

To resolve this issue, change your DPI back to 100% or whatever is recommended for your PC (from the Start menu select Settings > System > Display > Scale and layout).

Crash on launch: Citrix

If you experience a crash when first launching the game then check for this error in your logs:

Crash!!!
SymInit: Symbol-SearchPath: '.;C:\Program Files (x86)\Steam\steamapps\common\Sunless Skies;C:\Program Files (x86)\Steam\steamapps\common\Sunless Skies;C:/WINDOWS;C:/WINDOWS/system32;SRV*C:/websymbols*http://msdl.microsoft.com/download/symbols;', symOptions: 534, UserName:

If you see this it's possible another application is interfering with the game.

Citrix Workstation (formerly Citrix Receiver) causes this issue with a number of Unity games. Try uninstalling Citrix, restarting your machine and launching Skies again (we have reports from players that Skies will continue to play without issue once the latest version of Workstation is reinstalled).

If you are unsure if you have Citrix then you can check for the program in your Control Panel:


Or if the app was installed via the Microsoft store you'll be able to find it on the Start menu:

Crash on launch: XMP-enabled RAM

If you experience intermittent crashes when playing the game then check for this error in your logs:

Crash!!!
SymInit: Symbol-SearchPath: '.;C:\Program Files (x86)\Steam\steamapps\common\Sunless Skies;C:\Program Files (x86)\Steam\steamapps\common\Sunless Skies;C:/WINDOWS;C:/WINDOWS/system32;SRV*C:/websymbols*http://msdl.microsoft.com/download/symbols;', symOptions: 534, UserName

First you should check if you have Citrix installed (see section above). If not then it’s possible you’re experiencing an issue that is sometimes seen with Unity and XMP-enabled RAM. We recommend you turn down the RAM clock speed in your BIOS and that should resolve the issue.

Crash on launch: Corrupted Font Files

If you experience a crash when launching the game then check for this error in your logs:

Crash!!!
SymInit: Symbol-SearchPath: '.;C:\Program Files (x86)\Steam\steamapps\common\Sunless Skies;C:\Program Files (x86)\Steam\steamapps\common\Sunless Skies;C:/WINDOWS;C:/WINDOWS/system32;SRV*C:/websymbols*http://msdl.microsoft.com/download/symbols;', symOptions: 534, UserName

First you should check to see if you have Citrix installed as per the instructions in the section above. If you don’t have Citrix installed, then the Symbol-SearchPath crash is likely to be a result of corrupted font files on your machine. This is a fairly common bug which affects numerous Unity games.

Solution #1
First, ensure that your graphics card drivers and direct X are fully up to date before trying to run the game again (see section ‘Video Card Drivers’ above).

Solution #2
If you're playing on Windows 10 try running in compatibility mode for Windows 8.

Solution #3
If the above solutions don’t work then try restoring default font settings:

1. Make sure no programs are currently running
   
2. Go to Control Panel > Fonts > Font settings
   
3. Click the "Restore default font settings" button
   
4. Restart your machine and attempt to play Sunless Skies

Solution #4
If the above solutions don’t work, try deleting the font cache files:

1. Make sure no programs are currently running
   
2. Open Windows File Explorer and go to "C:\Windows\ServiceProfiles\LocalService\AppData\Local" (it's a hidden folder so it's best to just copy-paste the file path. If the full file path doesn’t work try C:\Windows\ServiceProfiles\LocalService\AppData)
   
3. Attempt to delete any files whose names start with "FontCache" (some will be write-protected; you can skip those)
   
4. Restart your machine and attempt to play Sunless Skies

Solution #5
If the above solutions don’t work, then try deleting the hidden UNCL.ttf file:

1. Make sure no programs are currently running
   
2. Open Windows File Explorer and select the View tab
   
3. Click Options
   
4. Click the View tab on the Folder Options pop-up window that opens
   
5. Ensure "Show hidden files, folders and drives” radial is selected
   
6. Uncheck "hide protected operating system files" checkbox (we recommend you undo this step later as this exposes Windows OS files which can break your computer if deleted)
   
7. Click Yes on the confirmation pop-up
   
8. Click Apply and OK
   
9. Copy the path "C:\Windows\Fonts" into the top of the Windows File Explorer
   
10. If there's a file in there called "UNCL.ttf" or similar, delete it (it may be called PR Uncial Alternative Capitals)
    
11. Remember to go back and tick the "hide protected operating system files" checkbox
    
12. Restart your machine and attempt to play Sunless Skies

Solution #6
If the above solutions don’t work, then it's possible you have a corrupted font but can't find it. Follow these steps to replace it.

1. Uncheck "hide protected operating system files" as directed in Solution#5
   
2. Download UNCL.ttf (you can download it here[www.grsites.com])
   
3. Drag the UNCL.ttf file from your Downloads folder into the Font directory (C:\Windows\Fonts) - it will either install immediately or ask you if you want to replace the already installed version, in which case select Yes (it may be referred to as PR Uncial Alternative Capitals)
   
4. Now locate the newly installed/replaced UNC.ttf file and delete it.
   
5. Remember to go back and tick the "hide protected operating system files" checkbox
   
6. Restart your machine and attempt to play Sunless Skies

Solution #7
If the above solutions don’t work and you still cannot find the UNCL.ttf file, then here's a last resort:

1. Uncheck "hide protected operating system files" as directed in Solution#5
   
2. Make a backup copy of the Fonts directory (to your desktop, for example)
   
3. Delete everything Windows will let you delete in the original Fonts folder
   
4. Now Copy every file from the backup Fonts folder you created back into the original Fonts folder.
   
5. The UNCL.ttf file should be there - delete it
   
6. Remember to go back and tick the "hide protected operating system files" checkbox
   
7. Restart your machine and attempt to play Sunless Skies

If none of the above steps can solve the issue then we are unlikely able to offer a better solution at this time. The problem is frequently reported across several popular Unity titles without much sign of a solution as of yet.

Low Performance / FPS

If you are experiencing poor performance in game then the first thing to do is make sure your graphics card is up to date. Please see the Video Card Drivers section above.

If you are experiencing exceptionally low FPS it could be that your graphics card has defaulted to the Microsoft Basic Render Driver. Please see the Video Card Drivers section above for more details.

If your graphics card is up to date and it is not defaulting to the Basic Render Driver when running Skies, then try setting the Texture Quality to low:

1. From the Title Screen select Options
   
2. Select Graphics
   
3. Change Texture Quality to Low
   
4. Click Apply

We also recommend making sure your Windows updates are in fact up to date and that you close down any non essential programs whilst playing Skies.

Lower spec machines, particularly those with integrated graphics cards, can struggle with the textures in Skies. This can present as d3d11 errors spammed to your player log and sometimes an eventual crash when the game is run for a long period of time. If you are seeing errors like these then please follow the advice above for updating your drivers and setting Texture Quality to low.

Machines with integrated graphics cards tend not to have a huge amount of VRAM. We recommend 2GB VRAM as a minimum. Your VRAM can be seen right at the top of the player log:



If you are below this or just on the border then Skies can be affected by low FPS. Again, the advice for updating drivers and setting Texture Quality to low may help. There are also lots of good guides/tutorials[appuals.com] out there on how to increase VRAM. These tips may not increase it by much, but they are definitely worth a try.

Running the game in Windowed mode rather than Full Screen can also help. We appreciate Windowed mode is not ideal, and we'd like to introduce a Borderless in the future if we can. Since the desktop would not be rendered underneath the game this would make Full Screen less intensive.

Hardware Issues

It's normal to experience hardware issues from time to time; crashes, Windows updates that can't be cancelled, sudden power cuts, etc. However if you are experiencing consistent and repeated hardware problems (crashes, hangs, blue screen of death) then we really recommend taking your rig to an IT professional to have it looked at. Following all the advice above will only help so much. If you have underlying hardware issues then you need to eliminate the root cause of the problem.

Manual backups of save files

If your computer crashes when the game is saving then this can lead to corrupted save files - advice on repairing save files is given in the Black Screen Issues: Corrupt Save Files section above.

If you're experiencing frequent hardware issues then it might be a good idea to make regular manual back-ups of your save files after each play session. For Sunless Skies the easiest way would be to zip up your Lineage folder within the characterrepository directory (see the Where to find your save files section above).

If you have more than one Lineage folder then it's a good idea to zip up the whole characterrepository. The zip will not affect anything in these locations and will remain untouched should you suffer a crash or power cut while playing. If all your save files become completely corrupt, you can unzip the file and copy the json files back into the correct lineage folder.

MacOS: Steam error after downloading updates

Occasionally a Steam error is seen when trying to launch the game after an update.



If you see this please uninstall the game via Steam and then reinstall (don't worry, it just uninstalls the game files, your save files are in a separate location and are not removed when the game is uninstalled, so you will not lose your progress).

MacOS: Broken Headlight

If headlights and lighthouse beams are casting shadows over non-existent terrain like in the screenshots below then try forcing OpenGL.

Steam

1. Right-click on the Sunless Skies under your Library in Steam and select Properties.
   
2. Under the General tab you’ll see the Launch Options section
   
3. Enter -force-glcore or alternatively -force-opengl into the launch options field
   
4. Close the game’s Properties window and launch the game

GOG

1. Open Sunless Skies in your Library in GOG Galaxy and click the Settings icon next to the Play button.
   
2. Go to Manage Installation > Configure
   
3. On the pop-up window tick the Custom executables/arguments checkbox for Launch Parameters - this will open up existing executables/arguments below
   
4. Click ‘Duplicate’ underneath the default File 1 executable - this will populate File 2
   
5. In the Arguments field enter -force-glcore or alternatively -force-opengl
   
6. Make sure the Default executable radial is selected for File 2
   
7. Click OK
   
8. Launch the game.

MacOS: Transparent Facet Screen

On some OSX devices you may see a completely transparent Facet interface.

This happens regardless of whether or not you have transparent interfaces enabled in the settings. To fix the issue, take the following steps - this is a temporary fix and will need to be done each time you run the game:

1. Open the pause menu
   
2. Select Options > Graphics
   
3. Toggle the resolution to a different one than the one currently set
   
4. Click Apply
   
5. If you wish, at this point you can toggle back to the previous resolution you had

MacOS/Linux: Missing Result Text / Transparent Interfaces

Occasionally you may experience transparent interfaces and missing text in the quality results of Storylets.



The first thing to do is check your graphic drivers are up to date (see the Video Card Drivers section above). If updating drivers does not help then there are several other things to try.

Verify Game Files

If you experience missing quality text results and/or transparent interfaces please try verifying your game files:

Steam

1. Right click on Sunless Skies in your library
   
2. Select Properties
   
3. Click on the Installed Files tab
   
4. Click Verify Integrity of Game Files

GOG

1. Select your game from your library
   
2. Select the Settings icon next to the Play button
   
3. Highlight Manage Installation and select Verify / Repair

Epic

1. Locate the game in your library
   
2. Select the Settings Menu button next to the game's icon (three horizontal dots)
   
3. Select Manage
   
4. Click Verify

Launch Options

If verifying the game files does not help then please take the following steps:

Steam

1. Right-click on the Sunless Skies under your Library in Steam and select Properties.
   
2. Under the General tab you’ll see the Launch Options section
   
3. For Windows, enter -glcore into the launch options field. For MacOS/Linux enter -force-glcore.
   
4. Close the game’s Properties window and launch the game.

GOG - Windows / MacOS

1. Open Sunless Skies in your Library in GOG Galaxy and click the Settings icon next to the Play button.
   
2. Go to Manage Installation > Configure
   
3. On the pop-up window tick the Custom executables/arguments checkbox for Launch Parameters - this will open up existing executables/arguments below
   
4. Click ‘Duplicate’ underneath the default File 1 executable - this will populate File 2
   
5. In the Arguments field enter -glcore for Windows or -force-glcore if you are on MacOS.
   
6. Make sure the Default executable radial is selected for File 2
   
7. Click OK
   
8. Launch the game.

GOG - Linux
Enter -force-glcore into the console, then the command to run the game

Epic

1. Locate the game in your library
   
2. Select the Settings Menu button next to the game's icon (three horizontal dots)
   
3. Select Manage
   
4. Toggle Launch Options to on
   
5. For Windows, enter -glcore into the launch options field. For MacOS/Linux enter -force-glcore.
   
6. Close the pop-window and launch the game

UI Transparency

If all else fails, then set the UI transparency in game to 'off'.

1. From the Title Screen select Options
   
2. Select Graphics
   
3. Change Transparent UI to Off
   
4. Click Apply

Linux: Graphical Corruption

If you experience graphical corruption on non 16:9 resolutions on Linux (as shown in the images below) then use “-force-glcore42 -force-clamped” as outlined here[www.gamingonlinux.com].

N.B. Using “-force-vulkan[forum.unity.com]” as a launch option will also resolve the corruption but unfortunately detach your headlight from your locomotive so we don't recommend it.

Linux/Windows: Minimised game window

Occasionally players experience the game opening at a resolution of 0 x 0 pixels and are therefore unable to play (audio can be heard, but nothing is displayed). We're uncertain on the cause but if this happens to you, please try the following:

Linux

1. Go to ~/.config/unity3d/Failbetter Games/Sunless Skies/
   
2. Open the prefs file and scroll right to the bottom
   
3. Find <pref name=”Screenmanager Resolution Height” type=”int”>xxx</pref> and change the value of xxx to 720
   
4. Find <pref name=”Screenmanager Resolution Width” type=”int”>xxx</pref> and change the value of xxx to 1280
   
5. Save the file and close it before launching the game

Windows

1. Go to C:\Program Files (x86)\Steam\steamapps\common\Sunless Skies
   
2. You’ll see the Sunless Skies app. Please press and hold down Ctrl, then double click on the game. Keep Ctrl pressed down the whole time until the Sunless Skies Configuration window opens (if it doesn’t open first time, just double click again)
   
   
3. Select a resolution from the drop down list
   
4. Click play to launch Skies

Weapons are not firing

There are few things to be aware of with regards to weapons not firing:

• Weapons will not fire when the mouse cursor is over any UI or HUD element (with the exception of the Heat/Full Steam Mode bar) - this is deliberate so that they do not fire when you are clicking on interfaces.
  
• If you are holding down a weapons button for continuous fire, the weapon will cut out when your engine overheats. This is to stop you taking damage to your Hull. You can of course press it again to fire immediately without having to wait for your engines to cool down, but you'll receive 10% Hull damage.
  
• If you have started a new save game and are in the Opening Gaming Experience (i.e. before docking at New Winchester and going through character creation) you need to collect a weapon from the wreck of the Ozymandias before you are able to blast your way through the barrier.

If the situations above do not apply to you and your weapons are definitely not working, even after remapping the keys, then you need to restore the control scheme to defaults. This will clear any previous settings that have become muddled after updates in which the control scheme has been changed.

1. Relaunch the game.
   
2. On the Title Screen select Options > Controls
   
3. Click Restore Defaults
   
4. Back out of the menu and then click Continue

Localisation

Unfortunately we have no plans to localise Sunless Skies. We really wish we could have translated Skies into other languages. Unfortunately, it would be a massive undertaking for us, both administratively and financially.

There are currently over 800,000 words in the game. To produce a good translation, we'd need to pay for all of the following for each language:

• The translation itself.
  
• Editing, to ensure the text is clear, grammatical, and consistent in how it handles any special in-universe terms, like 'Avid Horizon', 'Judgement' or 'Her Renewed Majesty'.
  
• Proofreading, to fix spelling errors and other typos.
  
• QA, to catch any bugs related to the translation. A simple example would be the UI not allowing enough space to display translated text if it's longer than English original.

Given the number of words involved, the cost of this would be quite substantial, even for a single language. And we'd also have to source people for all these tasks (or pay a large additional premium for an agency), solve some design challenges around the way we use dynamic text, do technical work on the game to support localisation (for instance, finding and removing all hardcoded strings), oversee and manage the work, and integrate the translated text into the game... a large undertaking for a small indie team like us.

We are sorry to disappoint you, we really do wish we could localise Sunless Skies, and if we ever make a game with a less absurd word count, we'd be keen to localise. (Maybe 100,000 words or so – a lot for almost any other indie game, but extremely restrained by our standards.)

Modding Support

Sunless Skies unfortunately wasn’t really built to support modding. It's something we considered adding after launch but we’ve reluctantly concluded it would be a very large amount of work to do so at this stage. In future, we intend to give more consideration to the ramifications of our development choices on the possibility of mod support, so that we can hopefully provide it in games for which there might be community modding interest.

'Not a Bug'

There are a number of things in game which people sometimes think are working incorrectly, but they are in fact 'not a bug'. These are listed below.

Some are deliberate design choices ("it's not a bug, it's a feature"). Some have arisen from changes made during development after listening to feedback, and after balancing the game in the days before launch. If you played during Early Access and things work in a different way to how you remember, then that's likely to be a deliberate change.

Please also be aware that while our fan-run wiki[sunlessskies.gamepedia.com] is a wonderful source of information, it has existed since we launched in Early Access. Fans have been updating it ever since, but it does mean that you will occasionally come across inaccurate information. It's an excellent resource, but please use it with a pinch of salt rather than treating it as word of law.

With this in mind, please only report bugs that you actually experience in game. Reporting inconsistencies in the wiki can waste our time investigating things that aren't bugs. As a small team without dedicated support, this has a big impact on our development time - time we could be using to write new stories or create new features.

Full Steam Mode is not activating

You can only activate Full Steam Mode once you have equipped an engine capable of FSM to your locomotive. There are three engines in game which allow you to use FSM: The Goneril, The Tisiphone and The Devourer or Distance.

Full screen mode is not remembered on Linux

Apologies for this, we know it's annoying. It's actually deliberate at the moment because during Early Access launching the game in full screen on some Linux machines caused the game to crash. With very few Linux players at the time it was hard for us to gather data on what was causing this, so we made it default to windowed mode on launch each time. Our intention is to fix this in the future once we can diagnose the issue properly.

Hidden Compartments do not boost hold space

This is intended. There are several pieces of locomotive equipment in game which grant the Hidden Compartments quality. When you have this quality a new bar will appear on your Hold underneath the Hold capacity bar. This quality does not increase your maximum Hold space, but it does provide secret places in which to stash your illegal goods. If your Contraband quality is higher than your Hidden Compartments quality then you are more likely to have items seized by the Revenue Man. If Contraband is lower than Hidden Compartments then your captain may be particularly savvy at finding ways to sneak things through customs.

Labels are in the wrong place

This is actually not a bug but a deliberate placement of the label. 'Major' labels are usually close to ports, but it's not always the case. For example the Brabazon Workworld major label is closer to the Transit Relay than it is to the Brabazon dock. Some labels such as Magdalene's are fairly close to the port itself but are not necessarily triggered by docking at the port, you'll need to explore the surrounding area a little.

The directions to a port has changed in my journal

If you see the directions from a hub (central) port to a port in an outer segment change in the journal then this is deliberate. This is related to how our procedural generation system works and we'll explain with the use of a diagram of the segments in the Reach:



New Winchester is obviously the hub port in segment 1. If on a new save you are given a quest to go to Prosper and are told it's due north of New Winchester, then it means the proc gen system has spawned Prosper in segment 2. If you find it on that playthrough and dock there, then that segment becomes locked into place for that captain and it will never change. If however you don't find it and turn the game off (or even back out to the title screen while you make a cup of tea), then the next time you load back into the game, any undiscovered segments may have shuffled, so the Prosper port could this time be in segment 5 for example. This is then reflected in any directions displayed in the journal, or on prospects within your hold.

Pending Prospects cannot be handed in

Some prospects have requirements just like branches on storylets. You may be eligible for a prospect when you claim it at a hub port, but if your circumstances change before you can deliver the goods, then you will be prevented from handing the prospect in. If you no longer meet the prospect’s requirements, the quality requirement icon below it will be greyed out. Mousing over it will give further details.

The Bazaar has a bargain for the same good as a pending prospect

We appreciate this looks odd and may feel like a bit of an exploit when it does happen, however we don’t consider this to be a bug. The bargains that appear at non-hub bazaars are randomly selected from an available pool, and sometimes you will get lucky in this way.

Narratively, since they are different merchants it’s plausible that a seller may be trying to offload a good that someone at the same bazaar is trying to acquire, but that doesn’t mean they’ve necessarily stumbled upon each other yet. Consider your Captain as the savvy wheeler-dealer who has jumped in as the middleman in order to make a tidy profit.

Reworking the Prospects and Bargains system to “fix” this would be a huge undertaking. Since it’s such a minor issue we’d rather pour our time into adding new content, improving the usability of the game and making quality of life updates. For this reason it’s highly unlikely we will ever change this feature.

Stovepipes attack me even though I'm aligned with them

There are variants of the London vessels internally known as 'tipped-off' Enduring Dreadnoughts/Ministry Monitors. They are indistinguishable from the regular models but one of their wrath provocations looks for the Contraband quality. If you are carrying any contraband items (Firkin of Red Honey, Trunk of Illicit Literature, Hogshead of Starshine) they will attack you even if your Stovepipe reputation is high and you are not “Wanted by the Stovepipes”.

The explanation for this is given in the storylet that introduces them. A snippet from one branch is given in the spoiler below:

"All of them fancy scopes and sounding-equipment? That's for spotting smugglers. The Revenue Men put a lot of money into this."

The bridge is cramped, crammed with state-of-the-art sensory equipment. You put your eye to the main scope, and it flings your sight through the Monitor's precisely-aligned lenses and away to a distant stretch of the sky.

'Not a Bug', continued...

I cannot find the transit relay in Albion

After we redesigned Albion in the Wayfarer update (April 2019) it reset the chart/Fog of War for that region. Occasionally people with a save file that was already in Albion at the time of the redesign struggle to find the transit relay to return to the Reach.

The relay is part of the permanent landscape of the Brabazon segment, it's not a random spawn, so if you cannot find it on your map you've just not gotten close enough to uncover it. Below is a screenshot of the chart to show where the relay is in relation to The Bit Between/Brabazon dock.

In this screenshot the Brabazon segment has spawned north of London.

Partial Success

Occasionally we get bug reports asking why someone is seeing a Partial Success result when their chance of success based on their skill level is 100%.

While some may interpret it as a failure, the important thing to note here is that a Partial Success is not a failure result. Our CMS for Sunless Skies allows us to have four types of branch result, two failure states and two success outcomes. Partial Success is one of the two success states.

If you select a branch which has two success outcomes and your roll is successful, you will then be presented with either an all-out success or a partial one based on another chance roll. Of course the Partial Success may have more consequences or a slightly less favourable outcome, but it is a success all the same.

Censored words

Occasionally you’ll see words that look as if they’ve been censored.

Our motive here isn't censorship, it's worldbuilding. There is actually no profanity filter on Skies, this is a deliberate, edited choice in our prose. Dashing out the middle of swear-words was an occasional Victorian habit, and is a nice, low-effort way to establish our period and some of its (often hypocritical) habits.

Something that Glisters

Occasionally we are sent bug reports for the chart label Something that Glisters, with the question 'do you mean glistens?'. Nope, we definitely mean glisters. It's a fairly archaic word[www.dictionary.com] that is akin to glisten and we rather like it.

The Something Dark icon is not on the chart legend

We are often asked why this icon is missing from the chart legend. Think of it as Eleutheria's version of the question mark icon, which also doesn't feature on the legend.

Eleutheria is so dark that all scouts - even Discerning ones like the Cyclopean Owl and Intrepid Cavy - struggle to identify discoveries, so they mark their finds with a Something Dark crescent moon icon. However just like the question mark icon, when you get within reach of the discovery the chart updates the icon to reveal what it actually is; something ghastly, something grave, etc.

Intentional typos

Some things that have been reported as typos, but are intentional include: zailor; zee, eery; words ending in -ise and other British English usages.

Some words and names may be spelled differently in dialogue in order to hint at a character's accent. For example, you may see Wilma as Vilma when German characters are speaking.

Mme. Lumière's shop is missing

If you played in Early Access you may remember Mme. Lumière's shop was at New Winchester. This was deliberately removed on launch for balancing reasons. Instead, there are new Storylets at a number of ports which allow you to trade story items for Sovereigns and Experience.

• The Midnight Confessional, at the Gentleman's platform at Pan will buy Villainy items (Crimson Promise, Unlicensed Chart, Savage Secret, Tale of Terror)
  
• The Porphyry Font at Titania will buy Bohemian items (Captivating treasure, Moment of Inspiration, Vision of the Heavens, Sky-Story)
  
• The Celestial Exhibition at the Royal Society will buy Academic items (Searing Enigma, Condemned Experiment, Otherwordly Artefact, Uncanny Specimen)
  
• The Silken Salon at London will buy Establishment items (Royal Dispensation, Cryptic Benefactor, Ministry-Stamped Permit, Salon-Stewed Gossip)

[legend869]

maybe I'm missing something but I just purchased the pellinore class trader and it won't let me place items in the aux slots ie wit and vinegar winch and pulley (was pre installed when purchased from previous ship) as well as pneumatic mining array. searched google but no luck. am I missing something? mirrors is high enough for winch and pulley.

[SpringSayuri]

This is exactly what happened to me:
N.B. If both your autosave and autosave_backup files have been partially corrupted then sadly there is no way to recover save games in this state.

Now Captain Devitt and her crew will forever remain in the port of New Winchester, with the hope of soon flying to London with the Rat Brigade in search of new adventures...

[baam3]

ForeverForced I also have the same exact issue of booting up the game and the mouse just vanshing.

[ForeverForced]

Cursor disappears as soon as game loads... I have changed resolution and about every setting available, even updated my Graphic drivers... still no cursor after the main menu loads.

[Micha]

I've got the 0x0 window glitch in Windows 10. Holding down control does nothing, the game just loads as normal.

[The. Duck.]

Hi! I sent a crashes report to [e-mail], is it still the right place to sent it?

[sean_ix]

Other Black Screen Issues
Windows Video Media - NVIDIA graphics cards
If you see this error then take the following steps:
1. Open the NVIDIA Control Panel
2. Select Manage 3D settings from the menu on the left
3. Click Restore

I don't understand why this worked, but it did. I went back and changed all the global settings to what I had before I "Restore" them and the game still plays now. Just-in-case you are like I was and did not want to try this solution.

[MadVik]

Hi guys. I've just bought the game and after installing it a black screen and a cursor is all I can see. Ive tried to solve it with some of the fixes listed above - especially the black screen related - but nothing worked so far (the game didnt even start properly so I guess that might be the reason that I didnt even find some files, maybe they were not even created). I really appreciate the work of others who put together this impressive guide but to be honest it is very long, overwhelming. If I start the exe I get a black screen if I want to use the configuration app it says that the game is already running and exit. Is there any automated program that could check whats wrong?

[vdx_zdv]

I tried emailing my crash files to [e-mail], but the autoresponse said "This email is no longer used for Sunless Skies feedback or bug reports." I did use the F8 tool with a description of my problem, but is there anywhere I should send my actual crash logs? Thank you.

[failbetterfuzz]

@chani.aaliyah, for keys you need to email [e-mail] along with your backer number please.