DOS2 Savegame Tools

A tool to unpack, edit, and repack savegame files from Divinity Original Sin 2.

What can you do with it?

• Unpack savegames – Extract LSV files into individual files
• Edit files – Convert LSF files to readable XML (LSX) and back
• Repack savegames – Combine edited files back into a single LSV file

Requirements

You need Node.js (version 18 or higher).
If not installed yet: nodejs.org

Installation

1. Download or clone this folder
2. Open a terminal and navigate to the folder
3. Run npm install
4. Run npm run build

Usage

All commands are run in the terminal. Each command starts with node dist/cli.js followed by the command.

Unpack a savegame

Create a target folder and unpack the LSV file into it.

node dist/cli.js unpack QuickSave_14.lsv ./extracted

Extract LSV directly to LSX

Use extract-lsx to unpack an LSV file and convert all LSF files to LSX in one step. The output folder will contain only LSX files (no LSF files).

node dist/cli.js extract-lsx QuickSave_14.lsv ./lsx-only

Edit workflow

1. Extract – Unpack LSV and convert LSF to LSX in one step

   node dist/cli.js extract-lsx QuickSave_14.lsv ./lsx-only

2. Edit – Use CLI edit commands or open LSX files in a text editor

   node dist/cli.js edit savetime ./lsx-only --year 127 --month 3 --day 17
   node dist/cli.js edit mods ./lsx-only
   node dist/cli.js edit party-order ./lsx-only 3,1,2,4,5
   node dist/cli.js edit client-data ./lsx-only --slot 1 --rotation 90 --distance 20
   node dist/cli.js edit party-xp ./lsx-only 50000
   node dist/cli.js edit info ./lsx-only

3. Pack – Convert LSX back to LSF and repack

   node dist/cli.js pack-lsx ./lsx-only QuickSave_14_repacked.lsv

4. Optional: Cleanup – Remove LSX files after packing

   node dist/cli.js pack-lsx ./lsx-only QuickSave_14_repacked.lsv --cleanup

Repack a savegame

Pack (LSF files): Scans the directory and packs all files with Zlib (like Divine).

Pack-LSX (LSX files): Scans the directory, converts LSX→LSF and packs everything.

Convert LSF to LSX (for editing)

LSF files are binary and hard to read. After converting to LSX you can edit them with a text editor.

Command reference

| Action | Command | | -------------------------- | ---------------------------------------------------- | | Unpack | node dist/cli.js unpack file.lsv target-folder | | LSV → LSX (+ PNG etc.) | node dist/cli.js extract-lsx file.lsv target-folder | | Repack (LSX) | node dist/cli.js pack-lsx source-folder output.lsv | | Repack (LSX) + cleanup | node dist/cli.js pack-lsx source-folder output.lsv --cleanup | | Repack (LSF) | node dist/cli.js pack source-folder output.lsv | | LSF → LSX | node dist/cli.js convert file.lsf file.lsx | | LSX → LSF | node dist/cli.js convert file.lsx file.lsf | | Edit savetime | node dist/cli.js edit savetime folder [--year N --month N ...] | | Edit mods | node dist/cli.js edit mods folder | | Edit party-order | node dist/cli.js edit party-order folder 3,1,2,4,5 | | Edit client-data | node dist/cli.js edit client-data folder [--slot N --rotation X ...] | | Edit party-xp | node dist/cli.js edit party-xp folder [value] | | Edit waypoints/recipes | node dist/cli.js edit waypoints folder | | Edit time-of-day | node dist/cli.js edit time-of-day folder [value] | | Edit info | node dist/cli.js edit info folder |

Help

Use help or --help to see an overview of all commands.

Web Editor

Dieses Projekt enthält nur die CLI-Tools. Für eine Web-Oberfläche zum Bearbeiten von Savegames siehe das separate Projekt dos2-savegameeditor.

Supported games

• Divinity Original Sin 2 (DOS2)

License

Apache License 2.0 – see LICENSE for details.