Graph Editor

The graph editor provides the authoring surface for creating DialogGraph assets and their node sub-assets.

Key files

• DialogGraphLauncherWindow.cs
• DialogGraphEditorWindow.cs
• DialogGraphView.cs
• View/Elements/Nodes/*
• DialogGraphLayoutFormatter.cs
• DialogUndoUtility.cs

Authoring entry point

Open Tools → Dialogue Graph System → Dialogue Graph. The launcher window is the main entry point and lets you open the last edited graph, choose an existing graph, or create and open a new graph.

How graph assets are stored

The editor stores the graph as one DialogGraph asset with multiple node sub-assets attached to it. This keeps save/load and import/export simpler than storing each node separately.

Right sidebar — four tabs

The editor window is a split-view with the graph canvas on the left and focused side panels for different authoring concerns.

• Characters — bulk-assign speaker names, portraits, and voice clips to all nodes for a given character at once.
• Actions — browse and manage DialogActionSO assets; see which action IDs are available before wiring them into action nodes.
• Context — maintain scene summary and related graph context data used by the core authoring workflow and optional integrations.
• Environments — define reusable environment context that can be associated with the authoring workflow.

Format Layout and validation

The toolbar exposes a Format Layout button that runs DialogGraphLayoutFormatterEditor.FormatLinkedSubgraphOnly — it re-spaces nodes in the connected subgraph without touching unconnected ones. A separate Validate button opens the graph validation window with click-to-select navigation for any errors or warnings found.

View-state persistence

Pan position, zoom level, and sidebar toggle state are saved per graph in EditorPrefs. Reopening a graph restores exactly where you left off.

GraphView responsibilities

• zooming, dragging, and selection
• grid and minimap
• context-menu node creation
• graph save/load synchronization
• start/end node guarantees
• undo-aware structural changes

Common mistakes

• modifying node data without marking the graph dirty
• bypassing undo utilities when adding or removing assets from the graph
• treating GraphView state as authoritative instead of the serialized asset

Launcher window

Browse existing graph assets, create a graph, and open localization tools from the central launcher.

Graph editor overview

The current graph canvas, toolbar, minimap, and focused authoring sidebar.

Characters and Actions

Manage speaker metadata and available action IDs without leaving the editor workflow.

Context

Maintain graph context, scene notes, and related authoring data in one panel.

Environments

Create and review reusable environment context available to the authoring workflow.

Variables

Review the variables available to graph conditions and dialogue logic.

New dialogue dialog

The creation prompt for new graph assets — sets the dialog ID before opening the canvas.