How to install mods on a Starbound server

Starbound mod Installation

The Starbound Steam Workshop contains thousands of mods. This guide will show you how to install them on your server.

Download mods to your computer

  1. Open Steam on your computer
  2. Go to the Starbound Steam Workshop
  3. Pick the mods you want to install
  4. Subscribe to the mods, so they can be downloaded by Starbound
  5. Open Starbound to automatically download the mods

Prepare mods for upload

  1. Open the Steam folder on your computer
    • By default, C:\Program Files (x86)\Steam\ on Windows
    • By default, ~/.steam/ on Linux
    • By default, ~/Library/Application Support/Steam/ on macOS
  2. Open the steamapps/workshop/content/211820/ folder to find the mods you downloaded
  3. Each mod folder containes a contents.pak file
  4. Get copies of all contents.pak files and rename them to avoid naming conflicts

Upload mods to your server

  1. Start your server
  2. Pause your server
  3. Open the Config screen in the app
  4. Upload all your mod .pak files to gameserver/mods/
  5. Restart your server and start playing

Example

If you subscribed to and downloaded the Frackin' Universe mod, you will find the contents.pak in one of the following folders on your computer, depending on your operating system:

C:\Program Files (x86)\Steam\steamapps\workshop\content\211820\729480149\
~/.steam/steamapps/workshop/content/211820/729480149/
~/Library/Application Support/Steam/steamapps/workshop/content/211820/729480149/

To avoid naming conflicts with other mods' contents.pak files, you can rename your copy to FrackinUniverse.pak before uploading it to your server.