# bible131masokism-coder/arcanum architecture

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

- Interactive diagram: https://gitdiagram.com/bible131masokism-coder/arcanum
- Repository: https://github.com/bible131masokism-coder/arcanum

## Overview

This is a Vue-based incremental/adventure game: players use the interface to load and advance a game state, interact with its content and systems, and see updated character, inventory, and activity results. The graph shows the documented runtime links and preserves major gameplay areas visible in the source tree. The README provides no product description, and many UI sections and gameplay modules were not sampled, so their connections are omitted rather than inferred.

Main entry points: [`src/game.js`](https://github.com/bible131masokism-coder/arcanum/blob/main/src/game.js) (Game coordinator), [`src/events.js`](https://github.com/bible131masokism-coder/arcanum/blob/main/src/events.js) (Event dispatch), [`src/modules/itemgen.js`](https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/itemgen.js) (Item generation), [`src/ui/main.vue`](https://github.com/bible131masokism-coder/arcanum/blob/main/src/ui/main.vue) (Main interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Player interface"]
  node_ui["Main interface<br/>[main.vue]"]
  node_activity_ui["Activity screens<br/>[tasks.vue]"]
  node_item_ui["Item display<br/>[gdata.vue]"]
end

subgraph group_runtime["Game runtime"]
  node_app["App entry<br/>[index.js]"]
  node_game["Game coordinator<br/>[game.js]"]
  node_state["Game state<br/>[gameState.js]"]
  node_events["Event dispatch<br/>[events.js]"]
  node_change_tracking["Change tracking<br/>[changes.js]"]
  node_stats["Stat values<br/>[stat.js]"]
  node_rvalues["Runtime values<br/>[rvalue.js]"]
  node_constants["Game constants<br/>[consts.js]"]
  node_object_utils["Object utilities<br/>[objecty.js]"]
end

subgraph group_content["Content and models"]
  node_loader["Content loader<br/>[dataLoader.js]"]
  node_parsing["Data parsing<br/>[parsing.js]"]
  node_itemgen["Item generation<br/>[itemgen.js]"]
  node_base["Base data model<br/>[base.js]"]
  node_gdata["Game data model<br/>[gdata.js]"]
  node_item["Item instances<br/>[item.js]"]
  node_tagsets["Tag sets<br/>[tagset.js]"]
end

subgraph group_gameplay["Gameplay systems"]
  node_combat["Combat system<br/>[combat.js]"]
  node_characters["Character models<br/>[char.js]"]
  node_inventory["Inventory<br/>[inventory.js]"]
  node_exploration["Exploration<br/>[explore.js]"]
  node_crafting["Crafting<br/>[craft.js]"]
  node_enchanting["Enchanting<br/>[enchanting.js]"]
  node_runner["Activity runner<br/>[runner.js]"]
  node_tech_tree["Technology tree<br/>[techTree.js]"]
  node_combat_vars["Combat values<br/>[combatVars.js]"]
end

subgraph group_integration["Persistence and services"]
  node_persist["Persistence<br/>[persist.js]"]
  node_remote["Remote service client<br/>[remote.js]"]
end

node_player(("Player"))

node_player -->|"uses"| node_ui
node_ui -->|"accesses"| node_game
node_ui -->|"shows"| node_activity_ui
node_ui -->|"shows"| node_item_ui
node_app -->|"imports"| node_game
node_app -->|"imports"| node_events
node_app -->|"imports"| node_loader
node_game -->|"loads"| node_state
node_game -->|"loads data"| node_loader
node_game -->|"initializes"| node_events
node_game -->|"processes changes"| node_change_tracking
node_game -->|"generates items"| node_itemgen
node_game -->|"updates"| node_tech_tree
node_game -->|"builds"| node_tagsets
node_loader -->|"loads"| node_gdata
node_loader -->|"uses"| node_parsing
node_base -->|"parses modifiers"| node_parsing
node_gdata -->|"extends"| node_base
node_base -->|"marks changes"| node_change_tracking
node_item -->|"uses"| node_base
node_itemgen -->|"creates instances"| node_item
node_itemgen -->|"uses"| node_tagsets
node_inventory -->|"generates items"| node_itemgen
node_combat -->|"uses"| node_characters
node_combat -->|"uses"| node_itemgen
node_combat -->|"dispatches events"| node_events
node_characters -->|"uses"| node_combat_vars
node_characters -->|"uses"| node_events
node_stats -->|"extends"| node_rvalues
node_stats -->|"reads game context"| node_game
node_combat_vars -->|"uses"| node_rvalues
node_combat_vars -->|"dispatches events"| node_events
node_gdata -->|"uses"| node_events
node_gdata -->|"uses"| node_stats
node_tagsets -->|"uses"| node_change_tracking
node_activity_ui -->|"reads"| node_game
node_item_ui -->|"reads"| node_game
node_game -.->|"may dispatch"| node_runner
node_game -.->|"may persist state"| node_persist
node_game -.->|"may use service"| node_remote

click node_app "https://github.com/bible131masokism-coder/arcanum/blob/main/src/index.js"
click node_ui "https://github.com/bible131masokism-coder/arcanum/blob/main/src/ui/main.vue"
click node_activity_ui "https://github.com/bible131masokism-coder/arcanum/blob/main/src/ui/sections/tasks.vue"
click node_item_ui "https://github.com/bible131masokism-coder/arcanum/blob/main/src/ui/items/gdata.vue"
click node_game "https://github.com/bible131masokism-coder/arcanum/blob/main/src/game.js"
click node_state "https://github.com/bible131masokism-coder/arcanum/blob/main/src/gameState.js"
click node_events "https://github.com/bible131masokism-coder/arcanum/blob/main/src/events.js"
click node_change_tracking "https://github.com/bible131masokism-coder/arcanum/blob/main/src/changes.js"
click node_loader "https://github.com/bible131masokism-coder/arcanum/blob/main/src/dataLoader.js"
click node_parsing "https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/parsing.js"
click node_itemgen "https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/itemgen.js"
click node_base "https://github.com/bible131masokism-coder/arcanum/blob/main/src/items/base.js"
click node_gdata "https://github.com/bible131masokism-coder/arcanum/blob/main/src/items/gdata.js"
click node_item "https://github.com/bible131masokism-coder/arcanum/blob/main/src/items/item.js"
click node_tagsets "https://github.com/bible131masokism-coder/arcanum/blob/main/src/composites/tagset.js"
click node_combat "https://github.com/bible131masokism-coder/arcanum/blob/main/src/composites/combat.js"
click node_characters "https://github.com/bible131masokism-coder/arcanum/blob/main/src/chars/char.js"
click node_inventory "https://github.com/bible131masokism-coder/arcanum/blob/main/src/inventories/inventory.js"
click node_exploration "https://github.com/bible131masokism-coder/arcanum/blob/main/src/composites/explore.js"
click node_crafting "https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/craft.js"
click node_enchanting "https://github.com/bible131masokism-coder/arcanum/blob/main/src/composites/enchanting.js"
click node_runner "https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/runner.js"
click node_tech_tree "https://github.com/bible131masokism-coder/arcanum/blob/main/src/techTree.js"
click node_persist "https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/persist/persist.js"
click node_remote "https://github.com/bible131masokism-coder/arcanum/blob/main/src/remote/remote.js"
click node_stats "https://github.com/bible131masokism-coder/arcanum/blob/main/src/values/rvals/stat.js"
click node_rvalues "https://github.com/bible131masokism-coder/arcanum/blob/main/src/values/rvals/rvalue.js"
click node_combat_vars "https://github.com/bible131masokism-coder/arcanum/blob/main/src/values/combatVars.js"
click node_constants "https://github.com/bible131masokism-coder/arcanum/blob/main/src/values/consts.js"
click node_object_utils "https://github.com/bible131masokism-coder/arcanum/blob/main/src/util/objecty.js"

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_ui,node_activity_ui,node_item_ui toneBlue
class node_app,node_game,node_state,node_events,node_change_tracking,node_stats,node_rvalues,node_constants,node_object_utils toneAmber
class node_loader,node_parsing,node_itemgen,node_base,node_gdata,node_item,node_tagsets toneMint
class node_combat,node_characters,node_inventory,node_exploration,node_crafting,node_enchanting,node_runner,node_tech_tree,node_combat_vars toneRose
class node_persist,node_remote,node_player toneIndigo
```

## Components

### Player interface

- [Main interface](https://github.com/bible131masokism-coder/arcanum/blob/main/src/ui/main.vue): `src/ui/main.vue`
- [Activity screens](https://github.com/bible131masokism-coder/arcanum/blob/main/src/ui/sections/tasks.vue): `src/ui/sections/tasks.vue`
- [Item display](https://github.com/bible131masokism-coder/arcanum/blob/main/src/ui/items/gdata.vue): `src/ui/items/gdata.vue`

### Game runtime

- [App entry](https://github.com/bible131masokism-coder/arcanum/blob/main/src/index.js): `src/index.js`
- [Game coordinator](https://github.com/bible131masokism-coder/arcanum/blob/main/src/game.js): `src/game.js`
- [Game state](https://github.com/bible131masokism-coder/arcanum/blob/main/src/gameState.js): `src/gameState.js`
- [Event dispatch](https://github.com/bible131masokism-coder/arcanum/blob/main/src/events.js): `src/events.js`
- [Change tracking](https://github.com/bible131masokism-coder/arcanum/blob/main/src/changes.js): `src/changes.js`
- [Stat values](https://github.com/bible131masokism-coder/arcanum/blob/main/src/values/rvals/stat.js): `src/values/rvals/stat.js`
- [Runtime values](https://github.com/bible131masokism-coder/arcanum/blob/main/src/values/rvals/rvalue.js): `src/values/rvals/rvalue.js`
- [Game constants](https://github.com/bible131masokism-coder/arcanum/blob/main/src/values/consts.js): `src/values/consts.js`
- [Object utilities](https://github.com/bible131masokism-coder/arcanum/blob/main/src/util/objecty.js): `src/util/objecty.js`

### Content and models

- [Content loader](https://github.com/bible131masokism-coder/arcanum/blob/main/src/dataLoader.js): `src/dataLoader.js`
- [Data parsing](https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/parsing.js): `src/modules/parsing.js`
- [Item generation](https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/itemgen.js): `src/modules/itemgen.js`
- [Base data model](https://github.com/bible131masokism-coder/arcanum/blob/main/src/items/base.js): `src/items/base.js`
- [Game data model](https://github.com/bible131masokism-coder/arcanum/blob/main/src/items/gdata.js): `src/items/gdata.js`
- [Item instances](https://github.com/bible131masokism-coder/arcanum/blob/main/src/items/item.js): `src/items/item.js`
- [Tag sets](https://github.com/bible131masokism-coder/arcanum/blob/main/src/composites/tagset.js): `src/composites/tagset.js`

### Gameplay systems

- [Combat system](https://github.com/bible131masokism-coder/arcanum/blob/main/src/composites/combat.js): `src/composites/combat.js`
- [Character models](https://github.com/bible131masokism-coder/arcanum/blob/main/src/chars/char.js): `src/chars/char.js`
- [Inventory](https://github.com/bible131masokism-coder/arcanum/blob/main/src/inventories/inventory.js): `src/inventories/inventory.js`
- [Exploration](https://github.com/bible131masokism-coder/arcanum/blob/main/src/composites/explore.js): `src/composites/explore.js`
- [Crafting](https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/craft.js): `src/modules/craft.js`
- [Enchanting](https://github.com/bible131masokism-coder/arcanum/blob/main/src/composites/enchanting.js): `src/composites/enchanting.js`
- [Activity runner](https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/runner.js): `src/modules/runner.js`
- [Technology tree](https://github.com/bible131masokism-coder/arcanum/blob/main/src/techTree.js): `src/techTree.js`
- [Combat values](https://github.com/bible131masokism-coder/arcanum/blob/main/src/values/combatVars.js): `src/values/combatVars.js`

### Persistence and services

- [Persistence](https://github.com/bible131masokism-coder/arcanum/blob/main/src/modules/persist/persist.js): `src/modules/persist/persist.js`
- [Remote service client](https://github.com/bible131masokism-coder/arcanum/blob/main/src/remote/remote.js): `src/remote/remote.js`

### Other components

- **Player**

## Connections

- Player → Main interface: uses
- Main interface → Game coordinator: accesses (evidence: `src/ui/main.vue`)
- Main interface → Activity screens: shows (evidence: `src/ui/main.vue`)
- Main interface → Item display: shows (evidence: `src/ui/main.vue`)
- App entry → Game coordinator: imports (evidence: `src/index.js`)
- App entry → Event dispatch: imports (evidence: `src/index.js`)
- App entry → Content loader: imports (evidence: `src/index.js`)
- Game coordinator → Game state: loads (evidence: `src/game.js`)
- Game coordinator → Content loader: loads data (evidence: `src/game.js`)
- Game coordinator → Event dispatch: initializes (evidence: `src/game.js`)
- Game coordinator → Change tracking: processes changes (evidence: `src/game.js`)
- Game coordinator → Item generation: generates items (evidence: `src/game.js`)
- Game coordinator → Technology tree: updates (evidence: `src/game.js`)
- Game coordinator → Tag sets: builds (evidence: `src/game.js`)
- Content loader → Game data model: loads (evidence: `src/dataLoader.js`)
- Content loader → Data parsing: uses (evidence: `src/dataLoader.js`)
- Base data model → Data parsing: parses modifiers (evidence: `src/items/base.js`)
- Game data model → Base data model: extends (evidence: `src/items/gdata.js`)
- Base data model → Change tracking: marks changes (evidence: `src/items/base.js`)
- Item instances → Base data model: uses (evidence: `src/items/item.js`)
- Item generation → Item instances: creates instances (evidence: `src/modules/itemgen.js`)
- Item generation → Tag sets: uses (evidence: `src/modules/itemgen.js`)
- Inventory → Item generation: generates items (evidence: `src/inventories/inventory.js`)
- Combat system → Character models: uses (evidence: `src/composites/combat.js`)
- Combat system → Item generation: uses (evidence: `src/composites/combat.js`)
- Combat system → Event dispatch: dispatches events (evidence: `src/composites/combat.js`)
- Character models → Combat values: uses (evidence: `src/chars/char.js`)
- Character models → Event dispatch: uses (evidence: `src/chars/char.js`)
- Stat values → Runtime values: extends (evidence: `src/values/rvals/stat.js`)
- Stat values → Game coordinator: reads game context (evidence: `src/values/rvals/stat.js`)
- Combat values → Runtime values: uses (evidence: `src/values/combatVars.js`)
- Combat values → Event dispatch: dispatches events (evidence: `src/values/combatVars.js`)
- Game data model → Event dispatch: uses (evidence: `src/items/gdata.js`)
- Game data model → Stat values: uses (evidence: `src/items/gdata.js`)
- Tag sets → Change tracking: uses (evidence: `src/composites/tagset.js`)
- Activity screens → Game coordinator: reads (evidence: `src/ui/sections/tasks.vue`)
- Item display → Game coordinator: reads (evidence: `src/ui/items/gdata.vue`)
- Game coordinator → Activity runner: may dispatch (evidence: `src/modules/runner.js`)
- Game coordinator → Persistence: may persist state
- Game coordinator → Remote service client: may use service
