AAIController::UnclaimTaskResource

function AIModule Blueprint Since 4.7

#include "AIController.h"

Access: public Specifiers: UFUNCTIONBlueprintCallable

Description

Releases a gameplay task resource previously claimed at the controller level via ClaimTaskResource. After release, tasks are again free to acquire that resource.

Caveats & Gotchas

• Calling UnclaimTaskResource for a resource that was never claimed has no effect and does not assert, but it indicates a logic error in call-site pairing.
• If a UGameplayTask was blocked waiting for this resource, it will not automatically resume — the task scheduler re-evaluates priority the next time it ticks.

Signature

void UnclaimTaskResource(TSubclassOf<UGameplayTaskResource> ResourceClass)

Parameters

Name	Type	Description	Default
ResourceClass	TSubclassOf<UGameplayTaskResource>	The resource class to release.	—

Return Type

void

Example

Release movement resource after a scripted sequence C++

void AMyAIController::OnCinematicEnded()
{
	UnclaimTaskResource(UGameplayTaskResource_Move::StaticClass());
	// BT movement tasks can now resume
}

Version History

Introduced in: 4.7

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?