Archive Editor
A lightweight, Python-based Borderlands 4 save editor. Archives can be exported to YAML format, values can be safely edited and written back to the archive. An executable version is provided.
About this mod Machine translation
A lightweight, Python-based Borderlands 4 save editor. Archives can be exported to YAML format, values can be safely edited and written back to the archive. An executable version is provided.
Borderlands 4 Save Editor
🎮 **A lightweight, Python-based Borderlands 4 save editor**, supporting Epic and Steam platforms!
Learn more: GitHub project page
---
✨ Main functions
- **YAML Export**: Export BL4 archives to human-readable YAML format
- **Character Attribute Editing**: Modify levels, experience points, skills and progress nodes
- **Safe writeback**: Safely write modified data back to the valid archive file
- **Experimental Features**: Shift keys (server side) and some appearance features (may have bugs)
⚠️ **Important reminder**: Please back up your archive before use! This tool directly reads and writes archive files. Please keep a manual backup before modification.
---
🚀 Quick Start
Quick start guide provided by Kuroba Sensei:
**Environmental requirements:**
- Make sure Python and pip are installed
- Install necessary dependency packages:
bash
pip install "pyyaml>=6.0" "typer>=0.12.3" "rich>=13.7.1" "pydantic>=2.7.0" "pycryptodome>=3.15.0"
📋 YAML example (excerpt)
yaml
class: Char_DarkSiren
char_name: Vex
player_difficulty: Hard
experience:
- type: Character
level: 50
points: 3430227
- type: Specialization
level: 57
points: 6863836
🔧 Technical Reference
A partial key and weapon decoder reference based on the Borderlands 4 archive tool.
💡 **Usage Suggestions**: This is a tool under development. It is recommended to test the function on a small-scale archive first to ensure that you are familiar with the operation process before applying it to the main archive.
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- There is no universal mod manager for this game: some mods replace game files directly, some go into a game-specific Mods folder, and some need a game-specific community loader or tool first — follow the bundled readme.
- Place the files exactly as the readme says; mods with listed dependencies need those installed too.
- Launch the game to confirm it loaded; some games require enabling mods in settings or an in-game mod menu.
Install locations vary a lot between games and mods — the bundled readme is the most reliable guide.