Skip to content

Library View

The Library panel is the left side of the GOAP Hub. It's where you browse, create, and manage all the GOAP assets that make up a Brain.

Overview

The Library is organized into two scopes:

  • Brain Scope — Assets that belong to the entire brain (keys, sensors, states, transitions).
  • State Scope — Assets scoped to the currently selected behavioral state (actions, goals, beliefs).

Switch between states using the state tabs at the top of the Planner Graph.

Brain Scope

These sections appear regardless of which state is selected:

Brain Header

At the top of the Library, you'll see the Brain asset name and the Default State label showing which state the agent starts in.

Keys

Lists all blackboard key definitions in the Brain. Each key shows its name and type (Bool, Float, Vector3, Integer, Object, String).

  • Add keys via the context menu or the "+" button.
  • Keys are referenced by sensors, strategies, and beliefs through the Slot/Key manifest system.

Sensors

Lists all sensors attached to the Brain. Each entry shows the sensor type and its configured update interval.

  • Add sensors by dragging a sensor SO into the list or using the context menu.
  • Click a sensor to view and edit its output mappings in the Inspector panel.

States

Lists all behavioral states. You can:

  • Reorder states by dragging them in the list.
  • Create new states via the context menu.
  • Set the default state by right-clicking a state.
  • Click a state to switch the Planner Graph to that state's view.

Transitions

Lists all FSM transitions between states. Each transition shows its source state, target state, and the belief condition that triggers it.

  • Create transitions via the context menu.
  • Click a transition to edit its condition and target value in the Inspector.

State Scope

These sections change based on the currently selected state tab:

Actions

Lists all actions available in the current state. Each action shows its name, cost, and strategy type.

  • Create actions via the context menu.
  • Click an action to edit its strategy, settings, preconditions, effects, cost, and post-processes in the Inspector.
  • Actions appear as nodes in the Planner Graph.

Goals

Lists all goals the planner can pursue in the current state. Each goal shows its name, priority, and desired state conditions.

  • Create goals via the context menu.
  • Click a goal to edit its priority, desired state, validity conditions, score modifiers, and optional state transition.

Beliefs

Lists all beliefs used by actions and goals in the current state. Each belief shows its type and a brief description.

  • Create beliefs via the context menu.
  • Beliefs are referenced as preconditions, effects, desired state conditions, and transition triggers.

Search and Filter

The Library panel includes a search bar at the top. Type to filter assets across all sections by name. This is useful in larger brains with many actions and beliefs.

Context Menus

Right-click on any section header or asset to access context menus for:

  • Creating new assets of that type
  • Deleting selected assets
  • Duplicating assets
  • Renaming assets

What's Next