Rogue BuildGraph Viewer Runs in your browser

Find the defects in a BuildGraph script before you run it.

Rogue BuildGraph Viewer reads a BuildGraph script for Unreal Engine, with every script it includes, and lists its defects with exact file and line numbers. Then it draws the build as a graph, so you can see how files move between nodes and where work crosses from one agent to another.

Open the viewer See how it works Beta · open to try Runs in your browser · Nothing is uploaded · Nothing to install
On this page How it works What you see Limits Availability
Swimlane graph illustration, with example node and tag names
AGENT · COMPILE AGENT · COOK AGENT · PACKAGE #EditorBinaries #GameBinaries #CookedContent after Compile Editor Compile Game Cook Content Package Publish
Solid wire files passed through a #Tag·Dashed wire ordering only·One lane per agent
The problem

The XML does not show how the build flows.

A BuildGraph script is a list of nodes in XML. Reading it does not tell you which node hands files to which, what a property is worth by the time a node uses it, or which nodes end up on different agents.

Mistakes in those three areas can pass the script's validation without an error. The viewer is built to find them.

How it works

Drop a script on the page and read the report.

The viewer is a static analyser: it reads the script and never runs it. The analysis happens in your browser tab, so no file leaves your machine and no server sees it.

In your browser

Drop the script

Drop a BuildGraph .xml file, or the folder it lives in, onto the page. The viewer follows every script it includes.

First

Read the findings

The report opens with the findings. Each one names the exact file and line.

Then

Check the graph

A swimlane graph backs up the findings: one lane per agent, one box per node, solid wires for real data dependencies and dashed wires for ordering only.

What you see

Three things the XML hides, and the tools to follow them.

Data flowHow files move from node to node through #Tags.
Property expansionHow each property expands, top to bottom, when the script is parsed.
Agent boundariesWhere work crosses from one agent to another. That is where parallelism and file transfers happen.
Node inspectorSelect any node to see its details.
Source viewThe composed script, with every include injected in place.
Tag lensFollow one artifact through the whole build.
Options panelChange option values and see which nodes would run.
Share linkThe link carries the script inside the URL, so nothing is stored on a server.
What it does not do

Known limits.

It does not build anythingThe viewer reads source. It does not run your script, start a build or execute a task.
Some answers need a real runWhere the source alone cannot settle a question, the viewer says so and does not guess.
It is not an Epic Games productRogue BuildGraph Viewer is made by Rogue Component. It is independent, and Epic Games has not made, reviewed or endorsed it.
Availability

Rogue BuildGraph Viewer is in beta.

It is in beta and open to try. It runs in your browser, with nothing to install, and your files stay on your machine.

There is nothing to install. Drop a BuildGraph script, or the folder it lives in, onto the page.

Open the viewer Report a problem