# raincor5/hell-has-a-rota architecture

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

- Interactive diagram: https://gitdiagram.com/raincor5/hell-has-a-rota
- Repository: https://github.com/raincor5/hell-has-a-rota

## Overview

HHAR is a console role-playing game prototype. The visible player workflow starts at the console entry point, gathers character-creation choices, builds a player with stats, progression, inventory, and equipment, then supports item use and combat. Character stats and modifiers, leveling, class/gift setup, and item types are distinct domain capabilities. The source excerpts show several calls directly; other links use the SOURCE INDEX references. No README content was provided, and unsampled modules are represented only where their paths are in the tree.

Main entry points: [`hhar/characters/stats/CharacterStats.cs`](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/CharacterStats.cs) (Character stats), [`hhar/characters/CharacterCreation.cs`](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/CharacterCreation.cs) (Character creation), [`hhar/characters/Player.cs`](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/Player.cs) (Player character), [`hhar/items/IItem.cs`](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/IItem.cs) (Item contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_character["Character setup"]
  node_creation["Character creation"]
  node_class["Class assignment<br/>[AssignClass.cs]"]
  node_classes["Class choices<br/>[ClassList.cs]"]
  node_gift["Gift assignment<br/>[AssignGift.cs]"]
  node_gifts["Gift choices<br/>[GiftList.cs]"]
end

subgraph group_core["Character systems"]
  node_player["Player character<br/>[Player.cs]"]
  node_inventory["Player inventory<br/>[PlayerInventory.cs]"]
  node_invslot["Inventory slot<br/>[InventorySlot.cs]"]
  node_equip["Player equipment<br/>[PlayerEqupment.cs]"]
  node_equipslot["Equipment slot<br/>[EquipmentSlot.cs]"]
  node_slots["Equipment positions<br/>[EquipmentSlots.cs]"]
end

subgraph group_items["Items and actions"]
  node_item["Item contract<br/>[IItem.cs]"]
  node_weapon["Weapons<br/>[Weapon.cs]"]
  node_misc["Miscellaneous items<br/>[Misc.cs]"]
  node_potion["Potions<br/>[Potion.cs]"]
  node_itemactions["Item actions<br/>[ItemActions.cs]"]
  node_itembuffs["Item buffs<br/>[ItemBuffs.cs]"]
  node_itemmanager["Item manager<br/>[ItemManager.cs]"]
end

subgraph group_progress["Progression and stats"]
  node_progression["Level progression"]
  node_levelup["Level-up system<br/>[LevelUpSystem.cs]"]
  node_stats["Character stats<br/>[CharacterStats.cs]"]
  node_modifier["Stat modifiers<br/>[StatModifier.cs]"]
end

node_user(("Console player"))
node_entry["Game entry<br/>[Program.cs]"]

node_user -->|"starts game"| node_entry
node_entry -->|"starts creation"| node_creation
node_creation -->|"reads choices"| node_user
node_creation -->|"creates player"| node_player
node_creation -->|"offers choices"| node_classes
node_creation -->|"offers choices"| node_gifts
node_creation -->|"assigns class"| node_class
node_creation -->|"assigns gift"| node_gift
node_creation -->|"calculates modifiers"| node_stats
node_class -->|"uses options"| node_classes
node_class -->|"sets stats"| node_stats
node_gift -->|"uses options"| node_gifts
node_gift -->|"modifies stats"| node_stats
node_player -->|"initializes"| node_inventory
node_player -->|"initializes"| node_equip
node_player -->|"initializes"| node_progression
node_player -->|"owns stats"| node_stats
node_inventory -->|"creates slots"| node_invslot
node_invslot -->|"equips item"| node_equip
node_invslot -->|"uses item"| node_item
node_equip -->|"uses slots"| node_equipslot
node_equip -->|"indexes equipment"| node_slots
node_equipslot -->|"holds item"| node_item
node_progression -->|"allocates points"| node_stats
node_levelup -->|"updates level"| node_progression
node_levelup -->|"uses stats"| node_stats
node_stats -->|"applies modifiers"| node_modifier
node_weapon -->|"implements"| node_item
node_weapon -->|"applies modifiers"| node_stats
node_weapon -->|"deals damage"| node_player
node_misc -->|"implements"| node_item
node_misc -->|"applies modifiers"| node_stats
node_potion -->|"implements"| node_item
node_potion -->|"uses modifiers"| node_stats
node_itemactions -->|"acts on player"| node_player
node_itemactions -->|"uses positions"| node_slots
node_itembuffs -->|"creates buffs"| node_modifier
node_itemmanager -->|"manages items"| node_item

click node_entry "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/Program.cs"
click node_creation "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/CharacterCreation.cs"
click node_class "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/classes/AssignClass.cs"
click node_classes "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/classes/ClassList.cs"
click node_gift "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/gifts/AssignGift.cs"
click node_gifts "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/gifts/GiftList.cs"
click node_player "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/Player.cs"
click node_inventory "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/PlayerInventory.cs"
click node_invslot "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/InventorySlot.cs"
click node_equip "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/PlayerEqupment.cs"
click node_equipslot "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/EquipmentSlot.cs"
click node_slots "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/EquipmentSlots.cs"
click node_progression "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/progression/LevelProgression.cs"
click node_levelup "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/progression/LevelUpSystem.cs"
click node_stats "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/CharacterStats.cs"
click node_modifier "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/StatModifier.cs"
click node_item "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/IItem.cs"
click node_weapon "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/Weapon.cs"
click node_misc "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/Misc.cs"
click node_potion "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/Potion.cs"
click node_itemactions "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/ItemActions.cs"
click node_itembuffs "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/ItemBuffs.cs"
click node_itemmanager "https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/ItemManager.cs"

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_creation,node_class,node_classes,node_gift,node_gifts toneBlue
class node_player,node_inventory,node_invslot,node_equip,node_equipslot,node_slots toneAmber
class node_item,node_weapon,node_misc,node_potion,node_itemactions,node_itembuffs,node_itemmanager toneMint
class node_progression,node_levelup,node_stats,node_modifier toneRose
class node_user toneIndigo
class node_entry toneTeal
```

## Components

### Character setup

- [Character creation](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/CharacterCreation.cs): `hhar/characters/CharacterCreation.cs`
- [Class assignment](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/classes/AssignClass.cs): `hhar/characters/stats/classes/AssignClass.cs`
- [Class choices](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/classes/ClassList.cs): `hhar/characters/stats/classes/ClassList.cs`
- [Gift assignment](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/gifts/AssignGift.cs): `hhar/characters/stats/gifts/AssignGift.cs`
- [Gift choices](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/gifts/GiftList.cs): `hhar/characters/stats/gifts/GiftList.cs`

### Character systems

- [Player character](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/Player.cs): `hhar/characters/Player.cs`
- [Player inventory](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/PlayerInventory.cs): `hhar/characters/inventory/PlayerInventory.cs`
- [Inventory slot](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/InventorySlot.cs): `hhar/characters/inventory/InventorySlot.cs`
- [Player equipment](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/PlayerEqupment.cs): `hhar/characters/inventory/PlayerEqupment.cs`
- [Equipment slot](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/EquipmentSlot.cs): `hhar/characters/inventory/EquipmentSlot.cs`
- [Equipment positions](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/inventory/EquipmentSlots.cs): `hhar/characters/inventory/EquipmentSlots.cs`

### Items and actions

- [Item contract](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/IItem.cs): `hhar/items/IItem.cs`
- [Weapons](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/Weapon.cs): `hhar/items/Weapon.cs`
- [Miscellaneous items](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/Misc.cs): `hhar/items/Misc.cs`
- [Potions](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/Potion.cs): `hhar/items/Potion.cs`
- [Item actions](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/ItemActions.cs): `hhar/items/ItemActions.cs`
- [Item buffs](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/ItemBuffs.cs): `hhar/items/ItemBuffs.cs`
- [Item manager](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/items/ItemManager.cs): `hhar/items/ItemManager.cs`

### Progression and stats

- [Level progression](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/progression/LevelProgression.cs): `hhar/characters/progression/LevelProgression.cs`
- [Level-up system](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/progression/LevelUpSystem.cs): `hhar/characters/progression/LevelUpSystem.cs`
- [Character stats](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/CharacterStats.cs): `hhar/characters/stats/CharacterStats.cs`
- [Stat modifiers](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/characters/stats/StatModifier.cs): `hhar/characters/stats/StatModifier.cs`

### Other components

- **Console player**
- [Game entry](https://github.com/raincor5/hell-has-a-rota/blob/main/hhar/Program.cs): `hhar/Program.cs`

## Connections

- Console player → Game entry: starts game (evidence: `hhar/Program.cs`)
- Game entry → Character creation: starts creation (evidence: `hhar/Program.cs`)
- Character creation → Console player: reads choices (evidence: `hhar/characters/CharacterCreation.cs`)
- Character creation → Player character: creates player (evidence: `hhar/characters/CharacterCreation.cs`)
- Character creation → Class choices: offers choices (evidence: `hhar/characters/CharacterCreation.cs`)
- Character creation → Gift choices: offers choices (evidence: `hhar/characters/CharacterCreation.cs`)
- Character creation → Class assignment: assigns class (evidence: `hhar/characters/CharacterCreation.cs`)
- Character creation → Gift assignment: assigns gift (evidence: `hhar/characters/CharacterCreation.cs`)
- Character creation → Character stats: calculates modifiers (evidence: `hhar/characters/CharacterCreation.cs`)
- Class assignment → Class choices: uses options (evidence: `hhar/characters/stats/classes/AssignClass.cs`)
- Class assignment → Character stats: sets stats (evidence: `hhar/characters/stats/classes/AssignClass.cs`)
- Gift assignment → Gift choices: uses options (evidence: `hhar/characters/stats/gifts/AssignGift.cs`)
- Gift assignment → Character stats: modifies stats (evidence: `hhar/characters/stats/gifts/AssignGift.cs`)
- Player character → Player inventory: initializes (evidence: `hhar/characters/Player.cs`)
- Player character → Player equipment: initializes (evidence: `hhar/characters/Player.cs`)
- Player character → Level progression: initializes (evidence: `hhar/characters/Player.cs`)
- Player character → Character stats: owns stats (evidence: `hhar/characters/Player.cs`)
- Player inventory → Inventory slot: creates slots (evidence: `hhar/characters/inventory/PlayerInventory.cs`)
- Inventory slot → Player equipment: equips item (evidence: `hhar/characters/inventory/InventorySlot.cs`)
- Inventory slot → Item contract: uses item (evidence: `hhar/characters/inventory/InventorySlot.cs`)
- Player equipment → Equipment slot: uses slots (evidence: `hhar/characters/inventory/PlayerEqupment.cs`)
- Player equipment → Equipment positions: indexes equipment (evidence: `hhar/characters/inventory/PlayerEqupment.cs`)
- Equipment slot → Item contract: holds item (evidence: `hhar/characters/inventory/EquipmentSlot.cs`)
- Level progression → Character stats: allocates points (evidence: `hhar/characters/progression/LevelProgression.cs`)
- Level-up system → Level progression: updates level (evidence: `hhar/characters/progression/LevelUpSystem.cs`)
- Level-up system → Character stats: uses stats (evidence: `hhar/characters/progression/LevelUpSystem.cs`)
- Character stats → Stat modifiers: applies modifiers (evidence: `hhar/characters/stats/CharacterStats.cs`)
- Weapons → Item contract: implements (evidence: `hhar/items/Weapon.cs`)
- Weapons → Character stats: applies modifiers (evidence: `hhar/items/Weapon.cs`)
- Weapons → Player character: deals damage (evidence: `hhar/items/Weapon.cs`)
- Miscellaneous items → Item contract: implements (evidence: `hhar/items/Misc.cs`)
- Miscellaneous items → Character stats: applies modifiers (evidence: `hhar/items/Misc.cs`)
- Potions → Item contract: implements (evidence: `hhar/items/Potion.cs`)
- Potions → Character stats: uses modifiers (evidence: `hhar/items/Potion.cs`)
- Item actions → Player character: acts on player (evidence: `hhar/items/ItemActions.cs`)
- Item actions → Equipment positions: uses positions (evidence: `hhar/items/ItemActions.cs`)
- Item buffs → Stat modifiers: creates buffs (evidence: `hhar/items/ItemBuffs.cs`)
- Item manager → Item contract: manages items (evidence: `hhar/items/ItemManager.cs`)
