Struct BehaviorConfig 

pub struct BehaviorConfig {
    pub schema: Option<String>,
    pub name: String,
    pub description: Option<String>,
    pub root: CompositionConfig,
    pub configs: HashMap<String, Value>,
}

Root configuration for a behavior composition.

This is the top-level structure for defining behavior trees in JSON.

Example JSON

{
  "$schema": "https://mecha10.dev/schemas/behavior-composition-v1.json",
  "name": "patrol_mission",
  "description": "Patrol behavior with safety layer",
  "root": {
    "type": "sequence",
    "children": [
      {
        "type": "node",
        "node": "safety_check",
        "config_ref": "safety"
      },
      {
        "type": "selector",
        "children": [
          {
            "type": "node",
            "node": "detect_obstacles",
            "config_ref": "detector"
          },
          {
            "type": "node",
            "node": "wander",
            "config_ref": "wander"
          }
        ]
      }
    ]
  },
  "configs": {
    "safety": { "max_speed": 1.0 },
    "detector": { "confidence": 0.7 },
    "wander": { "speed": 0.5 }
  }
}

Fields

schema: Option<String>

Schema reference for validation and IntelliSense

name: String

Name of this behavior composition

description: Option<String>

Optional description

root: CompositionConfig

Root composition node

configs: HashMap<String, Value>

Configuration values referenced by nodes

Implementations

impl BehaviorConfig

pub fn from_json(json: &str) -> Result<BehaviorConfig, Error>

Load a behavior configuration from a JSON string.

Example

use mecha10_behavior_runtime::BehaviorConfig;

let json = r#"{
    "name": "test_behavior",
    "root": {
        "type": "sequence",
        "children": []
    }
}"#;

let config = BehaviorConfig::from_json(json).unwrap();
assert_eq!(config.name, "test_behavior");

pub fn from_file(path: impl AsRef<Path>) -> Result<BehaviorConfig, Error>

Load a behavior configuration from a JSON file.

pub fn to_json(&self) -> Result<String, Error>

Convert this configuration to JSON.

pub fn generate_schema() -> Result<String, Error>

Generate a JSON schema for this configuration type.

This can be used for editor IntelliSense and validation.

pub fn get_config(&self, key: &str) -> Option<&Value>

Get a configuration value by reference key.

Trait Implementations

impl Clone for BehaviorConfig

fn clone(&self) -> BehaviorConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BehaviorConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BehaviorConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<BehaviorConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for BehaviorConfig

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl Serialize for BehaviorConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.