# moh0009/eid-aladha-game architecture

> Architecture diagram of the GitHub repository moh0009/eid-aladha-game, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/moh0009/eid-aladha-game
- Repository: https://github.com/moh0009/eid-aladha-game

## Overview

This is a small Godot game project. The likely player journey is through the main menu into the world, through portal/quest scenes, and then to an end screen; filenames support these stages, but the README documents no mechanics and no source excerpts were available to verify scene wiring. The graph therefore shows only the apparent high-level flow and keeps quest content distinct. The asset folder is represented as a shared visual-resource layer rather than cataloguing individual sprites.

Main entry points: [`scenes/world.tscn`](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/world.tscn) (World), [`scenes/Main.gd`](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/Main.gd) (Game logic), [`scenes/qs/scripts/portel.gd`](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/scripts/portel.gd) (Portal behavior), [`scenes/playert.tscn`](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/playert.tscn) (Player character)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_flow["Game flow"]
  node_game_entry["Game entry<br/>[Main.tscn]"]
  node_game_logic["Game logic<br/>[Main.gd]"]
  node_world["World<br/>[world.tscn]"]
  node_player_scene["Player character<br/>[playert.tscn]"]
  node_character_logic["Character behavior<br/>[CharacterBody2D.gd]"]
end

subgraph group_quests["Quest content"]
  node_portal["Quest portal<br/>[portel.tscn]"]
  node_portal_logic["Portal behavior<br/>[portel.gd]"]
  node_quest_one["Quest one<br/>[qs_1.tscn]"]
  node_quest_one_logic["Quest one logic<br/>[qs_1.gd]"]
  node_quest_two["Quest two<br/>[qs_2.tscn]"]
  node_quest_three["Quest three<br/>[qs_3.tscn]"]
end

subgraph group_interface["User interface"]
  node_main_menu["Main menu<br/>[main.tscn]"]
  node_menu_logic["Menu logic<br/>[main.gd]"]
  node_hud["Game HUD<br/>[main_ui.tscn]"]
  node_hud_logic["HUD logic<br/>[main_ui.gd]"]
  node_ending["End screen<br/>[end.tscn]"]
  node_ending_logic["End-screen logic<br/>[end.gd]"]
end

subgraph group_visuals["Visual resources"]
  node_sprites["Character sprites"]
  node_tilemap_assets["Tilemap assets"]
  node_background_assets["Background assets"]
end

node_player(("Player"))

node_player -->|"starts at"| node_main_menu
node_main_menu -->|"uses"| node_menu_logic
node_menu_logic -->|"starts game"| node_game_entry
node_game_entry -->|"uses"| node_game_logic
node_game_logic -->|"loads"| node_world
node_world -->|"includes"| node_player_scene
node_player_scene -->|"uses"| node_character_logic
node_game_logic -->|"shows"| node_hud
node_hud -->|"uses"| node_hud_logic
node_world -->|"contains"| node_portal
node_portal -->|"uses"| node_portal_logic
node_portal_logic -->|"opens"| node_quest_one
node_portal_logic -->|"opens"| node_quest_two
node_portal_logic -->|"opens"| node_quest_three
node_game_logic -->|"shows"| node_ending
node_ending -->|"uses"| node_ending_logic
node_player_scene -.->|"uses"| node_sprites
node_world -.->|"uses"| node_tilemap_assets
node_world -.->|"uses"| node_background_assets

