# sudolucas/cardwars architecture

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

- Interactive diagram: https://gitdiagram.com/sudolucas/cardwars
- Repository: https://github.com/sudolucas/cardwars

## Overview

Card Wars is a Pygame single-player card-battle game. The player chooses a difficulty, starts a match, selects a live card for each duel, advances rounds until HP reaches zero, then can replay or return to the menu. The graph follows the observed scene transitions and combat calls; the README is empty, and unsampled source limits evidence for some rendering and card-model details.

Main entry points: [`card_wars/escenas/juego.py`](https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/juego.py) (Match screen), [`card_wars/escenas/menu.py`](https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/menu.py) (Main menu), [`card_wars/vista/render.py`](https://github.com/sudolucas/cardwars/blob/main/card_wars/vista/render.py) (Game renderer), [`card_wars/main.py`](https://github.com/sudolucas/cardwars/blob/main/card_wars/main.py) (App loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and scenes"]
  node_app_loop["App loop<br/>[main.py]"]
  node_scene_base["Scene base<br/>[base.py]"]
  node_menu["Main menu<br/>[menu.py]"]
  node_difficulty["Difficulty screen<br/>[dificultad.py]"]
  node_game_scene["Match screen<br/>[juego.py]"]
  node_end_scene["Result screen<br/>[fin.py]"]
end

subgraph group_battle["Battle domain"]
  node_config["Game configuration<br/>[config.py]"]
  node_game["Match rules<br/>[juego.py]"]
  node_ai["AI strategies<br/>[ia.py]"]
  node_deck["Deck management<br/>[mazo.py]"]
  node_card["Card state<br/>[carta.py]"]
end

subgraph group_presentation["Presentation"]
  node_renderer["Game renderer<br/>[render.py]"]
  node_colors["Color palette<br/>[colores.py]"]
  node_fonts["Font loader<br/>[fuentes.py]"]
end

node_player(("Player"))

node_player -->|"sends input"| node_app_loop
node_app_loop -->|"starts at"| node_menu
node_app_loop -->|"creates"| node_renderer
node_app_loop -->|"loads"| node_fonts
node_app_loop -->|"dispatches events"| node_scene_base
node_menu -.->|"inherits"| node_scene_base
node_difficulty -->|"inherits"| node_scene_base
node_game_scene -->|"inherits"| node_scene_base
node_end_scene -->|"inherits"| node_scene_base
node_menu -->|"opens"| node_difficulty
node_menu -->|"starts match"| node_game_scene
node_difficulty -->|"returns to"| node_menu
node_game_scene -->|"plays rounds"| node_game
node_game_scene -->|"shows result"| node_end_scene
node_end_scene -->|"replays via"| node_game_scene
node_end_scene -->|"returns to"| node_menu
node_game_scene -->|"selects difficulty"| node_config
node_game -->|"uses turn states"| node_config
node_game -->|"requests choice"| node_ai
node_game -->|"creates and updates"| node_deck
node_ai -->|"chooses from"| node_deck
node_deck -->|"creates cards"| node_card
node_game_scene -->|"draws match"| node_renderer
node_renderer -->|"uses palette"| node_colors
node_menu -->|"draws controls"| node_renderer
node_difficulty -->|"draws controls"| node_renderer
node_end_scene -->|"draws result"| node_renderer

click node_app_loop "https://github.com/sudolucas/cardwars/blob/main/card_wars/main.py"
click node_scene_base "https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/base.py"
click node_menu "https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/menu.py"
click node_difficulty "https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/dificultad.py"
click node_game_scene "https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/juego.py"
click node_end_scene "https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/fin.py"
click node_config "https://github.com/sudolucas/cardwars/blob/main/card_wars/config.py"
click node_game "https://github.com/sudolucas/cardwars/blob/main/card_wars/modelo/juego.py"
click node_ai "https://github.com/sudolucas/cardwars/blob/main/card_wars/modelo/ia.py"
click node_deck "https://github.com/sudolucas/cardwars/blob/main/card_wars/modelo/mazo.py"
click node_card "https://github.com/sudolucas/cardwars/blob/main/card_wars/modelo/carta.py"
click node_renderer "https://github.com/sudolucas/cardwars/blob/main/card_wars/vista/render.py"
click node_colors "https://github.com/sudolucas/cardwars/blob/main/card_wars/vista/colores.py"
click node_fonts "https://github.com/sudolucas/cardwars/blob/main/card_wars/vista/fuentes.py"

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_app_loop,node_scene_base,node_menu,node_difficulty,node_game_scene,node_end_scene toneBlue
class node_config,node_game,node_ai,node_deck,node_card toneAmber
class node_renderer,node_colors,node_fonts toneMint
class node_player toneIndigo
```

## Components

### App and scenes

- [App loop](https://github.com/sudolucas/cardwars/blob/main/card_wars/main.py): `card_wars/main.py`
- [Scene base](https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/base.py): `card_wars/escenas/base.py`
- [Main menu](https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/menu.py): `card_wars/escenas/menu.py`
- [Difficulty screen](https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/dificultad.py): `card_wars/escenas/dificultad.py`
- [Match screen](https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/juego.py): `card_wars/escenas/juego.py`
- [Result screen](https://github.com/sudolucas/cardwars/blob/main/card_wars/escenas/fin.py): `card_wars/escenas/fin.py`

### Battle domain

- [Game configuration](https://github.com/sudolucas/cardwars/blob/main/card_wars/config.py): `card_wars/config.py`
- [Match rules](https://github.com/sudolucas/cardwars/blob/main/card_wars/modelo/juego.py): `card_wars/modelo/juego.py`
- [AI strategies](https://github.com/sudolucas/cardwars/blob/main/card_wars/modelo/ia.py): `card_wars/modelo/ia.py`
- [Deck management](https://github.com/sudolucas/cardwars/blob/main/card_wars/modelo/mazo.py): `card_wars/modelo/mazo.py`
- [Card state](https://github.com/sudolucas/cardwars/blob/main/card_wars/modelo/carta.py): `card_wars/modelo/carta.py`

### Presentation

- [Game renderer](https://github.com/sudolucas/cardwars/blob/main/card_wars/vista/render.py): `card_wars/vista/render.py`
- [Color palette](https://github.com/sudolucas/cardwars/blob/main/card_wars/vista/colores.py): `card_wars/vista/colores.py`
- [Font loader](https://github.com/sudolucas/cardwars/blob/main/card_wars/vista/fuentes.py): `card_wars/vista/fuentes.py`

### Other components

- **Player**

## Connections

- Player → App loop: sends input (evidence: `card_wars/main.py`)
- App loop → Main menu: starts at (evidence: `card_wars/main.py`)
- App loop → Game renderer: creates (evidence: `card_wars/main.py`)
- App loop → Font loader: loads (evidence: `card_wars/main.py`)
- App loop → Scene base: dispatches events (evidence: `card_wars/main.py`)
- Main menu → Scene base: inherits (evidence: `card_wars/escenas/menu.py`)
- Difficulty screen → Scene base: inherits (evidence: `card_wars/escenas/dificultad.py`)
- Match screen → Scene base: inherits (evidence: `card_wars/escenas/juego.py`)
- Result screen → Scene base: inherits (evidence: `card_wars/escenas/fin.py`)
- Main menu → Difficulty screen: opens (evidence: `card_wars/escenas/menu.py`)
- Main menu → Match screen: starts match (evidence: `card_wars/escenas/menu.py`)
- Difficulty screen → Main menu: returns to (evidence: `card_wars/escenas/dificultad.py`)
- Match screen → Match rules: plays rounds (evidence: `card_wars/escenas/juego.py`)
- Match screen → Result screen: shows result (evidence: `card_wars/escenas/juego.py`)
- Result screen → Match screen: replays via (evidence: `card_wars/escenas/fin.py`)
- Result screen → Main menu: returns to (evidence: `card_wars/escenas/fin.py`)
- Match screen → Game configuration: selects difficulty (evidence: `card_wars/escenas/juego.py`)
- Match rules → Game configuration: uses turn states (evidence: `card_wars/modelo/juego.py`)
- Match rules → AI strategies: requests choice (evidence: `card_wars/modelo/juego.py`)
- Match rules → Deck management: creates and updates (evidence: `card_wars/modelo/juego.py`)
- AI strategies → Deck management: chooses from (evidence: `card_wars/modelo/ia.py`)
- Deck management → Card state: creates cards (evidence: `card_wars/modelo/mazo.py`)
- Match screen → Game renderer: draws match (evidence: `card_wars/escenas/juego.py`)
- Game renderer → Color palette: uses palette (evidence: `card_wars/vista/render.py`)
- Main menu → Game renderer: draws controls (evidence: `card_wars/escenas/menu.py`)
- Difficulty screen → Game renderer: draws controls (evidence: `card_wars/escenas/dificultad.py`)
- Result screen → Game renderer: draws result (evidence: `card_wars/escenas/fin.py`)
