Struct EngineBuilder 

pub struct EngineBuilder { /* private fields */ }

Builder for constructing an Engine with plugins.

Example

use astrelis::{EngineBuilder, FnPlugin};

let engine = EngineBuilder::new()
    .add_plugin(FnPlugin::new("config", |resources| {
        resources.insert("game_title".to_string());
    }))
    .build();

Implementations

impl EngineBuilder

pub fn new() -> Self

Create a new engine builder.

pub fn add_plugin(self, plugin: impl Plugin + 'static) -> Self

Add a plugin to the engine.

Plugins are built in the order they are added, with dependency ordering handled automatically.

pub fn add_plugins(self, group: impl PluginGroup) -> Self

Add a plugin group (multiple plugins) to the engine.

pub fn insert_resource<R: Resource>(self, resource: R) -> Self

Insert a resource directly before building.

This is useful for resources that plugins might depend on but that aren’t provided by a plugin.

pub fn try_build(self) -> Result<Engine, EngineError>

Build the engine, initializing all plugins.

This will:

1. Sort plugins by dependencies
2. Call build() on each plugin
3. Call finish() on each plugin

Errors

Returns EngineError if:

• A circular dependency is detected between plugins
• A plugin dependency is not found
• A plugin with the same name is added twice

pub fn build(self) -> Engine

Build the engine, panicking on error.

This is a convenience method for examples and tests where error handling is not needed. For production code, prefer try_build() which returns a Result.

Panics

Panics if:

• A circular dependency is detected between plugins
• A plugin dependency is not found
• A plugin with the same name is added twice

Trait Implementations

impl Default for EngineBuilder

fn default() -> Self

Returns the “default value” for a type.