GameEngine

Central facade that wires the ECS (entities, components, systems) with rendering and audio. The concrete API lives in src/engine/include/engine/GameEngine.hpp and delegates to RenderManager for window/input and AudioManager for sound.

Responsibilities

• ECS orchestration: owns EntityManager and SystemManager, registers component types, wires system signatures, and runs updateSystems(dt).
• Rendering and input: proxies calls to RenderManager (processInput(), isActionActive(), beginFrame(), render(), textures, scale factor, window state).
• Audio: proxies to AudioManager for SFX/UI/music playback and listener/volume controls.
• Network alignment: exposes createEntityWithId() and removeComponentByType() to mirror server-authored IDs and component state when receiving packets.

Lifecycle

1. init() sets up EntityManager and SystemManager and links them.
2. Client-side boot: initRender() opens the window and preloads assets; initAudio() loads audio resources.
3. Systems bootstrap: register systems, set signatures, then call onCreateSystems().
4. Frame loop (typical client):
5. processInput()
6. beginFrame()
7. updateSystems(dt)
8. optional audio upkeep (updateAudio())
9. render()
10. Shutdown: call onDestroySystems() then let RAII clean up managers.

Key APIs

• Entities: createEntity(name), createEntityWithId(id, name), destroyEntity(id), isAlive(entity), getEntityName(entity).
• Components: registerComponent<T>(), addComponent<T>(entity, data), emplaceComponent<T>(entity, args...), updateComponent<T>(entity, data), removeComponent<T>(entity), removeComponentByType(type, entity), getComponents<T>(), getComponentEntity<T>(entity), hasComponent<T>(entity).
• Systems: registerSystem<S>(), getSystem<S>(), removeSystem<S>(), setSystemSignature<S, Components...>(), updateSystems(dt), onCreateSystems(), onDestroySystems().
• Input/Render: processInput(), isActionActive(action), isActionJustPressed(action), getMapAction(), getMousePosition(), getWindow(), getTexture(assetId), getScaleFactor(), beginFrame(), render(), isWindowOpen().
• Audio: playSound(effect, x, y, volume, pitch), playSoundUI(effect, volume, pitch), playMusic(path, volume), stopMusic(), updateAudio(), setMasterVolume(), setSoundVolume(), setMusicVolume(), getAudioManager().

Usage Skeleton (client side)

gameEngine::GameEngine engine;
engine.init();
engine.initRender();
engine.initAudio();

// register components and systems, set signatures, then:
engine.onCreateSystems();

while (engine.isWindowOpen()) {
    engine.processInput();
    engine.beginFrame();
    engine.updateSystems(dt);
    engine.updateAudio();
    engine.render();
}

engine.onDestroySystems();