RealDocs

AAIController::PauseMove

function AIModule Since 4.7
#include "AIController.h"
Access: public Specifiers: AIMODULE_API

Description

Temporarily halts the active path-following move without cancelling it, provided the active request ID matches RequestToPause. Returns true if the move was successfully paused.

Caveats & Gotchas

  • PauseMove only works if the currently active move request ID exactly matches RequestToPause. Passing a stale or mismatched ID silently fails and returns false.
  • The pawn's movement component is not stopped — only the path-following logic is paused. If you want the pawn to physically halt, also call GetPawn()->GetMovementComponent()->StopMovementImmediately().

Signature

bool PauseMove(FAIRequestID RequestToPause);

Parameters

Name Type Description Default
RequestToPause FAIRequestID The ID of the move request to pause. Only the currently active move matching this ID will be paused.

Return Type

bool

Example

Pause movement during an interaction C++
void AMyAIController::StartInteraction()
{
	SavedMoveID = GetCurrentMoveRequestID();
	if (PauseMove(SavedMoveID))
	{
		// AI is now paused at its current position
	}
}

Version History

Introduced in: 4.7

Version Status Notes
5.6 stable

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.