TMLGen - TML Generator for Editing Existing Cutscenes In Editor

This tool generates the TML file for a given Baldur's Gate 3 cutscene, allowing the cinematic to be easily edited in an unlocked version of the toolkit (such as MoonGlasses).

The GitHub repository for this tool can be found here.

Usage:

The tool requires the path to your unpacked game directory (as unpacked by the Baldur's Gate 3 Modder's Multitool) along with the source file(s) of the timeline(s) you wish to edit. Additionally, you may select the timeline data to use manually. The definitions below detail the data the tool uses.

Game Data Paths

You will be prompted to enter the paths below the first time you run the program.

• []Unpacked Data Directory: Top level of unpacked game data as unpacked by the Baldur's Gate 3 Modder's Multitool. Likely called UnpackedData. This article offers more information on how to unpack the game files if you haven't done so already.

  []Game Data Directory: Contains the .pak files the game uses and is only used when setting the tool to override timelines. The path likely ends with Baldurs Gate 3\Data.

  Single Generation

  • []Source File: .lsf source file of the timeline you wish to edit. Likely located in a Public\<mod name>\Timeline\Generated directory.

  The following files are used only for manual selection and can be ignored for automatic generation.
  • []Generated Dialog Timelines File: .lsf file that contains information linking the timeline and dialog. Likely located in a Public\<mod name>\Content\Generated\_GeneratedDialogTimelines directory.

    []Dialogs Binary File: .lsf file that contains the compiled dialog data. Likely located in a subdirectory of the Mods\<mod name>\Story\DialogsBinary directory.

    []Dialogs File: .lsj file that contains the raw dialog data. Likely located in a subdirectory of the Mods\<mod name>\Story\Dialogs directory.

    []Timeline Templates Directory: Not required (will not be present for timelines with no templates). Contains the templates a timeline uses. Likely located in a Public\<mod name>\TimelineTemplates folder and will be named with the timeline's GUID.

    Batch Generation

    • []Source Directory: The directory containing the timeline source files whose TMLs you want to generate. Note that only .lsf files whose names do not end with _Scene or _Prefetch are used; all others in this directory are ignored.

      Input Examples

      The following details an example set of paths one would use to generate the .tml file for the timeline CAMP_DaisyAcknowledgement_AvD_ROM. Other timelines will have similarly structured input paths.