System

A System is an object assigned to app lifecycle and used to do some work such as dispatching events or manipulating entities. Systems can be ordered with order properties

Systems are the backbone of Ceramic's architecture, providing a way to organize game logic into modular, reusable components that integrate with the application lifecycle.

Key features:

• Two-phase update cycle (earlyUpdate and lateUpdate)
• Automatic ordering via earlyUpdateOrder and lateUpdateOrder
• Named systems for easy retrieval
• Automatic registration with app.systems
• Events for update lifecycle hooks

To create a system:

1. Extend the System class
2. Override earlyUpdate() and/or lateUpdate() methods
3. Set appropriate update orders
4. The system auto-registers on creation

Example usage:

class PhysicsSystem extends System {
    public function new() {
        super();
        name = "physics";
        earlyUpdateOrder = 100;
    }

    override function earlyUpdate(delta:Float) {
        // Update physics simulation
    }
}

// Create the system (auto-registers)
var physics = new PhysicsSystem();

// Later, retrieve it by name
var physics = app.systems.get("physics");

Instance Members #

System name. Useful to retrieve a system afterwards

When set to true (default). This system will be updated automatically. If false, you'll need to call earlyUpdate() and lateUpdate() manually.

Order of earlyUpdate execution. Given two systems, a system with a lower earlyUpdateOrder value will have it's earlyUpdate() method called before another system's earlyUpdate() method with a higher order value.

Order of lateUpdate execution. Given two systems, a system with a lower lateUpdateOrder value will have it's lateUpdate() method called before another system's lateUpdate() method with a higher order value.

Private Members #

beginEarlyUpdate event

endEarlyUpdate event

beginLateUpdate event

endLateUpdate event

Method automatically called right before app's update event. Override this method to implement system logic that needs to run before regular entity updates.

Method automatically called right after app's update event. Override this method to implement system logic that needs to run after regular entity updates.

Metadata #