Struct ScriptHost 

pub struct ScriptHost { /* private fields */ }

Loaded native script factories. Instances created by this host keep the library loaded even if the host is dropped, so their callback vtables remain valid.

Implementations

impl ScriptHost

pub fn from_defs(defs: Vec<ScriptDef>) -> Result<Self, String>

Creates a host for permanently linked Rust scripts, useful for embedding and headless tests. Rejects empty or duplicate script names. Factories must belong to permanent host code, not an unloadable library.

use kvas_engine::script::{Script, ScriptDef, ScriptHost};
#[derive(Default)] struct Behaviour;
impl Script for Behaviour {}
let host = ScriptHost::from_defs(vec![ScriptDef::of::<Behaviour>("Behaviour")]).unwrap();
assert!(host.create("Behaviour").is_some());

pub fn load(path: &Path) -> Result<ScriptHost, String>

Loads a library. It is copied first so the original stays writable for the next build.

pub fn names(&self) -> Vec<&str>

Exported type names borrowed for the host lifetime (not falsely 'static). Use Self::names_owned to retain names across hot reload or host drop.

pub fn names_owned(&self) -> Vec<String>

Copies exported names so they can be retained after the library is unloaded.

pub fn callbacks(&self, name: &str) -> (bool, bool)

Whether a script has update / fixed_update (unknown names: both true).

pub fn create(&self, name: &str) -> Option<Box<dyn Script>>

Constructs a script by exact type name and retains the library for its lifetime. Returns None for unknown names. User factory panics propagate to the caller; ScriptRuntime::sync catches them when constructing gameplay instances.