Starbound

Starbound

163 vurderinger
Unpacking Mods: A Basic How-To
Af Myrin Zyw'n
A quick guide on unpacking mods, for when you don't know how to explain.
Whether it's finding out why your hair looks bad, how to get a recipe, or just pure curiosity, this guide will have your back.
5
   
Pris
Føj til foretrukne
Gjort til foretrukken
Fjern som foretrukken
Step One: Finding the Target
I can't open a box without knowing where it is, can you?
You also can't open a box you don't have, so a subscription to the target mod is required.

  1. Go to the steam page of the mod you want to investigate.
  2. At the top of the page there should be a number after ?id=
  3. This number is the [mod id], copy it.
  4. In your library, right-click Starbound > Manage > Browse local files.
  5. Replace the matching section at the top of your file manager with the path listed below.
  6. Replace the [mod id] section with your number and press enter, your target is the .pak within.
Windows: \SteamApps\workshop\content\211820\[mod id]
Linux: /SteamApps/workshop/content/211820/[mod id]
Step Two: Setting the Stage
Wait, we can't use our hands?
  1. Copy the contents.pak file.
  2. Open the Starbound folder again.
  3. Open the mods folder, or create a new folder for safety's sake, and place the .pak within.
  4. Go back to the Starbound folder.
  5. Create a new file, and rename it to end with a .bat for Windows.
  6. Open the file with a text editor and paste into it:
    "win32\asset_unpacker.exe" "mods\contents.pak" "mods\unpack"

    (Inverted syntax:)
    "win32\asset_packer.exe" "mods\unpack" "mods\contents.pak"

  7. Adjust to taste, or as necessary, and save the file.
Step Three: Unpack!
Is it working?
  1. Run the .bat (or equivalent).
  2. Wait until the resulting window closes.
  3. In a folder named unpack, within the target folder, should be everything that was in the .pak.
  4. If not, run the file again as administrator. If unable, ask your administrator.
  5. Done!

Notes
FAQ
  1. Crashing will occur if the same mod is both subscribed and in the mods folder at the same time.
  2. Yes, any folder or .pak in the mods folder will be loaded as a mod.
  3. Yes, the .bat needs to be in the Starbound folder, anywhere else will require changes to the .bat.
  4. No, you don't have to have a mod in a .pak to run it, but it may load faster as a single file.
  5. When uploading a mod to the workshop, the .pak will be made automatically, which is why downloading a workshop mod always results in a .pak.
  6. Whether it's for forums or friends, manual packaging can be accomplished with the packer, found next to the unpacker, and a .bat with the inverted syntax found at your local software store in Step Two. - You can also get it by applying Step One to your own mod.
Looking for the base game's .pak? It's in the assets folder with the name packed.pak.
Never put it (or the folder it makes) in the mods folder; something will break.
Rename the .pak or adjust your .bat for the different name.


Does someone need this How-To? Well just send them this!
[url=http://steamproxy.net/sharedfiles/filedetails/?id=745239455]A Basic How-To on Unpacking Mods[/url]

Did this help? If so, please rate the guide so that others can find it!

Credits:
AcidaliaPlanitia - Provided the inverted .bat syntax.
56 kommentarer
Vandal For 1 time siden 
God amongst men. Basically makes an easy unpacker tool for your mods folder, highly appreciated.
Myrin Zyw'n  [ophavsmand] 21. apr. 2024 kl. 21:10 
There's no fundamental reason why you wouldn't be able to, but you can always keep copies of your universe/characters just in case.
Alz3mGam3r 20. apr. 2024 kl. 19:30 
i got it to work after about an hour of trouble shhoting but i am wondering if it works for one mod at a time or is it just move the .pak use the .bat delete the .pak and repeat? i just dont want to break or loses anytrhing
Myrin Zyw'n  [ophavsmand] 21. nov. 2023 kl. 16:29 
The script lives at \Starbound\unpack.bat
Which unpacks \Starbound\mods\contents.pak
To the \Starbound\mods\unpack folder
Using the program \Starbound\win32\asset_unpacker.exe
I thought the steps, or what's written in the script, would make that clear?
LordyWasHere 20. nov. 2023 kl. 16:27 
I actually figured it out on my own but thank you for getting back to me. If i were to comment on something though: where to put the files is the step that confused me and I think, from reading the comments, a few other people.
Myrin Zyw'n  [ophavsmand] 8. nov. 2023 kl. 21:07 
What did you write in the .bat, btw? Might give us more clues to figure this out.
Myrin Zyw'n  [ophavsmand] 8. nov. 2023 kl. 21:04 
That error is rather generic, and the rest doesn't look like anything starbound would log, and WSL isn't related or even helpful for this.
Are you sure it's being run in cmd/Command Prompt? Powershell can't run .bat the normal way.
LordyWasHere 7. nov. 2023 kl. 10:11 
when i ran the .bat file (even as administrator) nothing happened and i got this:

[19308:1107/115557.355:ERROR:settings.cc(410)] Settings version is not 1
[main 2023-11-07T17:55:57.777Z] update#setState idle
[main 2023-11-07T17:56:00.117Z] WSL is not installed, so could not detect WSL profiles
[main 2023-11-07T17:56:27.780Z] update#setState checking for updates
[main 2023-11-07T17:56:27.855Z] update#setState idle

someone please help me :SBpenguin:
Myrin Zyw'n  [ophavsmand] 4. juni 2023 kl. 21:32 
Just remove the file when you're done with it. I was just saying that telling the game to load all the default assets twice will cause issues, only in-game would any weirdness occur.
Orifan1 15. aug. 2022 kl. 0:37 
thank you for making this guide. you have singlehandedly saved everyone trying to make a BYOS patch for races who's mod authors either dont care, or actively try to force FUBYOS usage.