BekaForge Dialogue Graph System
← BekaForge
Unity Documentation Portal  ·  version 4.0.0

Dialogue Graph System 4.0 documentation.

Customer documentation for one DGS package containing Core, Banter, Sound/Walla, AI Extension, Camera Controller, and Interaction. AI Providers is separate and needed only for AI features.

Start with Getting Started Build your first dialogue Browse node types DGS 4.0 changelog Beka Forge Docs Hub

What the project does

Dialog Graph System is a Unity toolkit for authoring branching conversations in a graph editor and playing them back through a runtime UI. It includes a JSON round-trip workflow, action nodes, a history panel, transcript rebuilding, and theme-driven runtime presentation.

1 Bundled Dungeon Market sample
9 Graphs shown in the Home capture
Optional AI assisted authoring

Graph Editor Overview

MarketFriend graph overview in the Graphs workspace, with its node canvas, sidebar, and minimap.

Choose what you want to build

A conversation with choices

Create a small graph, connect its nodes, put it in a scene, and test both answers. Start here if you are new to DGS.

Background sound and Walla

Build a layered sound sequence, preview it, create its scene player, and bind sound to a dialogue graph.

Connect an AI provider

Install the separate Providers package, choose a transport and model, and configure credentials on your own machine.

Create dialogue with AI

Connect the included AI Extension to your provider, make a small request, review the proposed changes, and validate the result.

Connect DGS to gameplay

Use the runtime API when a button, NPC, or gameplay event needs to start or control a conversation.

Each setup guide gives you a small working example, exact editor paths, checkpoints, and fixes for common problems. Click a screenshot to inspect the real editor at full size.

Key features

Graph-based authoring

Connect dialogue, choices, conditions, variables, and gameplay actions visually. The MarketFriend overview shows the graph canvas, authoring sidebar, and minimap.

MarketFriend graph overview in the Graphs workspace, with its node canvas, sidebar, and minimap.

Runtime playback

Use TextMeshPro-backed UI for speaker names, portraits, typewriter effects, skip, autoplay, and choice handling. The runtime capture shows what a working conversation looks like in Play Mode.

Runtime dialogue UI

JSON workflows

Export and import graph JSON for backup, review, migration, and controlled external tooling.

Action nodes

Run UnityEvent bindings or coroutine-based gameplay handlers through DialogActionRunner and IActionHandler.

History and transcripts

Show a player-facing conversation backlog. Rebuild a transcript from the current graph and recorded branch choices; see the guide for limits after graph edits.

Visual themes and settings

Use dialogue themes and the UI Theme Editor to configure presentation. The Settings workspace separates runtime text, choices, audio and UI from editor preferences.

DGS Settings > Text with reveal, skipping, and auto-advance controls.

Graph validation and editor cleanup

Run Validate Graph from the Graphs sidebar to review errors, warnings, and information messages. Format Layout arranges nodes.

See the current 4.0 editor

These native Unity screenshots document the DGS 4.0 editor. Open any image to zoom in, or browse all 51 clean editor screenshots.

Home and graphs

DGS Home shows nine graphs with MarketTutorial selected.
Home lists nine graph assets, with MarketTutorial selected.

Banter setup

Open the sample, create a kit, and validate collections.
Open the sample, create a kit, and validate collections.

Detached graph Sound window

Detached graph Sound window for MarketMerchant.
Detached graph Sound window for MarketMerchant.

Graph sound assignment

MarketMerchant graph Sound panel with two tracks, paused audition, and status “Rejected: No change”.
MarketMerchant Sound panel: two tracks, paused audition, and “Rejected: No change”. This does not establish successful binding or audible playback.

AI authoring settings

DGS Graph AI settings showing authoring limits and batching controls; provider controls are not shown.
Graph AI authoring limits and batching settings; provider controls are not shown.

Start here

Getting Started

Quick repo orientation, demo scenes, and the smallest runtime setup to get the system running.

Installation

Unity requirements, package assumptions, scene setup checklist, and runtime/editor setup basics.

Quick Tutorial

Create a graph, wire a dialogID, trigger playback, and inspect the branch transcript.

Architecture

Review the editor/runtime split, data flow, extension points, and current coupling boundaries.

4.0 Changelog

Review the prepared package scope and publication status.

Support

Find troubleshooting, public issue reporting, and private support channels.

License

Understand the Unity Asset Store license that applies to this package.

Examples and common workflows

Node Reference

Fields, ports, browser examples, and Unity steps for every node kind.

Inspector Reference

Contextual setup notes for assets and scene components.

Camera, Interaction, and UI

Configure camera IDs, interaction prompts, UI appearance, and locales.

Create a dialog graph

Build a branching conversation, map it to a dialogID, and trigger it from gameplay code.

Integrate action nodes

Connect action nodes to UnityEvents or async handlers without overloading the dialogue layer.

Review JSON workflows

Understand export/import responsibilities, DTO mapping, and the safest way to move graph content between tools.

Review history and transcripts

Understand the difference between the history panel and exact branch transcript reconstruction.

Included sample entry point

Open Assets/Beka Forge/Dialogue Graph System/Samples/2DMarketDemo/Scenes/MarketDemo.unity and press Play to explore the bundled Dungeon Market integration sample.

ScenePurpose
MarketDemo.unityDialogue, Banter, Camera Controller, and Interaction integrated in one sample scene.