Objective Waypoint System (C++)

Objective Waypoint System (C++) adds UWaypointComponent — an actor component that queries the navigation mesh and visualizes the shortest path to an actor, scene component, or world location. Choose Spawn mode (instanced meshes or pooled AWaypointActor) or Spline mode (spline mesh segments).

Plugin content (meshes/materials) ships under ObjectiveWaypointSystem/. The Blueprint asset package is documented separately: Objective Waypoint System (Blueprints).

Architecture

flowchart TB
  subgraph pawn [Player pawn]
    WC[UWaypointComponent]
    Spline[USplineComponent optional]
  end
  subgraph nav [Navigation]
    NavSys[Navigation System]
    Pool[UWaypointWorldSubsystem actor pool]
  end
  subgraph visuals [Path visuals]
    HISM[Instanced static meshes]
    WA[AWaypointActor]
    SM[SplineMeshComponents]
  end
  WC --> NavSys
  WC --> Pool
  WC -->|Spawn Instanced| HISM
  WC -->|Spawn Actor| WA
  WC -->|Spline| SM
  Spline --> WC

Pathfinding flow

sequenceDiagram
  participant Game as Your game logic
  participant WC as UWaypointComponent
  participant Nav as NavigationSystem
  participant Vis as Visuals
  Game->>WC: FindPathToActor / Location / Component
  WC->>Nav: Project path
  alt NavigationMode Spawn
    alt SpawnTypeMethod Instanced
      WC->>Vis: Internal_CreateInstancedMeshes
    else SpawnTypeMethod Actor
      WC->>Vis: Internal_SpawnWaypointActors
    end
  else NavigationMode Spline
    WC->>Vis: Internal_PathFindingSpline
  end
  WC->>Game: K2_OnFinishPathFinding

What is included

Type	Class	Purpose
Component	`UWaypointComponent`	Path query + visualization
Actor	`AWaypointActor`	Spawn-mode marker (subclassable)
Pawn	`AWaypointPawn`	Example pawn with component
Character	`AWaypointCharacter`	Example character with component
Subsystem	`UWaypointWorldSubsystem`	Actor pooling for spawn mode
Content	`SM_Waypoint_Arrow`, materials	Default arrow mesh

Guides

Page	Description
Getting started	Enable plugin, add component, first path call
Overview	Actor path, spawn vs spline, Blueprint parity
C++ reference	Properties, enums, events, classes