Struct WeightedSelectNode 

pub struct WeightedSelectNode { /* private fields */ }

Like SelectOrNode (ticks children until one returns non-Failure), but instead of always trying children in a fixed index order, each tick-cycle picks the next untried child via a weighted-random draw among children not yet tried THIS resolution cycle. A weight of 0.0 (or negative) means that child is never picked. Once a child is chosen it is “sticky”: while it reports Running, the next tick() re-ticks that same child rather than re-rolling - only once it resolves does the node either return (on Success) or roll again among the remaining untried children (on Failure), mirroring SelectOrNode::current_index’s “resume where we left off” behavior, just with a random rather than fixed starting point each cycle.

Implementations

impl WeightedSelectNode

pub fn new(weighted_children: Vec<(f64, BoxedBehavior)>) -> Self

Create a new weighted selector from (weight, child) pairs, using a freshly OS-seeded RNG. Negative weights are clamped to 0.0 (never picked).

pub fn with_rng( weighted_children: Vec<(f64, BoxedBehavior)>, rng: StdRng, ) -> Self

Create a new weighted selector using the given RNG - the injection point tests use for deterministic behavior (e.g. StdRng::seed_from_u64(seed)).

pub fn len(&self) -> usize

Get the number of children.

pub fn is_empty(&self) -> bool

Check if the selector is empty.

Trait Implementations

impl BehaviorNode for WeightedSelectNode

fn tick<'life0, 'life1, 'async_trait>( &'life0 mut self, ctx: &'life1 Context, ) -> Pin<Box<dyn Future<Output = Result<NodeStatus>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Execute one tick of the behavior. Called repeatedly by the execution engine; should perform one unit of work, return quickly, and report progress via NodeStatus.

fn reset_self(&mut self)

Reset this node’s own local state, ignoring children.

fn name(&self) -> &str

Get the name of this behavior node.

fn children_mut(&mut self) -> Vec<&mut dyn BehaviorNode>

Return mutable references to this node’s child behaviors, in the order they should receive lifecycle events. Leaf nodes should not override this; composite nodes override it to expose their children.

fn active_capability(&self) -> Option<&str>

The capability this node implies should be published on /behavior/status while it’s actively being ticked; None for nodes with no such gate (the default). Composite nodes override this to forward whichever child is currently active.

fn status_snapshot(&self) -> TreeStatusSnapshot

Snapshot of what this node (and, for composite nodes, its subtree) reported on its last tick(), for live behavior-tree visualization. The default implementation reports status: None (as if never ticked) and no children - correct for a brand-new node type that hasn’t been wired up for status tracking yet, but every node type should override this once it stores a last_status field: leaf nodes return their own last_status, composite nodes additionally recurse into children_mut’s non-mut counterpart (there’s no shared non-mut child accessor, so each composite overrides this to walk its own child collection directly - same pattern as children_mut).

fn reset<'life0, 'async_trait>( &'life0 mut self, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Reset the behavior to its initial state.

fn on_init<'life0, 'life1, 'async_trait>( &'life0 mut self, ctx: &'life1 Context, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called when the behavior is first initialized.

fn on_terminate<'life0, 'life1, 'async_trait>( &'life0 mut self, ctx: &'life1 Context, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Called when the behavior is being terminated.

impl Debug for WeightedSelectNode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.