Borderlands 3 Save File Editor by Gibbed A save file editor by gibbed is still in development. However, things are taking longer than hoped as Rick is working on this in his spare time. Check back if anything has changed. Gibbed for helping extract the protobufs from the initial exes, as well as figuring out the encryption/decryption of the profiles. Apocalyptech for creating the google sheet that I use to create a list of cosmetics for unlocking. BrokenNoah for creating the cool free icons for Borderlands 3; Gearbox Software obviously for creating BL3.

I have the editor set to xbox 360 saves, extracted the save file via Modio 5, and I’ve used your software before with no issues (a few years ago though). I don’t have any of the DLC and the save file I’m trying to upload was originally dated from October 2014. BTC: 3HNkaRu9Xjd8uAUV95XoyAzf4pGK8Abehw. I saw in their warning, they just explain if you don't log into psn, and upload the saves, you can't bring your local save to other ps4. But it said if it is within the same ps4 then it should work. By the say I only use official backup and restore. I backup the saves using the payload also, but I never have a chance to use it.

Latest version

Released:

Borderlands 3 Savegame Editor

Project description

This project is a commandline Python-based Borderlands 3 Savegameand Profile Editor. It's a companion to the very similarCLI editor for BL2/TPS,and provides some very similar functionality. It can be usedto level up your characters, unlock Mayhem modes early in thegame, unlock TVHM, add SDUs, unlock equipment slots, and more.

This editor has only been tested on PC Savegames -- other platforms'savegames are not supported at the moment.

Please keep the following in mind:

This app does not have any graphical interface. You must beon a commandline in order to use it.
The app has only very limited item-editing capability at themoment, which is restricted to:
- Item Levels can be changed
- Mayhem Level can be set on items
It does not offer any direct ability to alter Guardian Rank status.
While I have not experienced any data loss with the app,take backups of your savegames before using this, andkeep in mind that it could end up corrupting your saves. Ifyou do encounter any data loss problems, please contact meand I'll try to at least fix whatever bug caused it.

Installation

This editor requires Python 3, and has beentested on 3.7 and 3.8. It also requires the protobuf package.

The easiest way to install this app is via pip/pip3. Once Python 3 isinstalled, you should be able to run this to install the app:

Once installed, there should be a few new commandline utilities availableto you. The main editor is bl3-save-edit, and you can see its possiblearguments with -h/--help:

There's also a bl3-save-info utility which just shows some informationabout a specified savefile. You can see its possible arguments with-h/--help as well:

If you've got a raw savegame protobuf file that you've hand-edited (orotherwise processed) that you'd like to import into an existing savegame,you can do that with bl3-save-import-protobuf:

Alternatively, if you've got a savegame exported as JSON that you'd liketo import into an existing savegame, you can do that withbl3-save-import-json:

Finally, there's a utility which I'd used to generate myBL3 Savegame Archive Page.This one won't be useful to anyone but me, but you can view its argumentsas well, if you like:

There are also profile-specific versions of most of those commands, whichcan be used to edit the main BL3 profile.sav:

Upgrading

When a new version is available, you can update using pip3 like so:

You can check your current version by running any of the apps with the-V/--version argument:

Notes for People Using Windows

This is a command-line utility, which means there's no graphical interface,and you'll have to run it from either a Windows cmd.exe prompt, or presumablyrunning through PowerShell should work, too. The first step is toinstall Python:

The recommended way is to install Python from python.org.Grab what's available in the 3.x series (at time of writing, that's either3.8.2 or 3.7.7), and when it's installing, make sure to check the checkboxwhich says something like 'add to PATH', so that you can run Python from thecommandline directly.
If you're on Windows 10, you can apparently just type python3 into a commandprompt to be taken to the Windows store, where you can install Python withjust one click. I've heard reports that this method does not provide theability to add Python to your system PATH, though, so it's possible thatrunning it would be more complicated.

When it's installed, test that you can run it from the commandline. Open upeither cmd.exe or PowerShell, and make sure that you see something like thiswhen you run python -V:

If that works, you can then run the pip3 install bl3-cli-saveedit commandas mentioned above, and use the commandline scripts to edit to your heart'scontent.

Running from Github

Alternatively, if you want to download or run the Github version ofthe app: clone the repository and then install protobuf (you canuse pip3 install -r requirements.txt to do so, though a pip3 install protobufwill also work just fine).

You can then run the scripts directly from the Github checkout, thoughyou'll have to use a slightly different syntax. For instance, rather thanrunning bl3-save-edit -h to get help for the main savegame editor, youwould run:

The equivalents for each of the commands are listed in their individualREADME files, linked below.

Finding Savegames

This app doesn't actually know where your savegames or profiles are located.When you give it a filename, it'll expect that the file lives in your 'current'directory, unless the filename includes all its path information. When launchinga cmd.exe on Windows, for instance, you'll probably start out in your homedirectory (C:Usersusername), but your savegames will actually live in adirectory more like C:UsersusernameMy DocumentsMy GamesBorderlands 3SavedSaveGames<numbers>.The easiest way to run the utilities is to just use cd to go into the dirwhere your saves are (or otherwise launch your commandline in the directory youwant). Otherwise, you could copy the save into your main user dir (and thencopy back after editing), or even specify the full paths with the filenames.

For instructions on using the Savegame portions of the editor, seeREADME-saves.md.

FOr instructions on using the Profile portions of the editor, seeREADME-profile.md.

Would anyone appreciate an option to delete Fabricators? Hm.
If we fail to read a savefile or profile, might be nice to actually checkif it's the other of profile-or-savefile, and give a more helpful message inthose cases.
Something a bit more Enum-like for various things in __init__.py; Iknow that's not very Pythonic, but when dealing with extra-Python dataformats, one must sometimes make exceptions.
Unit tests?

The encryption/decryption stanzas in BL3Save.__init__ and BL3Save.save_towere helpfully provided by Gibbed(rick 'at' gibbed 'dot' us), so many thanks for that! The protobuf definitionsare also provided by Gibbed, from hisBorderlands3Protos repo,and used with permission. Gibbed also kindly provided the exact hashingmechanism used to work with weapon skins and trinkets.

The rest of the savegame format was gleaned from 13xforever/Ilya'sgvas-converter project: https://github.com/13xforever/gvas-converter

Many thanks also to Baysix, who endured an awful lot of basic questions aboutpulling apart item serial numbers. Without their help, we wouldn't haveitem level editing (or nice item names in the output)!

Basically what I'm saying is that anything remotely 'hard' in here is all thanksto lots of other folks. I'm just pasting together all their stuff. Thanks, all!

All code in this project is licensed under thezlib/libpng license. A copy isprovided in COPYING.txt.

Various BL3 Savegame/Profile editors have been popping up, ever since Gibbedreleased the encryption details. Here's a few which could be more to yourliking, if you didn't want to use this one for whatever reason:

Baysix's Web-Based Editor - Just web-based fornow; sourcecode release is still forthcoming.
Raptor's CLI Tools - These are written

Bl3 Gibbed Save Editor Ps4