Struct BehaviorLoader 

pub struct BehaviorLoader { /* private fields */ }

Loader for creating behavior trees from JSON configuration.

The BehaviorLoader takes a BehaviorConfig (which can be loaded from JSON) and uses a NodeRegistry to instantiate the complete behavior tree.

Features

• Recursive composition parsing (sequence/selector/parallel nodes)
• Config reference resolution from the config map
• Inline config support
• Clear error messages for missing node types

Example

use mecha10_behavior_runtime::prelude::*;
use mecha10_behavior_runtime::{NodeRegistry, BehaviorLoader};
use serde_json::json;


// Create and populate registry
let mut registry = NodeRegistry::new();
registry.register("my_behavior", |_| Ok(Box::new(MyBehavior)));

// Load behavior tree from JSON
let json = r#"{
    "name": "test_behavior",
    "root": {
        "type": "sequence",
        "children": [
            {
                "type": "node",
                "node": "my_behavior"
            }
        ]
    }
}"#;

let config = BehaviorConfig::from_json(json).unwrap();
let loader = BehaviorLoader::new(registry);
let behavior = loader.load(&config).unwrap();

Implementations

impl BehaviorLoader

pub fn new(registry: NodeRegistry) -> Self

Create a new behavior loader with the given node registry.

Arguments

• registry - The node registry containing registered node types

Example

use mecha10_behavior_runtime::{NodeRegistry, BehaviorLoader};

let registry = NodeRegistry::new();
let loader = BehaviorLoader::new(registry);

pub fn load(&self, config: &BehaviorConfig) -> Result<BoxedBehavior>

Load a behavior tree from a configuration.

This is the main entry point for loading behavior trees. It takes a BehaviorConfig (typically loaded from JSON) and recursively instantiates all nodes in the tree.

Arguments

• config - The behavior configuration to load

Returns

A boxed behavior node representing the root of the tree, or an error if:

• A referenced node type is not registered
• A config reference is invalid
• A factory function fails

Example

use mecha10_behavior_runtime::{BehaviorConfig, NodeRegistry, BehaviorLoader};

let loader = BehaviorLoader::new(registry);

let json = r#"{
    "name": "test",
    "root": {
        "type": "node",
        "node": "test"
    }
}"#;

let config = BehaviorConfig::from_json(json).unwrap();
let behavior = loader.load(&config).unwrap();

pub fn load_from_json(&self, json: &str) -> Result<BoxedBehavior>

Load a behavior tree from a JSON string.

This is a convenience method that combines parsing and loading.

Arguments

• json - JSON string containing a BehaviorConfig

Example

use mecha10_behavior_runtime::{NodeRegistry, BehaviorLoader};

let loader = BehaviorLoader::new(registry);

let json = r#"{
    "name": "test",
    "root": {
        "type": "node",
        "node": "test"
    }
}"#;

let behavior = loader.load_from_json(json).unwrap();

pub fn load_from_file(&self, path: impl AsRef<Path>) -> Result<BoxedBehavior>

Load a behavior tree from a JSON file.

This is a convenience method that reads a file and loads the behavior tree.

Arguments

• path - Path to the JSON file

Example

use mecha10_behavior_runtime::{NodeRegistry, BehaviorLoader};

let loader = BehaviorLoader::new(registry);
let behavior = loader.load_from_file("behaviors/patrol.json").unwrap();

pub fn registry(&self) -> &NodeRegistry

Get a reference to the underlying node registry.

This can be useful for inspecting registered types or adding new types after the loader has been created.

Trait Implementations

impl Clone for BehaviorLoader

fn clone(&self) -> BehaviorLoader

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BehaviorLoader

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

Formats the value using the given formatter.