How jritchie02/ecs-game-engine works
• Engine Core: At the center is the Application (see Application.cpp and Application.hpp) that ties together every subsystem.
• Subsystems / Systems: Include core modules like RenderingSystem, PhysicsSystem, InputSystem, ResourceManager, ImGuiLayer, SDLLayer, and possibly game-specific modules such as Board, Scene/SceneView, Spritesheet, and Components.
• External Libraries: Show integrations with SDL (used for rendering and window handling), ImGUI (for editor UI), Box2D (for physics simulation – this is included as a third-party submodule), and pybind (for binding C++ code to Python).
• Assets: Represent the asset management side (art files, level files, fonts, etc.) that the engine loads via ResourceManager.
• Editor & Level Scripts: In the “bin” folder you have several Python scripts (level1.py, level2.py, level3.py, levelBuilder.py, sim.py) that use the built shared object (blockbyte.so) to run levels or operate the level editor.
• Documentation & Build Tools: Although not core to runtime, indicate that documentation (generated by Doxygen in the “docs” folder) and Makefile support the build/deployment process.
Relationships and interactions
• SDLLayer to the RenderingSystem and InputSystem, indicating that lower-level SDL operations are abstracted by these higher-level systems.
• Link ImGuiLayer as a UI overlay that interacts with the core engine (for displaying editor windows and panels) and also receives input via InputSystem.
• That ResourceManager loads assets (images, fonts, level data) from the “assets” directory.
Architectural patterns and design principles
• Entity–Component–System (ECS) approach – showing that many engine components (as evidenced by Components.hpp) are designed for modularity.
• Decoupling between rendering, physics, and input, which is achieved via a modular design where each subsystem is responsible for a distinct task.
• That the engine is extensible through the editor (ImGui-based panels) and scriptable (via Python binding), which are typical patterns in modern game engines.