Skip to main content

The Schema Explorer

The Schema Explorer is an editor-time tool within the FactsDB Debugger designed to give you a clear and interactive view of your project's Fact Schema definitions. It is the central place to understand schema inheritance, discover all facts available within a schema, and trace any fact back to its source UDataTable asset.

Unlike the Hierarchy view, which shows live data from a PIE session, the Schema Explorer works with the static definitions configured in your project's FactsDB Runtime Settings.

Interface Overview

The Schema Explorer is composed of two main panels: the Schema Hierarchy on the left, and the Fact Definitions panel on the right.

The Schema Explorer interface

Schema Hierarchy

This tree view visualizes the inheritance relationships between all defined FFactSchemaTag entries in your project.

  • If a schema B is nested under schema A, it means that B inherits all the fact definitions from A.
  • Selecting a schema in this tree will populate the Fact Definitions panel on the right with all the facts that belong to it (both its own and inherited ones).
  • The Refresh button at the top will reload all schema data directly from your project's configuration assets.

The Schema Hierarchy tree showing parent-child relationships

Fact Definitions Panel

This panel displays a detailed list of every fact contained within the schema you selected on the left. It has two modes, controlled by the switcher at the top:

  • All Facts (Default): Shows a complete list of every fact available in the selected schema. This includes facts defined directly in this schema as well as all facts inherited from its parent schemas.
  • Declared Only: Filters the list to show only the facts that are explicitly defined or overridden in the DataTables associated with the currently selected schema. This is extremely useful for understanding what a specific schema adds or changes relative to its parent.

The list provides several columns of information:

  • Origin: An icon indicating where the fact comes from.
    • icon-plus | Declared: The fact is defined in this schema.
    • icon-link | Inherited: The fact is inherited from a parent. The tooltip will tell you exactly which parent schema it comes from.
  • Fact Tag: The unique FFactTag identifying the fact.
  • Type: The data type of the fact (e.g., FFactInteger, FVector).
  • Default Value: The default value as configured in the source UDataTable.
  • Description: The descriptive tooltip for the fact.
  • Go To: A button that directly opens the source UDataTable and highlights the exact row where the fact is defined.

The Fact Definitions panel showing a mix of declared and inherited facts

By using the Schema Explorer, you can easily answer critical questions like:

  • "Which schema provides the Facts.Character.Stats.Stamina fact?"
  • "What is the default health for all enemies that inherit from Schema.Enemy.Base?"
  • "Where exactly in the project is the Facts.Item.CanBeSold flag defined?"

Next Up: Diagnostic Panels