Docs

Script Utility Modules

Docs Index

Purpose

Utility modules are normal Rust modules used by behavior scripts for shared code, types, helpers, traits, and gameplay logic.

Script Utility Modules explains behavior, constraints, and practical usage so implementation decisions stay consistent across scripts and scenes.

API Source

Functions

lifecycle!methods!

Enums

// not documented yet for this module

Constants

res/**/*.rs synced into .perro/scripts

Types

ScriptContextVariant

Usage Pattern

use crate::combat::damage::DamageEvent; lifecycle!({    fn on_update(&self, ctx) {        let event = DamageEvent { amount: 10 };    }});

Key Details

Keep non-entrypoint code in reusable modules.

Import helpers from synced script files with normal Rust paths.

Use deps.toml for external crates.

Behavior entry macros stay in scripts referenced by scenes.