# moise7000/pakbolombrik-c-game architecture

> Architecture diagram of the GitHub repository moise7000/pakbolombrik-c-game, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/moise7000/pakbolombrik-c-game
- Repository: https://github.com/moise7000/pakbolombrik-c-game

## Overview

##### Project Type and Purpose
- This is a native C-based 2D game (“Bâtô & Ver2Ter”) using SDL2 for graphics/audio/input and Jansson for JSON parsing.
- The goal is to run a game loop that loads scene definitions (JSON), instantiates entities/weapons, updates physics/collisions, renders frames, plays audio, and handles user input.

##### File Structure Analysis
- Top-level: build scripts (Makefile, Dockerfile, CI config), asset export scripts (assets_to_code.sh), raw Aseprite art directory.
- bin/: compiled executable (“game”) + JSON scene outputs and dialogs.
- src/: all C sources, subdivided into:
- engine/ (core subsystems: assets, collisions, physics, framerate, game loop, HUD, dialogs, scenes)
- scenes/ (one folder per level, each with .c/.h logic + .json data)
- entities/ (per-entity logic modules)
- weapons/ (per-weapon logic modules)
- assets/ (fonts, structured assets for build)
- main.c (initializes SDL2, Jansson, enters game loop)

##### README Insights
- Dependencies: SDL2 family, libjansson.
- Describes the expected directory layout, the role of each folder.

a. Main Components
- Core Engine / Game Loop
- Input Manager (SDL2 events)
- Asset Loader (images, fonts, audio, JSON)
- Scene Manager (loads JSON, orchestrates level logic)
- Entity Manager (creates/destroys entities)
- Weapon Manager (similar to entities)
- Physics & Collision Subsystem
- Renderer / Graphics Subsystem (SDL2 + textures)
- Audio Subsystem (SDL2_mixer)
- HUD Subsystem (texts, health bars)
- Data Layer (scene JSON, dialogs JSON)
- External Libraries (SDL2, SDL2_image, SDL2_ttf, SDL2_mixer, Jansson)
- Tools & Assets (Aseprite files → asset pipeline scripts)

b. Relationships & Data Flow
1. main.c initializes subsystems (Asset Loader, SDL2, JSON parser)
2. Game Loop tick:
- Input Manager → updates global input state
- Entity/Weapon Managers → update all instances’ logic
- Physics/Collision → compute movements, detect collisions
- Audio → play SFX/music based on events
3. Asset Loader serves textures, audio, JSON to all subsystems on demand.

c. Architectural Patterns
- Modular C design with clear separation of concerns
- Data-driven levels & dialogs via JSON → decouples content from code
- Engine-as-service: each subsystem exposes C API via include/*.h
- Per-module folders facilitate compile-time modularity

d. Key Technologies & Libraries
- SDL2 suite for cross-platform media
- Jansson for JSON parsing
- Custom data structures (hashtable, linked list, binary heap) in engine/structures
- Aseprite → asset pipeline scripts convert to in-code or engine-readable formats

## Diagram (Mermaid)

```mermaid
graph TD
  RawAssets["Raw Assets (Aseprite)"]:::data
  click RawAssets "https://github.com/moise7000/pakbolombrik-c-game/tree/a-star/aseprite/"
  Pipeline["Asset Pipeline Scripts"]:::ext
  click Pipeline "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/assets_to_code.sh"
  RawAssets --> Pipeline
  Pipeline --> AssetLoader

  DataLayer["Data Layer (JSON scenes & dialogs)"]:::data
  click DataLayer "https://github.com/moise7000/pakbolombrik-c-game/tree/a-star/src/scenes/"
  DataLayer --> AssetLoader

  subgraph "External Libraries"
    style External Libraries fill:#FFE0B2,stroke:#000
    SDL2["SDL2 Family"]:::ext
    Jansson["Jansson (JSON)"]:::ext
  end

  AssetLoader["Asset Loader"]:::engine
  click AssetLoader "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/assets.c"
  click AssetLoader "https://github.com/moise7000/pakbolombrik-c-game/tree/a-star/src/assets/"
  AssetLoader --> Renderer
  AssetLoader --> Audio
  AssetLoader --> SceneManager
  AssetLoader --> Dialogs

  Main["Main.c (Init & Game Loop)"]:::engine
  click Main "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/main.c"
  Main --> AssetLoader
  Main --> SDL2
  Main --> Jansson
  Main --> GameCore

  subgraph "Engine Core"
    style Engine Core fill:#E0F7FA,stroke:#000
    GameCore["Game Loop Orchestrator"]:::engine
    Input["Input Manager"]:::engine
    click Input "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/include/assets.h"
    SceneManager["Scene Manager"]:::engine
    click SceneManager "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/scenes.c"
    click SceneManager "https://github.com/moise7000/pakbolombrik-c-game/tree/a-star/src/scenes/"
    EntityManager["Entity Manager"]:::engine
    click EntityManager "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/entity.c"
    click EntityManager "https://github.com/moise7000/pakbolombrik-c-game/tree/a-star/src/entities/"
    WeaponManager["Weapon Manager"]:::engine
    click WeaponManager "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/weapon.c"
    click WeaponManager "https://github.com/moise7000/pakbolombrik-c-game/tree/a-star/src/weapons/"
    Physics["Physics Subsystem"]:::engine
    click Physics "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/physics.c"
    Collision["Collision Subsystem"]:::engine
    click Collision "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/collisions.c"
    Renderer["Renderer Subsystem"]:::engine
    HUD["HUD Subsystem"]:::engine
    click HUD "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/hud.c"
    Audio["Audio Subsystem"]:::engine
    click Audio "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/include/audio.h"
    Dialogs["Dialogs Subsystem"]:::engine
    click Dialogs "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/dialogs.c"
    Framerate["Framerate & Timing"]:::engine
    click Framerate "https://github.com/moise7000/pakbolombrik-c-game/blob/a-star/src/engine/framerate.c"
    Structures["Data Structures"]:::engine
    click Structures "https://github.com/moise7000/pakbolombrik-c-game/tree/a-star/src/engine/structures/"
  end

  GameCore --> Input
  GameCore --> SceneManager
  SceneManager --> EntityManager
  SceneManager --> WeaponManager
  GameCore --> Physics
  Physics --> Collision
  Collision --> EntityManager
  GameCore --> Renderer
  GameCore --> HUD
  GameCore --> Audio
  GameCore --> Dialogs
  GameCore --> Framerate

  classDef engine fill:#E0F7FA,stroke:#000,stroke-width:1px
  classDef data fill:#E8F5E9,stroke:#000,stroke-width:1px
  classDef ext fill:#FFE0B2,stroke:#000,stroke-width:1px
```
