Struct BehaviorExecutor 

pub struct BehaviorExecutor { /* private fields */ }

Executor for behavior trees with tick-based execution.

This provides a simple interface for running behavior trees at a fixed rate.

Example

use mecha10_behavior_runtime::prelude::*;

let mut executor = BehaviorExecutor::new(behavior, 30.0);

let (status, stats) = executor.run_until_complete(&ctx).await?;
println!("Behavior completed with status: {} in {} ticks", status, stats.tick_count);

Implementations

impl BehaviorExecutor

pub fn new( behavior: Box<dyn BehaviorNode>, tick_rate_hz: f32, ) -> BehaviorExecutor

Create a new behavior executor.

Arguments

• behavior - The behavior to execute
• tick_rate_hz - Tick rate in Hz (e.g., 30.0 for 30 Hz)

pub fn with_max_ticks(self, max_ticks: usize) -> BehaviorExecutor

Set the maximum number of ticks before timeout.

pub async fn init(&mut self, ctx: &Context) -> Result<(), Error>

Initialize the behavior.

pub async fn run_until_complete( &mut self, ctx: &Context, ) -> Result<(NodeStatus, ExecutionStats), Error>

Run the behavior until it completes (Success or Failure).

This will tick the behavior at the configured rate until it returns a terminal status (Success or Failure).

Returns

The final status and execution statistics.

pub async fn run_for_duration( &mut self, ctx: &Context, duration: Duration, ) -> Result<(NodeStatus, ExecutionStats), Error>

Run the behavior for a fixed duration.

This will tick the behavior at the configured rate for the specified duration, regardless of whether it completes.

pub async fn terminate(&mut self, ctx: &Context) -> Result<(), Error>

Terminate the behavior.

pub async fn reset(&mut self) -> Result<(), Error>

Reset the behavior to its initial state.