Exported properties

A pub field with a literal default is a property. The inspector shows it, and a scene sets it per node.

// scripts/turret.bs
pub class Turret {
    pub range: float = 12.0,
    pub burst: int = 3,
    pub armed: bool = true,
    pub label: str = "turret",
    pub target: Node,
    node: Node,
}

impl Turret {
    fn init() {
        log::info("{self.label} covers {self.range}");
    }
}

[[nodes]]
name = "Turret"

[nodes.script]
source = "scripts/turret.bs"

[nodes.script.props]
range = 20.0
target = "../Enemy"

• A default is an int, a float, a bool or a str literal, and its type is what the inspector draws.
• The object is made with its defaults, the scene's props go over them, and then init runs, so init reads tuned values.
• A scene stores only what differs from the default, so changing a default reaches every node that never overrode it.
• A prop naming no field is dropped, with a warning in the log.

Nodes as properties

A pub field of type Node takes a path, resolved from the scripted node once the whole scene exists. A path naming nothing gives no node, which is_valid() tells apart. A [Node] field takes a list of paths.

At run time

node.attach_script(path, props) does the same on a running node.

pub fn arm(node: Node) {
    node.attach_script("scripts/turret.bs", { "range": 5.0 });
}