Starbound Workshop Mods Not Working
Aug 11, 2016 After 7 hours of playtime on a clean reinstalled game, all steam workshop mods ceased to load. While doing the 'Ceremonial Caverns' mission, my screen went black, this is most likely an unrelated display driver issue, a pc restart was necessary. After doing so, i launched the game again, just to find that all of my workshop mods didn't initialize. Jul 1, 2014 - You'll most likely find that in your Steam directory, by default in. There are many different race mods for Starbound, and I'm not going to tell. Since we teased it back in October, our developers have been working hard on finalising the Nexus Mods API and today I'm pleased to report we’re ready to open the virtual doors to the public. What is the Nexus Mods API? It’s a set of instructions developers can use to.
I have played Starbound Unstable whit mods and it ran perfectly.
But when I play ordinary Starbound whit more mods, it behaves like I didn't install mods at all.
I'm speaking of mods installed directly in the Starbound mod folder (not true Steam subscriptions)
Here all mods that I have installed:
https://community.playstarbound.com/resources/craftable-chainsaws.4518/
https://community.playstarbound.com/resources/invisible-clothes.2425/
https://community.playstarbound.com/resources/steam-punk.4390/
https://community.playstarbound.com/resources/weapon-assembly.4277/
https://community.playstarbound.com/resources/hunting-wildfire.4971/
https://community.playstarbound.com/resources/augment-crafter.5166/
https://community.playstarbound.com/resources/skippable-cinematics.3730/
https://community.playstarbound.com/resources/black-n-blue-manipulator.5332/
What should I do?
- 1Quick Navigation
- 1.1Step 1 - Unpacking Assets
- 1.2Step 2 - Setting Up Your First Mod
- 1.3Step 3 - Modding
- 1.4Step 4 - Packing your mod
This article will show you the steps you need to take before you can start actually modding, and also the steps you can take after you are done modding, to pack and publish your mod.
You will need a text editor that is not the Windows included notepad.exe, as it does not support UNIX line endings. Do not use a word processor such as MS Word instead of a text editor. Only UTF-8 is supported, other encodings are likely to cause crashes. Optionally, for easier packing and unpacking of mods and assets, you may use ModPackHelper (available for Windows and Linux).
Step 1 - Unpacking Assets
Furious Koala introduced a .pak format which improves loading times and eases mod distribution. This means we need to unpack the assets before we can start modding.
Note - This step will not remove or change your packed.pak file, but simply extract its content for use as reference material. Changes you make to the unpacked assets will have no effect on your game.
Windows
Current as of Version 1.3.1, June 5th, 2017
- Open up the main directory folder for Starbound.
- Shift + right-click within the folder and select Open Command Prompt/Windows Powershell or equivalent (depends on Windows version).
- Type the following into Command Prompt/Windows Powershell:
.win32asset_unpacker.exe '.assetspacked.pak' '._UnpackedAssets'
- Command Prompt/Windows Powershell will do nothing until asset_unpacker.exe has finished, this will take a while on most computers.. There are no progress updates.
- Once Command Prompt displays a message equivalent to this, 'Unpacked assets to UnpackedAssets in 250.063s,' you can close the program and move on to creating mods.
Notes
- If purchased from Steam, the location of the main Starbound directory folder typically looks like this:
SteamsteamappscommonStarbound
- The text typed into Command Prompt are three directory locations:
- The location of asset_unpacker.exe, which is the program that does all of the unpacking.
- The location of Starbound assets, or Mod assets, to be unpacked.
- Where you want the unpacked assets to be dumped. This third string can be changed to whichever location or name you prefer.
It is advised to read the Unofficial Modding E-book instead, available on Chucklefish Forums. http://community.playstarbound.com/resources/unofficial-modding-ebook-2-0.2930/
Mac
Current as of version 1.3.0, June 13th, 2017
If you have purchased Starbound from Steam, then these instructions will work. Otherwise you will have to find your Starbound assets folder and apply the file paths to these instructions.
- Open Terminal.app in OS X (hopefully you have 10.7 or higher)
- Type
cd ~/Library/Application Support/Steam/steamapps/common/Starbound/assets
Now you are in the assets folder. - You need to create a new folder here where you want your unpacked assets to end up. Type
mkdir unpacked
- Now you need to navigate to the asset_unpacker. Type
cd ./osx
- Type
./asset_unpacker ./assets/packed.pak ./assets/unpacked
(The asset_unpacker should finish anywhere from 1 to 500 seconds depending on your computer, so let it work. If it takes longer than 20 minutes, quit Terminal.app and start over. If retrying doesn't work, then you have an issue external to the asset_unpacker.) - In Finder browse to your unpacked folder by clicking on 'Go' on the menu bar, holding the [alt/option] key on your keyboard (this will show Library, which is usually hidden), clicking on Library, then browsing to -> Application Support -> Steam -> steamapps -> common -> Starbound -> assets -> unpacked (sound familiar?).
It is highly recommended that you make a backup copy of your original, working packed.pak before you mod and pack.
To pack, do exactly the same steps as mentioned above (minus making a new folder 'unpacked'), but when you get to step 5, where you actually unpack the packed.pak file:
- Type
./asset_packer ./assets/unpacked ./assets/packed.pak
Linux
Current as of version 1.2.3b, May 26th, 2017
- Open the main directory of starbound in your shell (i.e. /home/clate/.steam/steam/steamapps/common/Starbound if purchased on steam)
- Type the following into your shell:
linux/asset_unpacker assets/packed.pak unpacked_assets
- linux/asset_unpacker is the path to the executable
- assets/packed.pak is the path to the packed assets
- unpacked_assets is the name of the directory, where it'll extract the files in. If the directory doesn't exist, it'll be created.
- There is no progress bar while unpacking, but after completion, it'll print something like this:
Unpacked assets to unpacked_assets in 70.0567s
- After that message appears, you can close the shell (if you want to ;) ) and start creating mods.
Step 2 - Setting Up Your First Mod
_metadata file
This file is entirely optional.
Now that you have a file to tell the game that the mod will load the contents inside, the next step would be to add a _metadata file.The _metadata file is to tell the user who installed the mod the general information about the mod when they check the mod list on the Starbound title screen. This will list the username, the version of the mod, the link to the mod's page and a description of the mod along with who made it.
Create a file called '_metadata' or '.metadata', not '_metadata.txt'! Or else it wont work.
Open the file inside a text editor and paste this information in:
Entry | Description |
---|---|
version | The version number of your mod. |
friendlyname | This is the name that will show up in the mod list menu. |
link | A URL that links to the mod. |
steamContentId | This is the unique id that steam uses, if you are not putting the mod up onto steam's workshop, leave this blank. |
name | (If anyone knows what this argument is for, please update this!) |
description | This is the description of the mod. type 'n' for a new line. |
author | The author of the mod, put in your name here. |
Step 3 - Modding
Tutorials
Reference Pages
If you did everything right, Starbound should load your new mod the next time you run it. If the game crashes, or your changes are not found in the game, check your starbound.log file.
Step 4 - Packing your mod
Before publishing your mod, it is better to pack it as a single <modname>.modpak file.This process is recommended because it simplifies the installation (drop the file in the Starbound/mods/ folder). The alternative is to just put all the files into a zip archive.
Usb flash drive compatible with windows xp. To assemble your mod into a modpak, follow bartwe's post or use ModPackHelper:
Windows/Linux with ModPackHelper
- Follow what is described in #Step 1 - Unpacking Assets (Depending on your operating system).
- When script is launched, choose action 1].
- Then select the mod you want to pack (If your mod folder does not contain a .modinfo file, it will not show as a choice).
- Press Enter. The mod is available in the Starbound/giraffe_storage/mods/ folder as <modname>.modpak.
Step 5 - Publishing
Only one thing left to do - publish your mod! To do this, go to the official modding forums, select 'add mod' in the upper right hand section, select the category of your mod, fill out the information form and hit save. It is that easy.
Starbound Workshop Mods Not Working On Windows 10
There are other places mods can be uploaded, or you can just share it with friends. What you do with your mod is up to you!
External links
- Chucklefish Forums: How to successfully pack and unpack .pak files
- Chucklefish Forums: Getting started in making mods for Starbound
- Chucklefish Forums: Unofficial Modding Ebook 2.0
- Chucklefish Forums: ModPackHelper