This project is a commandline Python-based Wonderlands Savegame and Profile Editor. It's based on apocalyptech's CLI editor for BL3, and provides some very similar functionality. It can be used to level up your characters, level up your gear, set character stats (Hero Skills, Myth Rank), and unlock a variety of character features early: feats/companions, second skill tree (including re-selecting via Quick Change), Chaos Mode, SDUs, 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:
--randomize-guid option for the save editor, this Wonderlands version instead defaults to randomizing the GUID, and provides a --dont-randomize-guid argument.Abram Hindle, who took an early lead in getting this ported over to Wonderlands, is providing a simple web-based version of this utility, so feel free to give that a try:
https://abramhindle.github.io/ttwl-cli-saveedit/
Yes, this will install python and ttwl-cli-saveedit in your browser and give you a tiny UI to dupe your savefiles or import items.
This editor requires Python 3, and has been tested on 3.7 through 3.10. It also requires the protobuf package.
The easiest way to install this app is via pip/pip3. Once Python 3 is installed, you should be able to run this to install the app:
pip3 install ttwl-cli-saveedit
Or, for Abram Hindle's development version:
pip3 install --user git+https://github.com/abramhindle/ttwl-cli-saveedit
Once installed, there should be a few new commandline utilities available to you. The main editor is ttwl-save-edit, and you can see its possible arguments with -h/--help:
ttwl-save-edit -h
There's also a ttwl-save-info utility which just shows some information about a specified savefile. You can see its possible arguments with -h/--help as well:
ttwl-save-info -h
If you've got a raw savegame protobuf file that you've hand-edited (or otherwise processed) that you'd like to import into an existing savegame, you can do that with ttwl-save-import-protobuf:
ttwl-save-import-protobuf -h
Alternatively, if you've got a savegame exported as JSON that you'd like to import into an existing savegame, you can do that with ttwl-save-import-json:
ttwl-save-import-json -h
Finally, there's a utility which is intended to be used to generate the WL Savegame Archive Page. This one won't be useful to anyone but apocalyptech, but you can view its arguments as well, if you like:
ttwl-process-archive-saves -h
There are also profile-specific versions of most of those commands, which can be used to edit the main BL3 profile.sav:
ttwl-profile-edit -h
ttwl-profile-info -h
ttwl-profile-import-protobuf -h
ttwl-profile-import-json -h
When a new version is available, you can update using pip3 like so:
pip3 install --upgrade ttwl-cli-saveedit
You can check your current version by running any of the apps with the -V/--version argument:
ttwl-save-info --version
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 presumably running through PowerShell should work, too. The first step is to install Python:
python3 into a command prompt to be taken to the Windows store, where you can install Python with just one click. I've heard reports that this method does not provide the ability to add Python to your system PATH, though, so it's possible that running it would be more complicated.When it's installed, test that you can run it from the commandline. Open up either cmd.exe or PowerShell, and make sure that you see something like this when you run python -V:
C:\> python -V
Python 3.9.4
If that works, you can then run the pip3 install ttwl-cli-saveedit command as mentioned above, and use the commandline scripts to edit to your heart's content.
Miniconda is a user space python distribution that works on Steam Deck.
Once you've installed it open a new terminal session and it's executables will be in your path.
https://docs.conda.io/en/latest/miniconda.html
Alternatively, if you want to download or run the Github version of the app: clone the repository and then install protobuf (you can use pip3 install -r requirements.txt to do so, though a pip3 install protobuf will also work just fine).
You can then run the scripts directly from the Github checkout, though you'll have to use a slightly different syntax. For instance, rather than running ttwl-save-edit -h to get help for the main savegame editor, you would run:
python -m ttwlsave.cli_edit -h
The equivalents for each of the commands are listed in their individual README files, linked below.
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 launching a cmd.exe on Windows, for instance, you'll probably start out in your home directory (C:\Users\username), but your savegames will actually live in a directory more like C:\Users\username\My Documents\My Games\Tiny Tina's Wonderlands\Saved\SaveGames\<numbers>\. The easiest way to run the utilities is to just use cd to go into the dir where your saves are (or otherwise launch your commandline in the directory you want). Otherwise, you could copy the save into your main user dir (and then copy back after editing), or even specify the full paths with the filenames.
Full documentation for both savegames and profiles are linked immediately below, but as a quick example, here's a command to list information about 2.sav, followed by an edit which saves out to a new 3.sav
ttwl-save-info -i 2.sav
ttwl-save-edit --name 'CoolNewName' --save-game-id 3 --level 40 2.sav 3.sav
For instructions on using the Savegame portions of the editor, see README-saves.md.
For instructions on using the Profile portions of the editor, see README-profile.md.
all value for --randomize-customizations to assume that all customizations are available, rather than having to read the list from a profile?datalib.py; it's super inefficient as-iscli_common.py. The actual functionality is handled in there (levelling items, reroll counts, etc) but there's a fair bit of duplicated code in cli_edit.py and cli_prof_edit.py to handle argument parsing.cli_common.py related to properly pluralizing some of our item-editing user reporting. Would be nice to roll that up a little more properly.Abram Hindle took an early lead in porting the BL3 CLI editor over to Wonderlands, which is much appreciated! All the initial Wonderlands-support framework, and the basic editor functionality is thanks to him.
The encryption/decryption stanzas in BL3Save.__init__ and BL3Save.save_to were helpfully provided by Gibbed (rick 'at' gibbed 'dot' us), so many thanks for that! The protobuf definitions are also provided by Gibbed, from his Borderlands3Protos repo, and used with permission. Gibbed also kindly provided the exact hashing mechanism used to work with weapon skins and trinkets.
The rest of the savegame format was gleaned from 13xforever/Ilya's gvas-converter project: https://github.com/13xforever/gvas-converter
Many thanks also to Baysix, who endured an awful lot of basic questions about pulling apart item serial numbers. Without their help, we wouldn't have item level editing (or nice item names in the output)!
Many thanks to shroomz for figuring out the Myth Rank XP-to-Rank calculation.
Basically what I'm saying is that anything remotely "hard" in here is all thanks to lots of other folks. I'm just pasting together all their stuff. Thanks, all!
All code in this project is licensed under the zlib/libpng license. A copy is provided in COPYING.txt.
There aren't too many Wonderlands save editors in the wild yet. One fork of FromDarkHell's BL3 Save/Profile Editor is currently being maintained by a third party, though:
v1.0.0 - October 15, 2022
--fake-tvhm to handle some edge cases, and removed --unfinish-missionsv0.0.16
v0.0.15
v0.0.13
v0.0.12
v0.0.10
v0.0.9
v0.0.8
v0.0.7
v0.0.6
v0.0.5
v0.0.4
v0.0.3
v0.0.2
v0.0.1