Skip to content

iyre/bl4-save-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

156 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Borderlands 4 - Online Save Editor

Web-based tool for modifying Borderlands 4 (PC) save files.

Features

  • Decrypt .sav file to human-readable YAML
  • Export as re-encrypted .sav file or YAML
  • Manually edit save YAML within the web page
  • Apply preset modifications to character saves
    • Max character level
    • Change class
    • Complete challenges
    • Unlock achievements
    • Unlock all specializations
    • Unlock UVHM & post-game activities
    • Complete story missions
    • Complete all missions
    • Add item serials to backpack
    • Set all items in backpack to character level
  • Apply preset modifications to profile saves (shared between characters)
    • Remove map fog
    • Discover locations
    • Unlock fast travel
    • Complete activities
    • Unlock collectibles
    • Max SDU
    • Unlock vault powers
    • Unlock new game shortcuts
    • Unlock hover drives
    • Unlock cosmetics
    • Add item serials to bank
    • Set all items in bank to max level
  • All DLC content through story pack 1 is included

I don't plan to implement item editing beyond basic preset manipulations.

Usage

  1. Open the online editor linked above or clone the repo and open index.html in any web browser.
  2. Select a .sav file (or .yaml) if you have one.
  3. Enter your Steam or Epic ID - whichever one you license the game through.
  4. Click Import - This will decrypt the save and place the YAML text in the integrated editor.
  5. Export your original save as a backup. Keep these timestamped files in case something goes wrong.
  6. Edit your save as desired - refer to docs for basic info about the structure
    • Apply presets to automatically make common changes that are relatively safe & reliable. These are applied in the editor immediately when clicked. No undo button for now.
  7. Download as .sav
  8. Rename or delete your original save and replace it with the new one, removing the timestamp.
    • Recommended to keep a copy of the new save with the timestamp as a backup (in addition to the pre-edit backup).

Notes:

  • Consider disabling cloud backups for the game to prevent save files from being reverted in some situations.
  • You can safely replace saves while the game is running as long as a different character is selected.
  • Modifying a save for a loaded character wont work as the save is in memory at that point and will overwrite the file on disk.
  • Don't attempt to modify profile.sav while the game is running for the above reason.

Preset Details

These run JavaScript functions which apply pre-configured edits to save files quickly and consistently.

  • You can apply as many presets as you want.
  • They update the YAML text you see in the editor.
  • They're intended to be modular, so you may need to run a few to get the desired effect.
    • Ex. "Unlock collectibles" (character) will technically just "collect" them. You'd also need to apply "Discover locations" (profile) to have them shown on your map.
    • Ex. "Complete challenges" (character) will only set the appropriate counters. Most rewards are granted when you pass the threshold, so you'd also need to apply "Unlock cosmetics" (profile) to obtain them.

Character

  • Max character level
    • Sets character level to the maximum.
    • Sets expected skill points & XP.
  • Change class
    • Changes the character class.
    • Refunds skill points.
  • Complete challenges
    • Completes all counter-based challenges.
    • Does not complete activities or collectibles challenges. See "Complete all missions" and "Unlock collectibles".
    • Does not grant rewards for completion. More info
    • Unlocks some achievements. (UVH 5 & world events confirmed)
  • Unlock achievements
    • Also completes all activities (which are required for a few achievements).
    • Triggers platform achievements (Steam/Epic).
  • Unlock all specializations
    • Unlocks the specialization system. More info
    • Sets maximum level and fully completes all trees.
  • Unlock UVHM & post-game activities
    • Sets values in the save to unlock Ultimate Vault Hunter rank 1-5. You can switch between them in-game.
    • Completes the post-game tutorial mission which unlocks the firmware system, Maurice's Black Market, and Moxxi's Big Encore
    • Doesn't complete any other missions, so you could theoretically play the story from level 1 in UVHM difficulty which isn't otherwise possible.
    • Loading a save with this & story completion will enable starting at level 30 (flag is automatically added to profile.sav).
    • Completes all UVH challenges.
  • Complete story missions
    • Completes all missions related to the main story. Doesn't modify any other missions.
    • Functionally equivalent to starting a new save with the in-game story skip option. (Does not unlock that option)
    • Enables the specialization system.
  • Complete all missions
    • Completes all missions including the main story, vaults, and activities like drill sites.
    • Enables the specialization system.
    • Re-calculates SDU points, applying the new total if it's higher.
  • Add item serials to backpack
    • Adds a user-provided list of serials into a character save (backpack).
  • Set all items in backpack to character level
    • Updates all item serials in character inventory to match the level of the character.

Profile

  • Remove map fog
    • Fully reveals the in-game map terrain by setting fog of war overlay for every map to 100% discovered. Technical details
    • Does not add PoI markers. See "Discover locations".
  • Discover locations
    • Reveals all point of interest (PoI) markers on your map.
    • May trigger achievement for location discovery.
  • Unlock fast travel
    • Unlocks fast travel to all safehouses and silos by completing related mission (activities).
    • Re-calculates SDU points, applying the new total if it's higher.
    • Unlocks safehouse, silo, and town PoI markers.
  • Unlock collectibles
    • Marks all* collectibles as found. ECHO logs, capsules, etc. (bobble heads aren't included)
    • Re-calculates SDU points, applying the new total if it's higher.
    • Does not add PoI markers. See "Discover locations".
  • Max SDU
    • Purchases all SDU upgrades, adding points if necessary.
  • Unlock vault powers
    • Unlocks all vault powers normally granted by completing vaults.
  • Unlock new game shortcuts
    • Enables starting new characters at level 30 with story already complete.
    • Enables the specialization system.
  • Unlock hover drives
    • Unlocks all hover drive tiers and manufacturers.
    • Does not complete the associated kill count challenges. See "Complete challenges".
  • Unlock cosmetics
    • Unlocks all cosmetic items, making them available to all characters.
  • Add item serials to bank
    • Adds a user-provided list of serials into a profile save (bank).
  • Set all items in bank to max level
    • Updates all item serials in bank to have max level (60).

Where Are My Saves?

Windows:

  • Navigate to %USERPROFILE%\Documents\My Games\Borderlands 4\Saved\SaveGames\
    • Steam version will have a sub-folder with a 17-digit name - this is your steam ID which you'll need to encrypt/decrypt save files.
    • Navigate deeper like .\<steam_id>\Profiles\client\
  • 1.sav, 2.sav, etc. files represent characters (import these with the editor)
  • profile.sav contains global state such as black market inventory and bank contents. (the editor also works with this file)

Contributing

Please feel free to submit a pull request!

Please reach out on Discord if you'd like to discuss this project! (link in profile)

Acknowledgements

About

Web-based save editor for Borderlands 4 with preset modifications.

Topics

Resources

License

Stars

Watchers

Forks

Contributors