# top-secret666/the-witcher architecture

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

- Interactive diagram: https://gitdiagram.com/top-secret666/the-witcher
- Repository: https://github.com/top-secret666/the-witcher

## Overview

This repository is a Java pixel-art visual-novel game prototype. Its documented play path runs from the Swing view through a presenter and Chapter 1 director into domain behavior. The graph preserves the chapter’s major story, combat, loop, shop, and ending stages, alongside the game’s menu/intro and rendering layers. Some links reflect the README’s documented architecture; sampled source and the SOURCE INDEX support selected internal dependencies. Unsampled subsystem internals are represented conservatively.

Main entry points: [`dev/src/main/java/com/witcher/ui/chapter1/presenter/Chapter1Presenter.java`](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/chapter1/presenter/Chapter1Presenter.java) (Chapter Presenter), [`dev/src/main/java/com/witcher/chapter1/battle/encounter/BossEncounterController.java`](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/battle/encounter/BossEncounterController.java) (Boss Encounters), [`dev/src/main/java/com/witcher/chapter1/battle/briefing/BossQuestBriefingController.java`](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/battle/briefing/BossQuestBriefingController.java) (Boss Briefing), [`dev/src/main/java/com/witcher/ui/shop/presenter/ShopPresenter.java`](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/shop/presenter/ShopPresenter.java) (Shop Presenter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry_ui["Screens and Input"]
  node_chapter_screen["Chapter Screen"]
  node_chapter_presenter["Chapter Presenter"]
  node_intro["Intro Controller"]
  node_menu["Main Menu"]
end

subgraph group_chapter["Chapter 1 Story"]
  node_director["Chapter Director"]
  node_session["Chapter Session"]
  node_vn["VN Choices and State<br/>[VnSceneState.java]"]
  node_combat["Boss Encounters"]
  node_briefing["Boss Briefing"]
  node_typing["VN Typing Engine"]
  node_loop["Awakening Loop"]
  node_ending["Demo Ending"]
end

subgraph group_domain["Game Domain"]
end

subgraph group_shop_gear["Shop and Gear"]
  node_shop["Shop Presenter<br/>[ShopPresenter.java]"]
  node_shop_view["Shop View<br/>[ShopView.java]"]
  node_armor_service["Armor Services<br/>[ArmorService.java]"]
  node_armor_model["Armor Model<br/>[Armour.java]"]
end

subgraph group_render["Rendering"]
  node_swing_render["Swing Rendering"]
  node_gdx_textures["Pixel Textures<br/>[PixelTextures.java]"]
end

node_player(("Player"))

node_player -->|"plays through"| node_chapter_screen
node_chapter_screen -->|"forwards input"| node_chapter_presenter
node_chapter_presenter -->|"routes phases"| node_director
node_director -.->|"coordinates state"| node_session
node_menu -.->|"starts story"| node_intro
node_chapter_presenter -.->|"drives phase"| node_briefing
node_chapter_presenter -.->|"drives phase"| node_combat
node_combat -->|"ticks dialogue"| node_typing
node_briefing -->|"ticks dialogue"| node_typing
node_combat -->|"reads session"| node_session
node_briefing -->|"reads session"| node_session
node_chapter_presenter -.->|"drives phase"| node_loop
node_chapter_presenter -.->|"drives phase"| node_ending
node_chapter_presenter -.->|"routes shop input"| node_shop
node_shop -.->|"updates view"| node_shop_view
node_armor_service -->|"selects armor"| node_armor_model
node_shop -.->|"uses gear domain"| node_armor_service
node_intro -->|"uses dialog layout"| node_swing_render

click node_chapter_screen "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/chapter1/swing/Chapter1Screen.java"
click node_chapter_presenter "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/chapter1/presenter/Chapter1Presenter.java"
click node_intro "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/intro/presenter/IntroController.java"
click node_menu "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/menu/MainMenuController.java"
click node_director "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/Chapter1Director.java"
click node_session "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/Chapter1Session.java"
click node_vn "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/vn/VnSceneState.java"
click node_combat "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/battle/encounter/BossEncounterController.java"
click node_briefing "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/battle/briefing/BossQuestBriefingController.java"
click node_typing "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/battle/BossVnTypingEngine.java"
click node_loop "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/loop/EyesAwakeningController.java"
click node_ending "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/ending/DemoEndingController.java"
click node_shop "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/shop/presenter/ShopPresenter.java"
click node_shop_view "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/shop/view/ShopView.java"
click node_armor_service "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/service/ArmorService.java"
click node_armor_model "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/model/armour/Armour.java"
click node_swing_render "https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/graphics/DialogBoxRenderer.java"
click node_gdx_textures "https://github.com/top-secret666/the-witcher/blob/master/dev/core/src/main/java/com/witcher/gdx/graphics/PixelTextures.java"

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_chapter_screen,node_chapter_presenter,node_intro,node_menu toneBlue
class node_director,node_session,node_vn,node_combat,node_briefing,node_typing,node_loop,node_ending toneAmber
class node_shop,node_shop_view,node_armor_service,node_armor_model toneRose
class node_swing_render,node_gdx_textures,node_player toneIndigo
```

## Components

### Screens and Input

- [Chapter Screen](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/chapter1/swing/Chapter1Screen.java): `dev/src/main/java/com/witcher/ui/chapter1/swing/Chapter1Screen.java`
- [Chapter Presenter](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/chapter1/presenter/Chapter1Presenter.java): `dev/src/main/java/com/witcher/ui/chapter1/presenter/Chapter1Presenter.java`
- [Intro Controller](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/intro/presenter/IntroController.java): `dev/src/main/java/com/witcher/ui/intro/presenter/IntroController.java`
- [Main Menu](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/menu/MainMenuController.java): `dev/src/main/java/com/witcher/ui/menu/MainMenuController.java`

### Chapter 1 Story

- [Chapter Director](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/Chapter1Director.java): `dev/src/main/java/com/witcher/chapter1/Chapter1Director.java`
- [Chapter Session](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/Chapter1Session.java): `dev/src/main/java/com/witcher/chapter1/Chapter1Session.java`
- [VN Choices and State](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/vn/VnSceneState.java): `dev/src/main/java/com/witcher/chapter1/vn/VnSceneState.java`
- [Boss Encounters](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/battle/encounter/BossEncounterController.java): `dev/src/main/java/com/witcher/chapter1/battle/encounter/BossEncounterController.java`
- [Boss Briefing](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/battle/briefing/BossQuestBriefingController.java): `dev/src/main/java/com/witcher/chapter1/battle/briefing/BossQuestBriefingController.java`
- [VN Typing Engine](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/battle/BossVnTypingEngine.java): `dev/src/main/java/com/witcher/chapter1/battle/BossVnTypingEngine.java`
- [Awakening Loop](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/loop/EyesAwakeningController.java): `dev/src/main/java/com/witcher/chapter1/loop/EyesAwakeningController.java`
- [Demo Ending](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/chapter1/ending/DemoEndingController.java): `dev/src/main/java/com/witcher/chapter1/ending/DemoEndingController.java`

### Shop and Gear

- [Shop Presenter](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/shop/presenter/ShopPresenter.java): `dev/src/main/java/com/witcher/ui/shop/presenter/ShopPresenter.java`
- [Shop View](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/shop/view/ShopView.java): `dev/src/main/java/com/witcher/ui/shop/view/ShopView.java`
- [Armor Services](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/service/ArmorService.java): `dev/src/main/java/com/witcher/service/ArmorService.java`
- [Armor Model](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/model/armour/Armour.java): `dev/src/main/java/com/witcher/model/armour/Armour.java`

### Rendering

- [Swing Rendering](https://github.com/top-secret666/the-witcher/blob/master/dev/src/main/java/com/witcher/ui/graphics/DialogBoxRenderer.java): `dev/src/main/java/com/witcher/ui/graphics/DialogBoxRenderer.java`
- [Pixel Textures](https://github.com/top-secret666/the-witcher/blob/master/dev/core/src/main/java/com/witcher/gdx/graphics/PixelTextures.java): `dev/core/src/main/java/com/witcher/gdx/graphics/PixelTextures.java`

### Other components

- **Player**

## Connections

- Player → Chapter Screen: plays through (evidence: `README.md`)
- Chapter Screen → Chapter Presenter: forwards input (evidence: `README.md`)
- Chapter Presenter → Chapter Director: routes phases (evidence: `README.md`)
- Chapter Director → Chapter Session: coordinates state
- Main Menu → Intro Controller: starts story
- Chapter Presenter → Boss Briefing: drives phase
- Chapter Presenter → Boss Encounters: drives phase
- Boss Encounters → VN Typing Engine: ticks dialogue (evidence: `dev/src/main/java/com/witcher/chapter1/battle/encounter/BossEncounterController.java`)
- Boss Briefing → VN Typing Engine: ticks dialogue (evidence: `dev/src/main/java/com/witcher/chapter1/battle/briefing/BossQuestBriefingController.java`)
- Boss Encounters → Chapter Session: reads session (evidence: `dev/src/main/java/com/witcher/chapter1/battle/encounter/BossEncounterController.java`)
- Boss Briefing → Chapter Session: reads session (evidence: `dev/src/main/java/com/witcher/chapter1/battle/briefing/BossQuestBriefingController.java`)
- Chapter Presenter → Awakening Loop: drives phase
- Chapter Presenter → Demo Ending: drives phase
- Chapter Presenter → Shop Presenter: routes shop input
- Shop Presenter → Shop View: updates view
- Armor Services → Armor Model: selects armor (evidence: `dev/src/main/java/com/witcher/service/ArmorService.java`)
- Shop Presenter → Armor Services: uses gear domain
- Intro Controller → Swing Rendering: uses dialog layout (evidence: `dev/src/main/java/com/witcher/ui/intro/presenter/IntroController.java`)