click node_main_menu "https://github.com/moh0009/eid-aladha-game/blob/main/ui/main.tscn"
click node_menu_logic "https://github.com/moh0009/eid-aladha-game/blob/main/ui/main.gd"
click node_game_entry "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/Main.tscn"
click node_game_logic "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/Main.gd"
click node_world "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/world.tscn"
click node_player_scene "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/playert.tscn"
click node_character_logic "https://github.com/moh0009/eid-aladha-game/blob/main/CharacterBody2D.gd"
click node_hud "https://github.com/moh0009/eid-aladha-game/blob/main/ui/main_ui.tscn"
click node_hud_logic "https://github.com/moh0009/eid-aladha-game/blob/main/ui/main_ui.gd"
click node_portal "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/portel.tscn"
click node_portal_logic "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/scripts/portel.gd"
click node_quest_one "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/qs_1.tscn"
click node_quest_one_logic "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/scripts/qs_1.gd"
click node_quest_two "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/qs_2.tscn"
click node_quest_three "https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/qs_3.tscn"
click node_ending "https://github.com/moh0009/eid-aladha-game/blob/main/ui/end.tscn"
click node_ending_logic "https://github.com/moh0009/eid-aladha-game/blob/main/ui/end.gd"
click node_sprites "https://github.com/moh0009/eid-aladha-game/tree/main/SPRITES"
click node_tilemap_assets "https://github.com/moh0009/eid-aladha-game/tree/main/Tilemap"
click node_background_assets "https://github.com/moh0009/eid-aladha-game/tree/main/kenney_background-elements-redux"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_game_entry,node_game_logic,node_world,node_player_scene,node_character_logic toneBlue
class node_portal,node_portal_logic,node_quest_one,node_quest_one_logic,node_quest_two,node_quest_three toneAmber
class node_main_menu,node_menu_logic,node_hud,node_hud_logic,node_ending,node_ending_logic toneMint
class node_sprites,node_tilemap_assets,node_background_assets toneRose
class node_player toneIndigo
```

## Components

### Game flow

- [Game entry](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/Main.tscn): `scenes/Main.tscn`
- [Game logic](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/Main.gd): `scenes/Main.gd`
- [World](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/world.tscn): `scenes/world.tscn`
- [Player character](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/playert.tscn): `scenes/playert.tscn`
- [Character behavior](https://github.com/moh0009/eid-aladha-game/blob/main/CharacterBody2D.gd): `CharacterBody2D.gd`

### Quest content

- [Quest portal](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/portel.tscn): `scenes/qs/portel.tscn`
- [Portal behavior](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/scripts/portel.gd): `scenes/qs/scripts/portel.gd`
- [Quest one](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/qs_1.tscn): `scenes/qs/qs_1.tscn`
- [Quest one logic](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/scripts/qs_1.gd): `scenes/qs/scripts/qs_1.gd`
- [Quest two](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/qs_2.tscn): `scenes/qs/qs_2.tscn`
- [Quest three](https://github.com/moh0009/eid-aladha-game/blob/main/scenes/qs/qs_3.tscn): `scenes/qs/qs_3.tscn`

### User interface

- [Main menu](https://github.com/moh0009/eid-aladha-game/blob/main/ui/main.tscn): `ui/main.tscn`
- [Menu logic](https://github.com/moh0009/eid-aladha-game/blob/main/ui/main.gd): `ui/main.gd`
- [Game HUD](https://github.com/moh0009/eid-aladha-game/blob/main/ui/main_ui.tscn): `ui/main_ui.tscn`
- [HUD logic](https://github.com/moh0009/eid-aladha-game/blob/main/ui/main_ui.gd): `ui/main_ui.gd`
- [End screen](https://github.com/moh0009/eid-aladha-game/blob/main/ui/end.tscn): `ui/end.tscn`
- [End-screen logic](https://github.com/moh0009/eid-aladha-game/blob/main/ui/end.gd): `ui/end.gd`

### Visual resources

- [Character sprites](https://github.com/moh0009/eid-aladha-game/tree/main/SPRITES): `SPRITES`
- [Tilemap assets](https://github.com/moh0009/eid-aladha-game/tree/main/Tilemap): `Tilemap`
- [Background assets](https://github.com/moh0009/eid-aladha-game/tree/main/kenney_background-elements-redux): `kenney_background-elements-redux`

### Other components

- **Player**

## Connections

- Player → Main menu: starts at
- Main menu → Menu logic: uses
- Menu logic → Game entry: starts game
- Game entry → Game logic: uses
- Game logic → World: loads
- World → Player character: includes
- Player character → Character behavior: uses
- Game logic → Game HUD: shows
- Game HUD → HUD logic: uses
- World → Quest portal: contains
- Quest portal → Portal behavior: uses
- Portal behavior → Quest one: opens
- Portal behavior → Quest two: opens
- Portal behavior → Quest three: opens
- Game logic → End screen: shows
- End screen → End-screen logic: uses
- Player character → Character sprites: uses
- World → Tilemap assets: uses
- World → Background assets: uses