Starbound Support FAQ

Please read through the following before contacting us for support! A lot of common issues are described here. If after reading through the information below your issue is still not resolved, then please post on our support forums (or email us if you feel that would be more appropriate, e.g. private billing issues).

Pre-order Related

(Applies to purchases made on PlayStarbound.com)

Crash-related Issues

Miscellaneous


Pre-order Related

How do I download Starbound?

  1. Download and install the Steam client and make a Steam account if you do not have one.
    • A non-Steam version will later be available for those who pre-ordered through our site/Humble, but Steam is the only way to download the game and receive updates at the current moment. You will have the option of both the Steam version and the non-Steam version once the former is available.
    • Note that Steam is not required to play the game after downloading it aside from downloading updates.
  2. When you pre-ordered, you should have received an email from Humble. If you can’t find this email/aren’t sure if you got it (the subject is typically “Your Starbound ‘tier name’ Tier order is ready”), you can have it resent using Humble’s key resender.
  3. From the above email, you should find a link to a page on humblebundle.com. It should bring you to a page that looks like the following (click the image to enlarge it):
    humble-steamkey
  4. In the section outlined by the dashed orange box in the above image, where it says “XXXXX-XXXXX-XXXXX,” you should see an option to generate a Steam key.
  5. Copy the key you generated in step 4 and follow these instructions to redeem the key in your Steam client.
  6. After following the instructions linked in step 5, you should find Starbound under the “Library” tab of Steam. Click on Starbound in the Library tab and select the “Install” option in the main panel to the right (this will become a “Play” button after the download) to install the game.

How do I download the soundtrack?

  1. When you pre-ordered, you should have received an email from Humble. If you can’t find this email/aren’t sure if you got it (the subject is typically “Your Starbound ‘tier name’ Tier order is ready”), you can have it resent using Humble’s key resender.
  2. From the above email, you should find a link to a page on humblebundle.com. It should bring you to a page that looks like the following (click the image to enlarge it):
    humble-soundtrack
  3. In the section outlined by the dashed blue box in the above image, click the “MP3″ option on the right side of that section to download the soundtrack.

How do I redeem my other rewards? (Silver Tier pre-orders and higher)

  1. When you pre-ordered, you should have received an email from Humble. If you can’t find this email/aren’t sure if you got it (the subject is typically “Your Starbound ‘tier name’ Tier order is ready”), you can have it resent using Humble’s key resender.
  2. From the above email, you should find a link to a page on humblebundle.com. It should bring you to a page that looks like the following (click the image to enlarge it):
    humble-rewards
  3. In the section outlined by the dashed pink box in the above image, click the button (shown as “YYYYY-YYYYY-YYYYY” in the above image).
  4. This should bring you to a Rewards page on PlayStarbound.com, and will allow you to claim your other rewards. Pixel Tier purchasers will only see a link back to their Humble page and a field to update their email address.

I lost the link to my Humble key page or I don’t think I ever received one. What do I do?

  1. Try using Humble’s key resender with the email you purchased from. It resolves most issues.
  2. If the above doesn’t work, try with any other email you could have used (e.g. secondary email, work/school email) as this is the second most common problem.
  3. Finally, if neither of the above resolved your issue, contact us at [email protected].

Crash-related Issues

Mac OS X: I receive the message “The application has quit unexpectedly.” whenever I try to launch Starbound.

My game crashes with an IOException/Leaf Block error!

These are world corruption errors, generally caused by conflicting third-party mods.

  • You can solve this issue by deleting the “universe” folder from your Starbound directory, which will reset any worlds you’ve visited. Typically, you’ll find your “universe” folder here:
    • Windows (32-Bit): C:\Program Files\Steam\steamapps\common\Starbound\dist\universe
    • Windows (64-Bit): C:\Program Files (x86)\Steam\steamapps\common\Starbound\dist\universe
    • Mac OS X: /Users/USER/Library/Application Support/Steam/SteamApps/common/Starbound/dist/universe
    • Linux (32-Bit): ~/.local/share/Steam/SteamApps/common/Starbound/dist/universe
    • Linux (64-Bit): ~/.local/share/Steam/SteamApps/common/Starbound/dist/universe

