Journal Editor Overview

From Baldur's Gate 3 Modding

Navigating the Journal Editor

This guide provides an overview of the Journal Editor. You can open the Journal Editor via the icon that looks like an open journal on the main toolbar of the Editor.

Opening the Journal Editor.

Project Browser

The Project Browser is located on the left of the Journal Editor, and is the default panel that is displayed when the Journal Editor opens. It contains a list of mods, each of which contains its own set of quests.

An image of the project browser of the journal editor
Highlighted: The Project Browser, on the left of the Journal Editor.

Quests Tab

The Quests tab opens when you select a mod from the Project Browser. The Quests tab exposes all of the journal data for editing.

An image of the quests tab in the journal editor.
Highlighted: The Quests tab.

The Quests tab is composed of 5 panels:

  1. Quest Browser
  2. Category Properties
  3. Quest Properties
  4. Objective Properties
  5. Quest State Properties

Quest Browser

The Quest Browser presents the journal data hierarchy for the selected mod. It shows a list of categories and their quests, and each quest exposes its internal structure, made up of subquests, objectives, and steps. For more information on these elements (categories, quests, subquests, objectives, and steps), see Journal Structure Overview.

Each header for a data list has a + button next to it, allowing you to add a new category, quest, subquest, objective, or step to the corresponding list.

An image of the quest browser in the journal editor.
The Quest Browser panel.

Category Properties

An image of the category properties in the journal editor.
The Category Properties panel.
  • CategoryID: A script identifier. It must be a globally unique.
  • Description: The player-facing description.
  • SortingPriority: A numerical value that determines the order in which the categories appear in the Quest Journal UI.
    • Highest priority sets the category on top, while 0 sets the category at the bottom.
    • Categories with the same priority will be arranged according to when they're unlocked.

Quest Properties

An image of the quest properties in the journal editor.
The Quest Properties panel.
  • QuestID: A script identifier. It must be globally unique.
  • Title: The player-facing title of the quest.
  • QuestLevel: A field that determines how the quest is shared among the party.
    • This should typically be Party, which covers the party members of the character that unlocked the quest. Character covers the specific character (e.g. an Origin character) and User covers the characters that belong to the user.
  • SortingPriority: A numerical value that determines where the quest will be listed in the Quest Journal UI.
    • Highest priority sets the quest on top, while 0 sets the quest at the bottom.
  • Visible: A value that determines whether the player can see the quest in the Quest Journal UI.
    • All quests should be visible by default, except for hidden boosters that don't appear in the journal but provide rewards to the player.

Objective Properties

An image of the objective properties in the journal editor.
The Objective Properties panel.
  • ObjectiveID: A script identifier.
  • Description: The player-facing description.
  • Priority: The priority of each objective.
  • Markers: Add the MarkerID of the map marker here if one is needed. See Working with Map Markers.

Quest State Properties

Quest Step Dropdown

An image of the quest step section in the journal editor.
The Quest Step dropdown.
  • StepID: A script identifier.
  • Add/Close Quest: A field that determines whether unlocking the step should change the state of the quest it belongs to. The values are:
    • <empty>: No quest state change. This step will work as a simple update.
    • Add Quest: Unlocking this step will also start the quest. It also works as an update, if the quest has been already started.
    • Add Quest Only: Unlocking this step will start the quest. However, if the quest has already been started, the step unlock will be ignored.
      • Useful for different quest steps hooked to the same event, but that have different descriptions depending on whether the quest needs a starting description or not.
    • Close Quest: Unlocking this step will close the quest.
  • Achievement: This field is deprecated and should be ignored.
  • Description: The player-facing text that the player will see in the Quest Journal UI.
  • QuestTitleOverride: Player-facing text that will override the quest title in the rewards panel if needed.
  • Comment: A developer-facing comment that is usually used to give more context about what triggers this entry.
  • AreaLevelOverrideGUID: The field used to set an area stats trigger for this quest step.
  • ObjectiveID: The entry's objective.

Rewards Dropdown

The Rewards dropdown.

This section is explained in Adding Quest Rewards.

Quest Overview Tab

The Quest Overview tab displays the whole Journal structure in a spreadsheet view. The Quest Overview can be accessed by pressing the corresponding Open Overview button in the Quest Properties window.

An image of the quests overview sheet.
The Quest Overview tab.