# antarezka/merzkava-universe architecture

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

- Interactive diagram: https://gitdiagram.com/antarezka/merzkava-universe
- Repository: https://github.com/antarezka/merzkava-universe

## Overview

Merzkava Universe is a document-based cultivation roleplay setting and rules reference, not an executable application. Players propose actions; the roleplay system frames scenes under authority and gameplay rules, drawing on character, world, and regional lore. The README documents cultivation, arcanists, travel risks, NPC priorities, and continuing events as distinct capabilities. With no source excerpts, this map shows only documented conceptual relationships; it does not imply automated routing or implementation calls.

Main entry points: [`templates/GAMEPLAY_RESPONSE_TEMPLATE.md`](https://github.com/antarezka/merzkava-universe/blob/main/templates/GAMEPLAY_RESPONSE_TEMPLATE.md) (Scene narration), [`world/WORLD.md`](https://github.com/antarezka/merzkava-universe/blob/main/world/WORLD.md) (World lore), [`core/CULTIVATION_SYSTEM.md`](https://github.com/antarezka/merzkava-universe/blob/main/core/CULTIVATION_SYSTEM.md) (Cultivation realms), [`gameplay/TRAVEL_ENCOUNTER_AMBUSH_RESCUE.md`](https://github.com/antarezka/merzkava-universe/blob/main/gameplay/TRAVEL_ENCOUNTER_AMBUSH_RESCUE.md) (Travel encounters)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Roleplay & rules"]
  node_narrative["Scene narration"]
  node_authority["Source authority<br/>[AUTHORITY_ORDER.md]"]
  node_validation["Action validation"]
  node_dynamics["Narrative dynamics"]
end

subgraph group_mechanics["Character mechanics"]
  node_character["Character profile"]
  node_cultivation["Cultivation realms"]
  node_martial["Martial Souls<br/>[MARTIAL_SOUL.md]"]
  node_rings["Spirit Rings"]
  node_beasts["Spirit Beasts"]
  node_arcanists["Arcanist path"]
  node_artifacts["Artificial Artifacts"]
  node_combat["Combat rules<br/>[COMBAT_SYSTEM.md]"]
  node_economy["Economy &amp; resources"]
end

subgraph group_world["World reference"]
  node_world["World lore<br/>[WORLD.md]"]
  node_powers["Three powers"]
  node_geography["Routes &amp; geography"]
  node_regions["Regional lore<br/>[MAP_AND_REGIONS.md]"]
end

subgraph group_simulation["Ongoing world"]
  node_npc["NPC priorities<br/>[NPC_MANAGEMENT.md]"]
  node_events["Dynamic events<br/>[DYNAMIC_EVENTS.md]"]
  node_travel["Travel encounters"]
  node_time["Time &amp; actions"]
end

node_player(("Player"))

node_player -->|"drives scenes"| node_narrative
node_authority -->|"sets precedence"| node_narrative
node_validation -->|"validates actions"| node_narrative
node_dynamics -->|"supports agency"| node_narrative
node_character -->|"tracks progression"| node_cultivation
node_cultivation -->|"includes"| node_martial
node_cultivation -->|"includes"| node_rings
node_rings -->|"involves"| node_beasts
node_arcanists -->|"uses"| node_artifacts
node_character -->|"tracks wallet"| node_economy
node_world -->|"describes"| node_powers
node_world -->|"includes"| node_geography
node_world -->|"includes"| node_regions
node_npc -.->|"continues amid"| node_events
node_geography -->|"grounds routes"| node_travel
node_travel -.->|"has action risks"| node_time
node_player -.->|"may engage"| node_combat
node_player -->|"may undertake"| node_travel
node_events -.->|"shapes scenes"| node_narrative

click node_narrative "https://github.com/antarezka/merzkava-universe/blob/main/templates/GAMEPLAY_RESPONSE_TEMPLATE.md"
click node_authority "https://github.com/antarezka/merzkava-universe/blob/main/templates/AUTHORITY_ORDER.md"
click node_validation "https://github.com/antarezka/merzkava-universe/blob/main/templates/ANTI_CHEAT_HARD_GATE.md"
click node_dynamics "https://github.com/antarezka/merzkava-universe/blob/main/templates/NARRATIVE_DYNAMICS.md"
click node_character "https://github.com/antarezka/merzkava-universe/blob/main/templates/CHARACTER_PROFILE_TEMPLATE.md"
click node_cultivation "https://github.com/antarezka/merzkava-universe/blob/main/core/CULTIVATION_SYSTEM.md"
click node_martial "https://github.com/antarezka/merzkava-universe/blob/main/core/MARTIAL_SOUL.md"
click node_rings "https://github.com/antarezka/merzkava-universe/blob/main/core/SPIRIT_RING_RULES.md"
click node_beasts "https://github.com/antarezka/merzkava-universe/blob/main/bestiary/SPIRIT_BEAST_RULES.md"
click node_arcanists "https://github.com/antarezka/merzkava-universe/blob/main/core/ARCANISTRY_AND_FORMULATION.md"
click node_artifacts "https://github.com/antarezka/merzkava-universe/blob/main/world/ARTIFICIAL_ARTIFACTS.md"
click node_combat "https://github.com/antarezka/merzkava-universe/blob/main/gameplay/COMBAT_SYSTEM.md"
click node_economy "https://github.com/antarezka/merzkava-universe/blob/main/core/10_ECONOMY_SYSTEM.md"
click node_world "https://github.com/antarezka/merzkava-universe/blob/main/world/WORLD.md"
click node_powers "https://github.com/antarezka/merzkava-universe/blob/main/world/THREE_POWER_PERSPECTIVE_MAPS.md"
click node_geography "https://github.com/antarezka/merzkava-universe/blob/main/world/GEOGRAPHY_AND_TRAVEL.md"
click node_regions "https://github.com/antarezka/merzkava-universe/blob/main/world/MAP_AND_REGIONS.md"
click node_npc "https://github.com/antarezka/merzkava-universe/blob/main/world/NPC_MANAGEMENT.md"
click node_events "https://github.com/antarezka/merzkava-universe/blob/main/world/DYNAMIC_EVENTS.md"
click node_travel "https://github.com/antarezka/merzkava-universe/blob/main/gameplay/TRAVEL_ENCOUNTER_AMBUSH_RESCUE.md"
click node_time "https://github.com/antarezka/merzkava-universe/blob/main/gameplay/TIME_AND_ACTION_RULES.md"

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_narrative,node_authority,node_validation,node_dynamics toneBlue
class node_character,node_cultivation,node_martial,node_rings,node_beasts,node_arcanists,node_artifacts,node_combat,node_economy toneAmber
class node_world,node_powers,node_geography,node_regions toneMint
class node_npc,node_events,node_travel,node_time toneRose
class node_player toneIndigo
```

## Components

### Roleplay & rules

- [Scene narration](https://github.com/antarezka/merzkava-universe/blob/main/templates/GAMEPLAY_RESPONSE_TEMPLATE.md): `templates/GAMEPLAY_RESPONSE_TEMPLATE.md`
- [Source authority](https://github.com/antarezka/merzkava-universe/blob/main/templates/AUTHORITY_ORDER.md): `templates/AUTHORITY_ORDER.md`
- [Action validation](https://github.com/antarezka/merzkava-universe/blob/main/templates/ANTI_CHEAT_HARD_GATE.md): `templates/ANTI_CHEAT_HARD_GATE.md`
- [Narrative dynamics](https://github.com/antarezka/merzkava-universe/blob/main/templates/NARRATIVE_DYNAMICS.md): `templates/NARRATIVE_DYNAMICS.md`

### Character mechanics

- [Character profile](https://github.com/antarezka/merzkava-universe/blob/main/templates/CHARACTER_PROFILE_TEMPLATE.md): `templates/CHARACTER_PROFILE_TEMPLATE.md`
- [Cultivation realms](https://github.com/antarezka/merzkava-universe/blob/main/core/CULTIVATION_SYSTEM.md): `core/CULTIVATION_SYSTEM.md`
- [Martial Souls](https://github.com/antarezka/merzkava-universe/blob/main/core/MARTIAL_SOUL.md): `core/MARTIAL_SOUL.md`
- [Spirit Rings](https://github.com/antarezka/merzkava-universe/blob/main/core/SPIRIT_RING_RULES.md): `core/SPIRIT_RING_RULES.md`
- [Spirit Beasts](https://github.com/antarezka/merzkava-universe/blob/main/bestiary/SPIRIT_BEAST_RULES.md): `bestiary/SPIRIT_BEAST_RULES.md`
- [Arcanist path](https://github.com/antarezka/merzkava-universe/blob/main/core/ARCANISTRY_AND_FORMULATION.md): `core/ARCANISTRY_AND_FORMULATION.md`
- [Artificial Artifacts](https://github.com/antarezka/merzkava-universe/blob/main/world/ARTIFICIAL_ARTIFACTS.md): `world/ARTIFICIAL_ARTIFACTS.md`
- [Combat rules](https://github.com/antarezka/merzkava-universe/blob/main/gameplay/COMBAT_SYSTEM.md): `gameplay/COMBAT_SYSTEM.md`
- [Economy & resources](https://github.com/antarezka/merzkava-universe/blob/main/core/10_ECONOMY_SYSTEM.md): `core/10_ECONOMY_SYSTEM.md`

### World reference

- [World lore](https://github.com/antarezka/merzkava-universe/blob/main/world/WORLD.md): `world/WORLD.md`
- [Three powers](https://github.com/antarezka/merzkava-universe/blob/main/world/THREE_POWER_PERSPECTIVE_MAPS.md): `world/THREE_POWER_PERSPECTIVE_MAPS.md`
- [Routes & geography](https://github.com/antarezka/merzkava-universe/blob/main/world/GEOGRAPHY_AND_TRAVEL.md): `world/GEOGRAPHY_AND_TRAVEL.md`
- [Regional lore](https://github.com/antarezka/merzkava-universe/blob/main/world/MAP_AND_REGIONS.md): `world/MAP_AND_REGIONS.md`

### Ongoing world

- [NPC priorities](https://github.com/antarezka/merzkava-universe/blob/main/world/NPC_MANAGEMENT.md): `world/NPC_MANAGEMENT.md`
- [Dynamic events](https://github.com/antarezka/merzkava-universe/blob/main/world/DYNAMIC_EVENTS.md): `world/DYNAMIC_EVENTS.md`
- [Travel encounters](https://github.com/antarezka/merzkava-universe/blob/main/gameplay/TRAVEL_ENCOUNTER_AMBUSH_RESCUE.md): `gameplay/TRAVEL_ENCOUNTER_AMBUSH_RESCUE.md`
- [Time & actions](https://github.com/antarezka/merzkava-universe/blob/main/gameplay/TIME_AND_ACTION_RULES.md): `gameplay/TIME_AND_ACTION_RULES.md`

### Other components

- **Player**

## Connections

- Player → Scene narration: drives scenes (evidence: `README.md`)
- Source authority → Scene narration: sets precedence (evidence: `README.md`)
- Action validation → Scene narration: validates actions (evidence: `README.md`)
- Narrative dynamics → Scene narration: supports agency (evidence: `README.md`)
- Character profile → Cultivation realms: tracks progression (evidence: `README.md`)
- Cultivation realms → Martial Souls: includes (evidence: `README.md`)
- Cultivation realms → Spirit Rings: includes (evidence: `README.md`)
- Spirit Rings → Spirit Beasts: involves (evidence: `README.md`)
- Arcanist path → Artificial Artifacts: uses (evidence: `README.md`)
- Character profile → Economy & resources: tracks wallet (evidence: `README.md`)
- World lore → Three powers: describes (evidence: `README.md`)
- World lore → Routes & geography: includes (evidence: `README.md`)
- World lore → Regional lore: includes (evidence: `README.md`)
- NPC priorities → Dynamic events: continues amid
- Routes & geography → Travel encounters: grounds routes (evidence: `README.md`)
- Travel encounters → Time & actions: has action risks
- Player → Combat rules: may engage
- Player → Travel encounters: may undertake (evidence: `README.md`)
- Dynamic events → Scene narration: shapes scenes