bl3-convert

bl3-convert

v1.1.8

Introduction

bl3-convert is a Node.js CLI JSON-helper tool that assists in converting PS4/PS5 save files to PC and vice versa.

Since SaveWizard doesn't allow inventory modification, a lot of modders seek to convert their PS4/PS5 saves into PC format so they can achieve that.

When you decrypt your PS4/PS5 file in SaveWizard, the save needs further changes to the JSON format before it can be properly converted to a PC save (or vice versa).

So, put simply,bl3-convert helps you do that.

This package enters in a small but effective position in the workflow for editing Borderlands 3 save games. Since using bl3-cli-saveedit is also required (along with owning SaveWizard PS4 MAX - Paid), it doesn't self-proclaim to solve much of the puzzle other than cutting out what is often a manual step in the conversion process.

Not sure?

• Try it out live (no local install required), on CodeSandbox
• Open your save file in the editor (drop and drop it in) and search for "nickname_mappings" or "active_league_instance_for_event"
  • (To watch for the JSON change)
• Click 'New terminal' and enter node cli -e -o $FILE to convert the JSON format to PC
• Enter node cli -u -o $FILE to convert it back (to PS4)

Installation

• Node.js 18+
• npm i -g bl3-convert

Usage

• bl3-convert -h
• bl3-convert -e -o $FILE
• bl3-convert -u -o $FILE

Further usage

• SaveWizard PS4 MAX
• bl3-cli-saveedit
• ZakisM Save Editor

Prerequisites

• Installed Python 3 (Added to PATH)
  • Installed protobuf
  • Installed bl3-cli-saveedit
• Installed Node.js 18
  • Installed bl3-convert
• Downloaded VSCode (or another text-editor)
• Have SaveWizard (Paid)
• Have a PC save file (Find one here (in the repo): ./example/PC.sav)
• Have a formatted USB for PS4/PS5
• Have a Backup of your legitimate save file

Walkthrough

Disclaimer: bl3-cli-saveedit requires a legitimate PC save in order to carry out the conversion.

PS4 - USB

• Copy save file from PS4/PS5 to USB
• Load save file in SaveWizard

PS4 - PC

• Export save file from SaveWizard (Advanced mode)
• Use bl3-convert -e -o $FILE to apply JSON fixes for PC save
• Use bl3-save-import-json -j $FILE -t $FILE2 to convert the PS4 save file to a PC save
• Now, use your save editor (here, I used Zaki's, but you can use bl3-cli-saveedit of course!)

PC - PS4

• Once edited, use bl3-save-edit -o json $FILE $FILE2 to covert the PC save back to a PS4 save
• Use bl3-convert -u -o $FILE to apply JSON fixes for PS4 save
• Copy all JSON and paste into Save Wizard Advanced mode window
• Click Apply

USB - PS4

• Once you've saved your file in SaveWizard after pasting in the updating JSON, you can re-sign your save if needs be
• Copy file from USB back onto PS4 and overwrite your current save
• Happy modding!

Credits

• Apocalyptech: bl3-cli-saveedit: https://github.com/apocalyptech/bl3-cli-saveedit
• ZakisM - bl3_save_edit: https://github.com/ZakisM/bl3_save_edit
• ProtoBuffers - Game Saves: https://github.com/xcier/Project-2
• ProtoBuffers - Se7enSins post (and YouTube video) on the topic: https://www.se7ensins.com/forums/threads/convert-pc-ps4-saves-with-save-wizard-borderlands-3-wonderlands.1835089/

This package is a modding tool designed to enhance and/or customise the gameplay experience of a popular AAA game. It is designed to be used for educational and entertainment purposes only and is in no way affiliated with the game's creators or owners. We do not condone or endorse the use of mods to cheat or gain an unfair advantage in the game and all intents of this package are for offline use ONLY. Use this package at your own risk.