Struct CutsceneManager 

pub struct CutsceneManager {
    pub active: bool,
    pub current_script: Option<String>,
    pub blocking: bool,
    pub queue: VecDeque<String>,
    pub started: bool,
}

Manages cutscene execution state.

A cutscene is a named JS async function that runs to completion, suspending normal player input while active. Cutscenes can be queued — when one finishes, the next one starts automatically.

Fields

active: bool

Whether a cutscene is currently executing.

current_script: Option<String>

The name of the currently running cutscene script (JS export name).

blocking: bool

When true, player directional/movement input is blocked. When false, the cutscene runs in parallel with player movement (useful for ambient NPC chatter or environmental effects).

queue: VecDeque<String>

Queue of pending cutscene script names. When the current cutscene finishes, the next one is started automatically.

started: bool

Internal: whether the current cutscene’s script function has been called (via ScriptEngine::call_function). Reset to false when a new cutscene starts or a queued one is promoted.

Implementations

impl CutsceneManager

pub fn new() -> Self

Creates a new cutscene manager with no active cutscene.

pub fn start_cutscene(&mut self, script_name: &str, blocking: bool)

Starts a cutscene with the given script name.

If a cutscene is already active, the new script is appended to the queue instead of interrupting the current one.

blocking: if true, player movement input is suspended.

pub fn is_active(&self) -> bool

Returns true if a cutscene is currently active.

pub fn is_blocking(&self) -> bool

Returns true if the cutscene blocks player movement input.

pub fn current_script_name(&self) -> Option<&str>

Returns the name of the currently running cutscene, if any.

pub fn end_cutscene(&mut self) -> Option<String>

Ends the current cutscene and starts the next queued one if any.

Returns Some(script_name) if a queued cutscene was started.

pub fn queue_script(&mut self, script_name: &str)

Adds a script to the end of the cutscene queue.

pub fn queue_len(&self) -> usize

Returns the number of scripts waiting in the queue.

pub fn has_queued(&self) -> bool

Returns true if there are scripts waiting in the queue.

pub fn clear_queue(&mut self)

Clears all queued scripts.

pub fn force_stop(&mut self)

Forcefully stops the current cutscene and clears the queue.

pub fn mark_started(&mut self)

pub fn needs_start(&self) -> bool

Trait Implementations

impl Clone for CutsceneManager

fn clone(&self) -> CutsceneManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CutsceneManager

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

Formats the value using the given formatter.

impl Default for CutsceneManager

fn default() -> Self

Returns the “default value” for a type.