PAKit by u/OBANx

Installation & Updating

Windows

  1. Download and run the latest installer from the download page.
  2. If you are updating, the installer will handle replacing old files for you.

  3. You may recieve antivirus warning messages. You can ignore these, PAKit is virus free.
    If you are super concerned about security, you can clone the repository and build from source (see below).

MacOS

  1. Download the latest .dmg package from the download page.
  2. Double click the .dmg to open it.
  3. Drag the PAKit app to you applications folder.
  4. If you are upgrading, simply replace the old app file.

  5. When you run PAKit, you may get a warning saying that it is from an unidentified developer. If this is the case, go into your System Preferences, click Security and press Open Anyway near the bottom.

Linux (Ubuntu/Debian)

  1. Download the latest .deb package from the download page.
  2. Double click the .deb to open it in your package manager.
  3. Press Install. You may have to type in your password.
  4. If you are upgrading, the new files should overwrite the old ones.

Building from source

Requires familiarity with git

  1. Ensure you have git and npm/node.js installed
  2. Clone the repository (use the 'master' branch)
  3. Inside the downloaded folder run the command npm run package-<platform> to build from source, where <platform> is either win, mac or linux.
  4. Your build will be output to the release-builds/ folder.
  5. If you want to create an installer, additionally run npm run installer-<platform> to build from source, where platform is either win, mac or linux.
  6. To upgrade, run git pull and redo the above steps.

Unpacking

  1. In the Unpack tab, select your source .pak file. This should open to your Starbound directory by default. The base game assets (packed.pak) can be found in the assets folder.
  2. Select the destiation folder next. A subfolder will be created, so if you select .../Desktop your file will be extracted to .../Desktop/packed/
  3. Now press Unpack. Leave PAKit open until the process is done.
    If you wish to terminate the process at any point, simply close PAKit.

Packing

  1. In the Pack tab, select your source assets folder.
  2. Select the destiation .pak file next. Navigate to you want to save it to and enter a file name.
  3. Now press Pack. Leave PAKit open until the process is done.
    If you wish to terminate the process at any point, simply close PAKit.

Locating executables

If PAKit fails to locate the asset_packer and asset_unpacker executables in your source files, you will have to locate them manually in order to use PAKit.

  1. Make sure Starbound is installed on your system.
  2. Open Steam, and go to your library. Right click on Starbound and open PROPERTIES.
  3. Go the the LOCAL FILES tab, and press BROWSE LOCAL FILES ....
  4. Then open the executables folder (Windows: win32, MacOS: osx, Linux:linux).
  5. Copy your current path, open PAKit and go to the Settings tab.
  6. Press either of the Select buttons, and paste in the path. Select the relevant executable in this folder.
  7. Repeat step 5 for the other executable, and then press Save