BT BLACKBOARD LOGGING

Log any blackboard keys through service or task. Log messages only if value changes


🖼️ Node Overview

Node Type
Menu Path
Executes

Print String (Task)

Behavior Tree → Tasks → Print String

Once, when the task starts.

Print String (Service)

Behavior Tree → Services → Print String

Every tick (default 0.1 s).

Key capabilities:

  • Print any Blackboard key in screen, log, or 3D world.

  • Unique messages are logged only when they change (keeps logs clean for logs viewer and output logs).


⚙️ Configurable Fields

Property
Description

Caller Name

Optional prefix (e.g., [OnSeePlayer]).

Print BBKey

Blackboard key to display.

Text Color

Colour for on‑screen text.

Text Duration

How long on‑screen text stays visible.

Log Severity

Info, Warning, or Error.

Print to World

Enables DrawDebugString.

Text Location

Print above Actor or a custom Vector.

Interval

Interval of logging in service node


đź§  How Logs Work

  • Service node samples the key every tick; Task prints once executed.

  • The system logs only when the key’s value changes.

  • Destinations: project log files, LogsViewer, on‑screen, and/or in‑world.

⚠️ Values are skipped only in the logs but can still be rendered on‑screen for continuous visual feedback.


🔄 Example Use Cases

  • Visualise the TargetActor position in world space.

  • Highlight state transitions such as EnemyState: Alert → Combat.

  • Log once when ShouldAttack flips from false → true.


Last updated