# martinbrombach/buffed architecture

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

- Interactive diagram: https://gitdiagram.com/martinbrombach/buffed
- Repository: https://github.com/martinbrombach/buffed

## Overview

This is a small, terminal-based RPG prototype. The principal workflow is choosing a new or existing character, entering the tavern, and selecting activities; new characters are written to text saves, while continuing reads a selected save and displays character stats. Combat, training, settings, and saving from the tavern are placeholders rather than implemented gameplay. The only source file is main.py; the saves directory contains character files. Relationships below are limited to behavior visible in its excerpt.

Main entry points: [`main.py`](https://github.com/martinbrombach/buffed/blob/main/main.py) (Tavern menu), [`saves`](https://github.com/martinbrombach/buffed/tree/main/saves) (Character saves)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Startup and menus"]
  node_controls["Keyboard input<br/>[main.py]"]
  node_selector["Choice selector<br/>[main.py]"]
  node_startup["Startup menu<br/>[main.py]"]
end

subgraph group_characters["Character setup"]
  node_new_character["New character<br/>[main.py]"]
  node_save_list["Save selection<br/>[main.py]"]
  node_save_loader["Save loader<br/>[main.py]"]
  node_save_files[("Character saves")]
end

subgraph group_tavern["Tavern activities"]
  node_tavern_loop["Tavern menu<br/>[main.py]"]
  node_combat_menu["Fight menu<br/>[main.py]"]
  node_training["Training placeholder<br/>[main.py]"]
  node_settings["Settings placeholder<br/>[main.py]"]
  node_save_option["Save placeholder<br/>[main.py]"]
end

node_player(("Player"))

node_player -->|"chooses start"| node_startup
node_player -->|"presses keys"| node_controls
node_startup -->|"offers choices"| node_selector
node_selector -->|"returns choice"| node_startup
node_startup -->|"starts new"| node_new_character
node_startup -->|"continues"| node_save_list
node_new_character -->|"creates save"| node_save_files
node_save_list -->|"lists saves"| node_save_files
node_save_list -->|"loads selection"| node_save_loader
node_save_loader -->|"reads save"| node_save_files
node_save_list -->|"enters game"| node_tavern_loop
node_new_character -->|"enters game"| node_tavern_loop
node_tavern_loop -->|"offers activities"| node_selector
node_tavern_loop -->|"opens fight"| node_combat_menu
node_tavern_loop -->|"selects training"| node_training
node_tavern_loop -->|"selects settings"| node_settings
node_tavern_loop -->|"selects save"| node_save_option
node_combat_menu -->|"offers choices"| node_selector

click node_controls "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_selector "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_startup "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_new_character "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_save_list "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_save_loader "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_save_files "https://github.com/martinbrombach/buffed/tree/main/saves"
click node_tavern_loop "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_combat_menu "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_training "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_settings "https://github.com/martinbrombach/buffed/blob/main/main.py"
click node_save_option "https://github.com/martinbrombach/buffed/blob/main/main.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_controls,node_selector,node_startup toneBlue
class node_new_character,node_save_list,node_save_loader,node_save_files toneAmber
class node_tavern_loop,node_combat_menu,node_training,node_settings,node_save_option toneMint
class node_player toneIndigo
```

## Components

### Startup and menus

- [Keyboard input](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Choice selector](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Startup menu](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`

### Character setup

- [New character](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Save selection](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Save loader](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Character saves](https://github.com/martinbrombach/buffed/tree/main/saves): `saves`

### Tavern activities

- [Tavern menu](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Fight menu](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Training placeholder](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Settings placeholder](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`
- [Save placeholder](https://github.com/martinbrombach/buffed/blob/main/main.py): `main.py`

### Other components

- **Player**

## Connections

- Player → Startup menu: chooses start (evidence: `main.py`)
- Player → Keyboard input: presses keys (evidence: `main.py`)
- Startup menu → Choice selector: offers choices (evidence: `main.py`)
- Choice selector → Startup menu: returns choice (evidence: `main.py`)
- Startup menu → New character: starts new (evidence: `main.py`)
- Startup menu → Save selection: continues (evidence: `main.py`)
- New character → Character saves: creates save (evidence: `main.py`)
- Save selection → Character saves: lists saves (evidence: `main.py`)
- Save selection → Save loader: loads selection (evidence: `main.py`)
- Save loader → Character saves: reads save (evidence: `main.py`)
- Save selection → Tavern menu: enters game (evidence: `main.py`)
- New character → Tavern menu: enters game (evidence: `main.py`)
- Tavern menu → Choice selector: offers activities (evidence: `main.py`)
- Tavern menu → Fight menu: opens fight (evidence: `main.py`)
- Tavern menu → Training placeholder: selects training (evidence: `main.py`)
- Tavern menu → Settings placeholder: selects settings (evidence: `main.py`)
- Tavern menu → Save placeholder: selects save (evidence: `main.py`)
- Fight menu → Choice selector: offers choices (evidence: `main.py`)