Other Troubleshooting Tips

Disable the Steam overlay

  1. Click the “Settings” button in your Steam window, then click on “In-Game Settings”.
  2. Uncheck the box next to “Enable Steam Community In-Game” and click OK.
  3. Disable the Steam Overlay on specific games only by right-clicking on the game title, click on “Properties” and uncheck “Enable Steam Community In-Game” in the “General” tab.

Launch the game in OpenGL mode (Windows)

  • In the Starbound launcher, instead of clicking the “Launch Starbound” button, click “Launch Starbound (OpenGL)” as shown in the image below (click the image to enlarge it):
    launcher-opengl

Launch the game without Steam running

  • Navigate to the folder you have Starbound installed to and run the program directly from there. Typically, this is usually the following file:
    • Windows (32-Bit): C:\Program Files\Steam\steamapps\common\Starbound\win32\starbound.exe
    • Windows (64-Bit): C:\Program Files (x86)\Steam\steamapps\common\Starbound\win32\starbound.exe
    • Windows, OpenGL (32-Bit): C:\Program Files\Steam\steamapps\common\Starbound\win32\starbound_opengl.exe
    • Windows, OpenGL (64-Bit): C:\Program Files (x86)\Steam\steamapps\common\Starbound\win32\starbound_opengl.exe
    • Mac OS X: /Users/USER/Library/Application Support/Steam/*/Starbound.app/Contents/MacOS/starbound/Starbound.app
    • Linux (32-Bit): ~/.local/share/Steam/SteamApps/common/Starbound/linux32/starbound
    • Linux (64-Bit): ~/.local/share/Steam/SteamApps/common/Starbound/linux64/starbound

Miscellaneous

I’m a YouTuber/live streamer; can I have permission to record and monetize Starbound footage?

Yes! Please see our regular FAQ page for exact details.

What are the system requirements to play Starbound?

Starbound is still in development and being optimized for older machines. For now, a list of our minimum system requirements can be found here or on our Steam store page.

What are the unstable/nightly branches and how do I switch to them (or back)?

The “nightly” branch of the beta receives updates automatically every single day at 6AM London time. This means that using the nightly branch will frequently destroy your saves or contain other game-breaking issues depending on what we’ve been working on that day. This branch is intended for people who want to track development progress. Only use this branch if you really really want to follow our progress and don’t care about breaking the game.

The “unstable” branch of the beta receives updates more frequently than the main stable branch and isn’t tested as thoroughly. It may also destroy saves or contain other issues, which will be fixed as they’re discovered and before they’re pushed to the stable branch. This branch is intended for people who want to test for bugs/issues. Only use this branch if you don’t mind potential game-breaking bugs!

To switch between branches (click on images to enlarge them):

      • Right-click on Starbound in your Steam client’s “Library” tab and select “Properties”:
        unstable-step1
      • In the window that appears, select the “Betas” tab and then select the branch you want to use from the first drop-down.nightlybuilds
      • You should receive a confirmation message along the lines of “Successfully opted into the ‘nightly’ content beta.” below the textbox next to the “Check Code” button (note: no beta access code is required to opt into the unstable or nightly branches).
      • Click close and let Steam download the update for the new branch. If you’ve switched to the nightly or unstable branch, Starbound should now be listed as “Starbound [nightly]” or “Starbound [unstable]” in your Steam library, otherwise it will be listed as just “Starbound”.
        starbound_nightly

I don’t see an option to play/launch Starbound in the game’s launcher.

The launcher should display four buttons at the bottom of the window (as indicated in the screenshot below; click it to enlarge). If you don’t see these buttons, it is likely because the launcher window is larger than your screen resolution, in which case you should try to launch Starbound directly.

launcher-opengl