Starbound Mod Installation

Starbound Mod Installation - База знаний

This guide covers how to install, manage, and troubleshoot mods on your Starbound dedicated server, including Steam Workshop support and manual mod installation. For initial server setup and configuration, see Starbound Server Setup Guide. For admin commands, see Starbound Admin Commands.

Server Panel: All server management is done through GPanel at gpanel.legionhosting.net. Use the File Manager or SFTP to upload mod files.

Enabling Workshop Support

Starbound supports Steam Workshop mods on your dedicated server. To enable Workshop support, you must set the WORKSHOP startup variable.

Stop your server in GPanel.
Go to the Startup tab.
Set the WORKSHOP variable to 1.
Start the server.

Adding Workshop Mods

Browse the Starbound Steam Workshop and find the mods you want to install.
Copy the Workshop Item ID from the mod's URL. The URL format is:
https://steamcommunity.com/sharedfiles/filedetails/?id=ITEM_ID
On your server, locate or create the Workshop configuration. Depending on your egg setup, mods may be specified via a configuration file or a startup variable. Check the GPanel Startup tab for any mod-related fields.
Alternatively, you can manually install mods by downloading them and uploading the mod .pak files to the mods/ directory on your server via the File Manager or SFTP.
Restart the server to load the new mods.

Manual Mod Installation

If you prefer not to use the Workshop, or a mod is not available on the Workshop:

Download the mod files (typically a .pak file).
Stop your server.
Upload the .pak file to the mods/ directory on your server.
Start the server.

Mod Load Order

Starbound loads mods in alphabetical order by filename. If you have mods that depend on other mods, ensure the dependency mod's filename comes first alphabetically, or consult the mod author's installation instructions for specific load order requirements.

Important Notes

Client-server mod matching: For the best experience, all players connecting to a modded server should have the same mods installed on their client. If allowAssetsMismatch is set to false in your server config, players with mismatched mods will be unable to connect. Even with it set to true, mismatched mods can cause visual glitches, missing items, or crashes.

Mod compatibility: Adding or removing mods on an existing universe can cause issues with items, blocks, or creatures added by those mods. Always back up your storage/ directory before making mod changes. If you experience crashes or errors after adding mods, try removing recently added mods one at a time to identify the conflict.

Need Help?

If you are experiencing issues not covered in this guide, our support team is available to assist. Open a ticket at legionhosting.net/submitticket.php with your server details and a description of the problem.

Starbound Mod Installation - База знаний

Поддержка

Категории

Starbound Mod Installation