Skip to content

GOAP Hub Overview

The GOAP Hub is the all-in-one visual editor for designing, wiring, and debugging your agent AI. Everything you need is in one window.

Opening the GOAP Hub

There are two ways to open it:

  1. From the Inspector — Select a GameObject with a GoapAgent component and click the Open GOAP Suite button.
  2. From the menu — Go to Tools > RGS GOAP > Welcome & Setup.

The GOAP Hub opens as a dockable editor window.

Two Modes

The GOAP Hub operates in two modes that switch automatically:

Design Mode (Edit Time)

Active when Unity is not in Play mode. This is where you build your agent's AI:

  • Create and configure actions, goals, beliefs, sensors, and keys
  • Wire preconditions and effects
  • Set up state transitions
  • Map Slots to Keys in the Key Manifest
  • Run validation checks

Debug Mode (Play Mode)

Activates automatically when you enter Play mode. Shows live runtime data:

  • The active plan with step-by-step progress highlighting
  • Live cost and priority values on action and goal nodes
  • Auto-switches tabs when the agent changes behavioral state
  • Current blackboard values

Panel Layout

The GOAP Hub is divided into several panels:

Panel Position Purpose
Library Left side Browse and manage all GOAP assets in the brain. Drag states, create new assets, search and filter.
Planner Graph Top center Node-based view of actions within the current state. Shows preconditions, effects, and costs at a glance.
Neural Circuit Bottom center Brain-level view showing all behavioral states and the transitions between them.
Inspector Right side Context-sensitive property editor. Select any node to view and edit its settings with live editing.
Plan Row Top (Debug mode) Live plan execution tracking with step highlighting showing which action is currently running.

Toolbar

The toolbar at the top of the GOAP Hub provides quick access to common operations:

Button What It Does
Refresh Reload all assets from disk. Use after making changes outside the GOAP Hub.
Validate Run consistency checks on the entire brain. Catches unwired slots, missing beliefs, broken transitions, and more.
Lock Pin the current selection so it doesn't change when you click in the scene.
Bake Compile the brain. Resolves all references and prepares the brain for runtime.
State Lock (Debug mode only) Freeze the displayed state tab so it doesn't auto-switch when the agent changes state.

Tip

Get in the habit of clicking Validate before entering Play mode. It catches most configuration errors instantly.

State Tabs

Along the top of the Planner Graph, you'll see tabs for each behavioral state in the brain. Click a tab to view that state's actions, goals, and beliefs. In Debug mode, the active tab auto-switches to follow the agent's current state (unless State Lock is enabled).

Additional Windows

Beyond the main GOAP Hub, two additional windows are available:

  • Welcome & Setup (Tools > RGS GOAP > Welcome & Setup) — A guided first-run setup window with quick-start steps for new users.
  • Console (Tools > RGS GOAP > Console) — A GOAP-specific log viewer that filters for framework messages, separate from Unity's main Console.

What's Next