CatalystEngineData-driven game progression

A modular, polymorphic and plug-and-play engine for TypeScript and PhaserJS. It computes the game math and notifies the outside world through a typed Event Bus.

Get started

Quick start

API reference

🧩

Total decoupling

The logic communicates only through the typed EngineEventBus. The UI (Phaser or otherwise) merely listens to events, never depending on the heart of the engine.

⚡

Lazy evaluation

Stats are recalculated only when a modifier changes, and only at the moment the value is actually requested. Built-in dirty flag.

🔖

Source-based management

Modifiers are added and removed based on their origin (e.g. fire_sword), not via abstract IDs that are hard to track.

🌳

Graph-based skill tree (DAG)

Every node declares level and unlock prerequisites, fully definable via JSON. It injects passive modifiers into the stats.

💾

Snapshot persistence

save() exports a minimal state (XP, levels, unlocked skills) as pure JSON, ideal for LocalStorage or a database. load() restores everything.

🎯

Genre-agnostic

A fantasy hero, a spaceship's engines or a strategic faction's parameters — the engine neither knows nor cares what your numbers represent.