# 2carrotlord/tamagadzi architecture

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

- Interactive diagram: https://gitdiagram.com/2carrotlord/tamagadzi
- Repository: https://github.com/2carrotlord/tamagadzi

## Overview

This is a Pygame virtual-pet game with a minigame menu and separate memory and tic-tac-toe games. The main loop handles pet interaction and needs (feeding, watering, cleaning, and play); its minigame button opens the menu. The menu displays a memory-game option, but the excerpt does not show option dispatch, so no menu-to-game call is asserted. The game modules appear to run independently. Evidence is limited to the README being empty and the sampled source excerpts.

Main entry points: [`VERZE_1_2.py`](https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py) (Pet Game Loop), [`piskvorky/piskvorky.py`](https://github.com/2carrotlord/tamagadzi/blob/main/piskvorky/piskvorky.py) (Tic-Tac-Toe), [`minigame_menu.py`](https://github.com/2carrotlord/tamagadzi/blob/main/minigame_menu.py) (Menu Screen), [`pexeso/main.py`](https://github.com/2carrotlord/tamagadzi/blob/main/pexeso/main.py) (Pexeso Game)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pet["Virtual Pet"]
  node_pet_app["Pet Game Loop<br/>[VERZE_1_2.py]"]
  node_pet_state["Pet Needs<br/>[VERZE_1_2.py]"]
  node_pet_actions["Pet Actions<br/>[VERZE_1_2.py]"]
  node_pet_view["Pet Display<br/>[VERZE_1_2.py]"]
  node_pet_sprite["Pet Animation<br/>[VERZE_1_2.py]"]
  node_minigame_button["Minigame Button<br/>[VERZE_1_2.py]"]
end

subgraph group_menu["Minigame Menu"]
  node_menu_entry["Menu Loader<br/>[VERZE_1_2.py]"]
  node_menu_screen["Menu Screen<br/>[minigame_menu.py]"]
end

subgraph group_memory["Memory Game"]
  node_memory_game["Pexeso Game<br/>[main.py]"]
  node_memory_assets["Card Spritesheet"]
end

subgraph group_tic["Tic-Tac-Toe"]
  node_tic_game["Tic-Tac-Toe<br/>[piskvorky.py]"]
  node_tic_bot["Random Bot<br/>[piskvorky.py]"]
  node_tic_assets["X/O Images"]
end

node_player(("Player"))

node_player -->|"interacts with"| node_pet_app
node_pet_app -->|"updates needs"| node_pet_state
node_pet_app -->|"handles actions"| node_pet_actions
node_pet_app -->|"renders"| node_pet_view
node_pet_app -->|"updates sprites"| node_pet_sprite
node_pet_app -->|"processes"| node_minigame_button
node_minigame_button -->|"calls stop"| node_menu_entry
node_menu_entry -->|"loads and calls"| node_menu_screen
node_menu_screen -->|"shows options"| node_player
node_player -->|"plays"| node_memory_game
node_memory_game -->|"loads spritesheet"| node_memory_assets
node_player -->|"plays"| node_tic_game
node_tic_game -->|"calls bot"| node_tic_bot
node_tic_game -->|"loads images"| node_tic_assets

click node_pet_app "https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py"
click node_pet_state "https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py"
click node_pet_actions "https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py"
click node_pet_view "https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py"
click node_pet_sprite "https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py"
click node_minigame_button "https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py"
click node_menu_entry "https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py"
click node_menu_screen "https://github.com/2carrotlord/tamagadzi/blob/main/minigame_menu.py"
click node_memory_game "https://github.com/2carrotlord/tamagadzi/blob/main/pexeso/main.py"
click node_memory_assets "https://github.com/2carrotlord/tamagadzi/tree/main/pexeso/resource"
click node_tic_game "https://github.com/2carrotlord/tamagadzi/blob/main/piskvorky/piskvorky.py"
click node_tic_bot "https://github.com/2carrotlord/tamagadzi/blob/main/piskvorky/piskvorky.py"
click node_tic_assets "https://github.com/2carrotlord/tamagadzi/tree/main/piskvorky/visual"

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_pet_app,node_pet_state,node_pet_actions,node_pet_view,node_pet_sprite,node_minigame_button toneBlue
class node_menu_entry,node_menu_screen toneAmber
class node_memory_game,node_memory_assets toneMint
class node_tic_game,node_tic_bot,node_tic_assets toneRose
class node_player toneIndigo
```

## Components

### Virtual Pet

- [Pet Game Loop](https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py): `VERZE_1_2.py`
- [Pet Needs](https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py): `VERZE_1_2.py`
- [Pet Actions](https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py): `VERZE_1_2.py`
- [Pet Display](https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py): `VERZE_1_2.py`
- [Pet Animation](https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py): `VERZE_1_2.py`
- [Minigame Button](https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py): `VERZE_1_2.py`

### Minigame Menu

- [Menu Loader](https://github.com/2carrotlord/tamagadzi/blob/main/VERZE_1_2.py): `VERZE_1_2.py`
- [Menu Screen](https://github.com/2carrotlord/tamagadzi/blob/main/minigame_menu.py): `minigame_menu.py`

### Memory Game

- [Pexeso Game](https://github.com/2carrotlord/tamagadzi/blob/main/pexeso/main.py): `pexeso/main.py`
- [Card Spritesheet](https://github.com/2carrotlord/tamagadzi/tree/main/pexeso/resource): `pexeso/resource`

### Tic-Tac-Toe

- [Tic-Tac-Toe](https://github.com/2carrotlord/tamagadzi/blob/main/piskvorky/piskvorky.py): `piskvorky/piskvorky.py`
- [Random Bot](https://github.com/2carrotlord/tamagadzi/blob/main/piskvorky/piskvorky.py): `piskvorky/piskvorky.py`
- [X/O Images](https://github.com/2carrotlord/tamagadzi/tree/main/piskvorky/visual): `piskvorky/visual`

### Other components

- **Player**

## Connections

- Player → Pet Game Loop: interacts with (evidence: `VERZE_1_2.py`)
- Pet Game Loop → Pet Needs: updates needs (evidence: `VERZE_1_2.py`)
- Pet Game Loop → Pet Actions: handles actions (evidence: `VERZE_1_2.py`)
- Pet Game Loop → Pet Display: renders (evidence: `VERZE_1_2.py`)
- Pet Game Loop → Pet Animation: updates sprites (evidence: `VERZE_1_2.py`)
- Pet Game Loop → Minigame Button: processes (evidence: `VERZE_1_2.py`)
- Minigame Button → Menu Loader: calls stop (evidence: `VERZE_1_2.py`)
- Menu Loader → Menu Screen: loads and calls (evidence: `VERZE_1_2.py`)
- Menu Screen → Player: shows options (evidence: `minigame_menu.py`)
- Player → Pexeso Game: plays (evidence: `pexeso/main.py`)
- Pexeso Game → Card Spritesheet: loads spritesheet (evidence: `pexeso/main.py`)
- Player → Tic-Tac-Toe: plays (evidence: `piskvorky/piskvorky.py`)
- Tic-Tac-Toe → Random Bot: calls bot (evidence: `piskvorky/piskvorky.py`)
- Tic-Tac-Toe → X/O Images: loads images (evidence: `piskvorky/piskvorky.py`)
