# quagza/devmaycry architecture

> Architecture diagram of the GitHub repository quagza/devmaycry, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/quagza/devmaycry
- Repository: https://github.com/quagza/devmaycry

## Overview

Echo Clash is a Godot first-person team shooter with LAN play and offline bots. The documented match centers on attackers carrying the Core from the defenders’ base and returning it before its timer expires; teams use rewind or localized time acceleration, while Relic Rush provides a free-for-all alternative. The graph preserves the gameplay, map, interface, and shared-service areas visible in the tree. Runtime call wiring was not sampled, so inferred connections are dashed and marked without evidence paths.

Main entry points: [`src/match/Match.gd`](https://github.com/quagza/devmaycry/blob/main/src/match/Match.gd) (Match Flow), [`src/player/Player.gd`](https://github.com/quagza/devmaycry/blob/main/src/player/Player.gd) (Player), [`src/weapons/Weapons.gd`](https://github.com/quagza/devmaycry/blob/main/src/weapons/Weapons.gd) (Weapons), [`src/echo/Echo.gd`](https://github.com/quagza/devmaycry/blob/main/src/echo/Echo.gd) (Echo Powers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Match Gameplay"]
  node_player["Player<br/>[Player.gd]"]
  node_bots["Bot AI<br/>[BotBrain.gd]"]
  node_weapons["Weapons<br/>[Weapons.gd]"]
  node_projectiles["Projectiles"]
  node_echo["Echo Powers<br/>[Echo.gd]"]
  node_match["Match Flow<br/>[Match.gd]"]
  node_objectives["Core Objectives<br/>[Objectives.gd]"]
  node_server["Match Server<br/>[MatchServer.gd]"]
end

subgraph group_world["Arena and Rules"]
  node_rules["Game Modes<br/>[CorebreakMode.gd]"]
  node_echo_buffer["Echo History<br/>[EchoBuffer.gd]"]
  node_maps["Arena Selection<br/>[Maps.gd]"]
  node_map_defs["Arena Definitions<br/>[MapDef.gd]"]
  node_map_plans["Generated Plans"]
end

subgraph group_interface["Player Interface"]
  node_hud["HUD<br/>[HUD.gd]"]
  node_armory["Armory<br/>[Armory.gd]"]
  node_title["Title Screen<br/>[Title.gd]"]
end

subgraph group_services["Game Services"]
  node_game_service["Game State<br/>[Game.gd]"]
  node_network["LAN Networking<br/>[Net.gd]"]
  node_audio["Audio Services<br/>[Sfx.gd]"]
  node_music["Music<br/>[Music.gd]"]
  node_settings["Settings<br/>[Settings.gd]"]
end

node_gamer(("Player"))
node_lan_peers(("LAN Peers"))

node_gamer -.->|"starts game"| node_title
node_title -.->|"starts match"| node_match
node_match -.->|"selects arena"| node_maps
node_maps -.->|"loads definition"| node_map_defs
node_map_defs -.->|"may use plan"| node_map_plans
node_match -.->|"runs mode"| node_rules
node_match -.->|"runs objectives"| node_objectives
node_gamer -.->|"controls"| node_player
node_bots -.->|"acts as"| node_player
node_player -.->|"fires"| node_weapons
node_weapons -.->|"launches"| node_projectiles
node_player -.->|"uses time power"| node_echo
node_echo -.->|"uses history"| node_echo_buffer
node_player -.->|"carries Core"| node_objectives
node_gamer -.->|"chooses weapons"| node_armory
node_match -.->|"presents match"| node_hud
node_lan_peers -.->|"joins LAN"| node_network
node_network -.->|"supports match"| node_server
node_match -.->|"uses state"| node_game_service
node_player -.->|"triggers effects"| node_audio
node_match -.->|"plays soundtrack"| node_music
node_gamer -.->|"configures"| node_settings

click node_player "https://github.com/quagza/devmaycry/blob/main/src/player/Player.gd"
click node_bots "https://github.com/quagza/devmaycry/blob/main/src/player/BotBrain.gd"
click node_weapons "https://github.com/quagza/devmaycry/blob/main/src/weapons/Weapons.gd"
click node_projectiles "https://github.com/quagza/devmaycry/blob/main/src/weapons/ProjectileManager.gd"
click node_echo "https://github.com/quagza/devmaycry/blob/main/src/echo/Echo.gd"
click node_match "https://github.com/quagza/devmaycry/blob/main/src/match/Match.gd"
click node_objectives "https://github.com/quagza/devmaycry/blob/main/src/match/Objectives.gd"
click node_server "https://github.com/quagza/devmaycry/blob/main/src/match/MatchServer.gd"
click node_rules "https://github.com/quagza/devmaycry/blob/main/src/rules/CorebreakMode.gd"
click node_echo_buffer "https://github.com/quagza/devmaycry/blob/main/src/rules/EchoBuffer.gd"
click node_maps "https://github.com/quagza/devmaycry/blob/main/src/maps/Maps.gd"
click node_map_defs "https://github.com/quagza/devmaycry/blob/main/src/maps/MapDef.gd"
click node_map_plans "https://github.com/quagza/devmaycry/tree/main/src/maps/plans"
click node_hud "https://github.com/quagza/devmaycry/blob/main/src/ui/HUD.gd"
click node_armory "https://github.com/quagza/devmaycry/blob/main/src/ui/Armory.gd"
click node_title "https://github.com/quagza/devmaycry/blob/main/src/ui/Title.gd"
click node_game_service "https://github.com/quagza/devmaycry/blob/main/src/autoload/Game.gd"
click node_network "https://github.com/quagza/devmaycry/blob/main/src/autoload/Net.gd"
click node_audio "https://github.com/quagza/devmaycry/blob/main/src/autoload/Sfx.gd"
click node_music "https://github.com/quagza/devmaycry/blob/main/src/autoload/Music.gd"
click node_settings "https://github.com/quagza/devmaycry/blob/main/src/autoload/Settings.gd"

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_player,node_bots,node_weapons,node_projectiles,node_echo,node_match,node_objectives,node_server toneBlue
class node_rules,node_echo_buffer,node_maps,node_map_defs,node_map_plans toneAmber
class node_hud,node_armory,node_title toneMint
class node_game_service,node_network,node_audio,node_music,node_settings toneRose
class node_gamer,node_lan_peers toneIndigo
```

## Components

### Match Gameplay

- [Player](https://github.com/quagza/devmaycry/blob/main/src/player/Player.gd): `src/player/Player.gd`
- [Bot AI](https://github.com/quagza/devmaycry/blob/main/src/player/BotBrain.gd): `src/player/BotBrain.gd`
- [Weapons](https://github.com/quagza/devmaycry/blob/main/src/weapons/Weapons.gd): `src/weapons/Weapons.gd`
- [Projectiles](https://github.com/quagza/devmaycry/blob/main/src/weapons/ProjectileManager.gd): `src/weapons/ProjectileManager.gd`
- [Echo Powers](https://github.com/quagza/devmaycry/blob/main/src/echo/Echo.gd): `src/echo/Echo.gd`
- [Match Flow](https://github.com/quagza/devmaycry/blob/main/src/match/Match.gd): `src/match/Match.gd`
- [Core Objectives](https://github.com/quagza/devmaycry/blob/main/src/match/Objectives.gd): `src/match/Objectives.gd`
- [Match Server](https://github.com/quagza/devmaycry/blob/main/src/match/MatchServer.gd): `src/match/MatchServer.gd`

### Arena and Rules

- [Game Modes](https://github.com/quagza/devmaycry/blob/main/src/rules/CorebreakMode.gd): `src/rules/CorebreakMode.gd`
- [Echo History](https://github.com/quagza/devmaycry/blob/main/src/rules/EchoBuffer.gd): `src/rules/EchoBuffer.gd`
- [Arena Selection](https://github.com/quagza/devmaycry/blob/main/src/maps/Maps.gd): `src/maps/Maps.gd`
- [Arena Definitions](https://github.com/quagza/devmaycry/blob/main/src/maps/MapDef.gd): `src/maps/MapDef.gd`
- [Generated Plans](https://github.com/quagza/devmaycry/tree/main/src/maps/plans): `src/maps/plans`

### Player Interface

- [HUD](https://github.com/quagza/devmaycry/blob/main/src/ui/HUD.gd): `src/ui/HUD.gd`
- [Armory](https://github.com/quagza/devmaycry/blob/main/src/ui/Armory.gd): `src/ui/Armory.gd`
- [Title Screen](https://github.com/quagza/devmaycry/blob/main/src/ui/Title.gd): `src/ui/Title.gd`

### Game Services

- [Game State](https://github.com/quagza/devmaycry/blob/main/src/autoload/Game.gd): `src/autoload/Game.gd`
- [LAN Networking](https://github.com/quagza/devmaycry/blob/main/src/autoload/Net.gd): `src/autoload/Net.gd`
- [Audio Services](https://github.com/quagza/devmaycry/blob/main/src/autoload/Sfx.gd): `src/autoload/Sfx.gd`
- [Music](https://github.com/quagza/devmaycry/blob/main/src/autoload/Music.gd): `src/autoload/Music.gd`
- [Settings](https://github.com/quagza/devmaycry/blob/main/src/autoload/Settings.gd): `src/autoload/Settings.gd`

### Other components

- **Player**
- **LAN Peers**

## Connections

- Player → Title Screen: starts game
- Title Screen → Match Flow: starts match
- Match Flow → Arena Selection: selects arena
- Arena Selection → Arena Definitions: loads definition
- Arena Definitions → Generated Plans: may use plan
- Match Flow → Game Modes: runs mode
- Match Flow → Core Objectives: runs objectives
- Player → Player: controls
- Bot AI → Player: acts as
- Player → Weapons: fires
- Weapons → Projectiles: launches
- Player → Echo Powers: uses time power
- Echo Powers → Echo History: uses history
- Player → Core Objectives: carries Core
- Player → Armory: chooses weapons
- Match Flow → HUD: presents match
- LAN Peers → LAN Networking: joins LAN
- LAN Networking → Match Server: supports match
- Match Flow → Game State: uses state
- Player → Audio Services: triggers effects
- Match Flow → Music: plays soundtrack
- Player → Settings: configures
