Modding:Starbound Log File

From Starbounder - Starbound Wiki
Jump to: navigation, search

Quick Navigation

At the time of the writing of this file, Starbound is only available through Steam. To find the log file for Starbound, go to this path within your Steam directory to locate your log file:


If you run a server, there is a log file specifically for it:


The Starbound log file is a text file where the game engine writes a lot of debugging and status information, along with errors. This file can get quite large, but is overwritten every time the game restarts, so if you want to save any of its information, copy the log file somewhere else.

Using a terminal on Linux/Mac or Windows with Cygwin, you can use this command from the star bound directory:

tail -f starbound.log

to monitor the log in (mostly) realtime; it can sometimes be delayed for a few seconds. For more information on Linux, Cygwin, and the tail command, see your local Google.

On the Mac you can additionally open the log in the GUI from the terminal by using the command:

open ~/Library/Application\ Support/Steam/SteamApps/common/Starbound/starbound.log

For Windows, there are several tail-like options with graphical interface such as mTail.

If you prefer the command line (which is only natural because of its superiority) Cygwin provides a suite of *nix-like utilities for Windows, including a shell with all of the usual commands like tail, cat, grep, egrep, awk, sed, diff, etc.

Mac specific problem with .DS_Store files

Currently (beta v. Offended Koala) the Mac version will crash if the data directory ( ~/Library/Application\ Support/Steam/SteamApps/common/Starbound for Steam users) is opened with the Finder, because doing so creates invisible .DS_Store files, and these cause the Starbound client to crash on launch.

Until the bug is fixed, Mac-based modders can remove the files from their Starbound directory using the terminal (the following command removes them from all steam apps - this should be non-problematic, but if so append the star bound directory name to the path):

find ~/Library/Application\ Support/Steam/SteamApps/common -name .DS_Store -exec rm {} \;