/lslib

Tools for manipulating Divinity Original Sin and Baldur's Gate 3 files

Primary LanguageC#MIT LicenseMIT

LSLib

This package provides utilities for manipulating Divinity Original Sin 1, Enhanced Edition, Original Sin 2 and Baldur's Gate 3 EA files:

  • Extracting/creating PAK packages
  • Extracting/creating LSV savegame packages
  • Converting LSB, LSF, LSX, LSJ resource files
  • Importing and exporting meshes and animations (conversion from/to GR2 format)
  • Editing story (OSI) databases

Requirements

To build the tools you'll need to get the following dependencies:

  • Download GPLex 1.2.2 from here and extract it to the External\gplex\ directory
  • Download GPPG 1.5.2 from here and extract it to the External\gppg\ directory
  • Protocol Buffers 3.23.4 compiler from here (windows) or from here (linux) and extract it to the External\protoc\ directory

Additionally, the liblz4 and granny2 library should be present in your library search path.

Linux

Additional requirements:

  • mono
  • mono-msbuild
  • nuget
  • protobuf

How to build:

wget https://s3.eu-central-1.amazonaws.com/nb-stor/dos/ExportTool/gplex-distro-1_2_2.zip -O External/gplex-distro-1_2_2.zip
wget https://s3.eu-central-1.amazonaws.com/nb-stor/dos/ExportTool/gppg-distro-1_5_2.zip -O External/gppg-distro-1_5_2.zip
wget https://github.com/protocolbuffers/protobuf/releases/download/v23.4/protoc-23.4-linux-x86_64.zip -O External/protoc-23.4-linux-x86_64.zip
unzip External/gplex-distro-1_2_2.zip -d External
unzip External/gppg-distro-1_5_2.zip -d External
mv External/gplex-distro-1_2_2 External/gplex
mv External/gppg-distro-1_5_2 External/gppg
mkdir -p External/protoc
unzip External/protoc-23.4-linux-x86_64.zip -d External/protoc
nuget restore
msbuild
msbuild # (We need to run it twice at the moment)