# jeancarlosmartins/text-based-game-rpg-ufabc-arbo architecture

> Architecture diagram of the GitHub repository jeancarlosmartins/text-based-game-rpg-ufabc-arbo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo
- Repository: https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo

## Overview

UFABC ARBO is a terminal RPG about exploring the UFABC Santo André campus, finding items, and progressing through campus activities. The player enters through a menu, starts a session, and uses the game loop to move, explore, and use items; game state can be saved, loaded, or reset. The README also describes inventory, access restrictions, and missions, with missions and advanced item interactions still in development. The single-file implementation excerpt is partial, so edges for documented but unsampled mechanics rely on the README.

Main entry points: [`PROJ_JOGO_ADVENTURE_UFABC.py`](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py) (Action loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Game flow"]
  node_menu["Terminal menu"]
  node_session["Game session"]
  node_game_loop["Action loop"]
end

subgraph group_world["Campus mechanics"]
  node_campus["Campus graph"]
  node_navigation["Environment navigation"]
  node_exploration["Item discovery"]
  node_item_use["Item interactions"]
  node_missions["Missions"]
end

subgraph group_state["Items and state"]
  node_inventory["Inventory"]
  node_game_state["Game state"]
end

subgraph group_persistence["Save management"]
  node_save_load["Save and load"]
  node_json_saves[("JSON save files")]
end

node_player(("Player"))

node_player -->|"chooses options"| node_menu
node_menu -->|"starts game"| node_session
node_session -->|"enters loop"| node_game_loop
node_game_loop -.->|"moves"| node_navigation
node_game_loop -.->|"explores"| node_exploration
node_game_loop -->|"uses items"| node_item_use
node_navigation -->|"follows connections"| node_campus
node_exploration -.->|"collects items"| node_inventory
node_item_use -.->|"checks items"| node_inventory
node_item_use -.->|"updates state"| node_game_state
node_game_loop -->|"saves or loads"| node_save_load
node_menu -->|"offers reset"| node_save_load
node_save_load -->|"reads and writes"| node_json_saves
node_game_loop -.->|"tracks progress"| node_missions

click node_menu "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_session "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_game_loop "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_campus "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_navigation "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_exploration "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_item_use "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_missions "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_inventory "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_game_state "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_save_load "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py"
click node_json_saves "https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.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_menu,node_session,node_game_loop toneBlue
class node_campus,node_navigation,node_exploration,node_item_use,node_missions toneAmber
class node_inventory,node_game_state toneMint
class node_save_load,node_json_saves toneRose
class node_player toneIndigo
```

## Components

### Game flow

- [Terminal menu](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`
- [Game session](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`
- [Action loop](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`

### Campus mechanics

- [Campus graph](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`
- [Environment navigation](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`
- [Item discovery](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`
- [Item interactions](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`
- [Missions](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`

### Items and state

- [Inventory](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`
- [Game state](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`

### Save management

- [Save and load](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`
- [JSON save files](https://github.com/jeancarlosmartins/text-based-game-rpg-ufabc-arbo/blob/main/PROJ_JOGO_ADVENTURE_UFABC.py): `PROJ_JOGO_ADVENTURE_UFABC.py`

### Other components

- **Player**

## Connections

- Player → Terminal menu: chooses options (evidence: `README.md`)
- Terminal menu → Game session: starts game (evidence: `PROJ_JOGO_ADVENTURE_UFABC.py`)
- Game session → Action loop: enters loop (evidence: `PROJ_JOGO_ADVENTURE_UFABC.py`)
- Action loop → Environment navigation: moves (evidence: `README.md`)
- Action loop → Item discovery: explores (evidence: `README.md`)
- Action loop → Item interactions: uses items (evidence: `PROJ_JOGO_ADVENTURE_UFABC.py`)
- Environment navigation → Campus graph: follows connections (evidence: `README.md`)
- Item discovery → Inventory: collects items (evidence: `README.md`)
- Item interactions → Inventory: checks items (evidence: `README.md`)
- Item interactions → Game state: updates state (evidence: `PROJ_JOGO_ADVENTURE_UFABC.py`)
- Action loop → Save and load: saves or loads (evidence: `README.md`)
- Terminal menu → Save and load: offers reset (evidence: `PROJ_JOGO_ADVENTURE_UFABC.py`)
- Save and load → JSON save files: reads and writes (evidence: `PROJ_JOGO_ADVENTURE_UFABC.py`)
- Action loop → Missions: tracks progress (evidence: `README.md`)
