Task_ChangeState.h File Reference

Atomic task that changes the AI state stored in the LocalBlackboard. More...

#include "../../IAtomicTask.h"

Include dependency graph for Task_ChangeState.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	Olympe::Task_ChangeState
	Writes a new AI state name to "local:current_state" in the LocalBlackboard. More...

Namespaces
namespace	Olympe
	< Provides AssetID and INVALID_ASSET_ID

Detailed Description

Atomic task that changes the AI state stored in the LocalBlackboard.

Author

Olympe Engine

Date

2026-03-08

Task_ChangeState writes a new state string to the "local:CurrentState" key in the entity's LocalBlackboard. It is the standard way for VS graphs to transition between logical AI states (e.g. "Patrolling" -> "Alert" -> "Guard").

Parameters (ParameterMap): "NewState" (String) — target state name (required).

Returns: Success after writing the new state. Failure if "NewState" is missing, or if ctx.LocalBB is null.

C++14 compliant - no C++17/20 features.

Definition in file Task_ChangeState.h.