Settings

Count

Defines the number of NLAPhysicalLink to place along the spline. You can create as many links as needed; however, be mindful that each additional link slightly increases the computational load during pathfinding in Unreal Engine's Navigation System. For optimal performance, keep the number of links as low as possible—use only as many as your project requires.


Alignment

Specifies how NLAPhysicalLinkis positioned along the spline, with four options available:

  • Fill: Distributes the specified Count of links evenly across the entire spline. The first link will be placed at the spline's start, and the last at its end. If Count is set to 1, a single link will be centered on the spline. Distance is ignored in this mode.

  • Left: Positions links starting from the beginning of the spline, taking both Count and Distance parameters into account.

  • Center: Aligns links around the center of the spline, considering both Count and Distance values.

  • Right: Positions links starting from the end of the spline, with Count and Distance applied.


Distance

Sets the spacing between each NLAPhysicalLink along the spline. This parameter is used in conjunction with the Count and Alignment settings to control how links are distributed.


Debug Color

Specifies the color used for debugging purposes. Once NLAPhysicalLink are populated along the spline, each link’s position can be visualized as a small sphere in this color. To enable or disable this debug visualization within the navigation system, press "P" in the editor.


Left

Each NLAPhysicalLink includes two points, Left and Right, which correspond to specific positions on the spline. The Left parameter offsets the link's left point from its designated spline position, allowing for precise control over link placement.

Similar to the Left parameter, the Right parameter offsets the link's right point from its designated position on the spline, providing additional customization for link positioning.


Left Project Height

This setting helps position the left point of a NLAPhysicalLink on the ground by projecting a trace from its current location downwards. Left Project Height determines the trace length; if set to 0, the projection feature is disabled.

Right Project Height

Like Left Project Height, this setting projects a trace downward from the right point to help align it with the ground. Right Project Height sets the trace length, and a value of 0 disables the projection feature.


Snap Radius

Specifies the radius within which the Navigation System will search for a navigation mesh at both the left and right points of the link. This is a native Unreal Engine setting that enables precise navigation mesh snapping within the defined radius.


Direction

Determines the allowed movement directions across each NLAPhysicalLink, with three options available:

  • Left To Right: Movement is allowed only from the left point to the right point.

  • Right To Left: Movement is allowed only from the right point to the left point.

  • Both Ways: Movement is allowed in both directions.


Use Snap Height

Enables the use of the Snap Height setting below, allowing you to customize the height at which the Navigation System will attempt to snap each link point.


Snap Height

A native Unreal Engine setting that functions similarly to Left Project Height and Right Project Height. This parameter controls the height for mesh snapping, left here for backward compatibility with older navigation setups.


Supported Agents

Specifies which agents are allowed to use this NLAPhysicalLink. Agents are a native Unreal Engine feature that defines different types of characters or entities within the navigation system.


Area Class

Defines the area type for the NLAPhysicalLink. By default, it uses the value provided by FNavigationSystem::GetDefaultWalkableArea, which identifies standard walkable surfaces. You can specify a custom area class for specialized navigation behavior.


Sets the class used for the NLAPhysicalLink. By default, it uses the NLAPhysicalLink class, though you can specify a custom link class for advanced or customized functionality.

Last updated