# fulldivegames/majoras-mask-vr architecture

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

- Interactive diagram: https://gitdiagram.com/fulldivegames/majoras-mask-vr
- Repository: https://github.com/fulldivegames/majoras-mask-vr

## Overview

Majora’s Mask VR is a cross-platform VR game mod, with Windows PCVR and standalone Quest support. The main user journey is to provide a legally obtained game ROM or compatible archive, prepare platform resources, launch the game, and play with VR controls and settings; saving and resuming are separate gameplay capabilities. The tree also contains the asset-processing and shared resource layers that support the game. Connections are limited to README statements and the shown source references; unsampled gameplay internals are represented at their enclosing directory.

Main entry points: [`src/2ship2harkinian/mm`](https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/2ship2harkinian/mm) (VR game), [`platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SetupActivity.java`](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SetupActivity.java) (Setup and import), [`src/2ship2harkinian/OTRExporter/OTRExporter/Main.cpp`](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/OTRExporter/OTRExporter/Main.cpp) (Asset export), [`src/2ship2harkinian/libultraship/src/ship/resource/ResourceManager.cpp`](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/libultraship/src/ship/resource/ResourceManager.cpp) (Resource manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Quest app setup"]
  node_setup["Setup and import<br/>[SetupActivity.java]"]
  node_storage["Shared storage<br/>[SharedStorage.java]"]
  node_game_activity["Quest game launch<br/>[GameActivity.java]"]
end

subgraph group_assets["Game asset preparation"]
  node_rom_extract["ROM extraction<br/>[rom_extract.cpp]"]
  node_asset_export["Asset export<br/>[Main.cpp]"]
  node_zapd["Asset processing<br/>[Main.cpp]"]
end

subgraph group_runtime["VR game runtime"]
  node_game["VR game"]
  node_vr_controls["VR controls"]
  node_presets["Gameplay presets<br/>[PresetManager.cpp]"]
  node_menus["VR menu and settings"]
end

subgraph group_resources["Resource and saves"]
  node_archive_manager["Archive manager<br/>[ArchiveManager.cpp]"]
  node_resource_manager["Resource manager"]
  node_saves["Save management<br/>[SaveManager.cpp]"]
  node_save_states["Save states"]
end

node_player(("Player"))

node_player -->|"selects ROM"| node_setup
node_setup -.->|"extracts ROM"| node_rom_extract
node_setup -->|"prepares storage"| node_storage
node_setup -->|"launches game"| node_game_activity
node_player -->|"provides ROM"| node_asset_export
node_asset_export -.->|"exports assets"| node_zapd
node_player -->|"plays"| node_game
node_game -.->|"uses gestures"| node_vr_controls
node_player -->|"opens settings"| node_menus
node_player -.->|"configures presets"| node_presets
node_game -.->|"loads resources"| node_resource_manager
node_resource_manager -->|"queries archives"| node_archive_manager
node_game -.->|"saves progress"| node_saves
node_player -->|"saves or resumes"| node_save_states
node_game -.->|"captures state"| node_save_states

click node_setup "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SetupActivity.java"
click node_storage "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SharedStorage.java"
click node_game_activity "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/GameActivity.java"
click node_rom_extract "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/native/rom_extract.cpp"
click node_asset_export "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/OTRExporter/OTRExporter/Main.cpp"
click node_zapd "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/ZAPDTR/ZAPD/Main.cpp"
click node_game "https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/2ship2harkinian/mm"
click node_vr_controls "https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/2ship2harkinian/mm/2s2h/VR"
click node_presets "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/mm/2s2h/PresetManager/PresetManager.cpp"
click node_menus "https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/mmvr-runtime"
click node_archive_manager "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/libultraship/src/ship/resource/archive/ArchiveManager.cpp"
click node_resource_manager "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/libultraship/src/ship/resource/ResourceManager.cpp"
click node_saves "https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/mm/2s2h/SaveManager/SaveManager.cpp"
click node_save_states "https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/mmvr-runtime/save_states"

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_setup,node_storage,node_game_activity toneBlue
class node_rom_extract,node_asset_export,node_zapd toneAmber
class node_game,node_vr_controls,node_presets,node_menus toneMint
class node_archive_manager,node_resource_manager,node_saves,node_save_states toneRose
class node_player toneIndigo
```

## Components

### Quest app setup

- [Setup and import](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SetupActivity.java): `platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SetupActivity.java`
- [Shared storage](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SharedStorage.java): `platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SharedStorage.java`
- [Quest game launch](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/GameActivity.java): `platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/GameActivity.java`

### Game asset preparation

- [ROM extraction](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/platform/android/native/rom_extract.cpp): `platform/android/native/rom_extract.cpp`
- [Asset export](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/OTRExporter/OTRExporter/Main.cpp): `src/2ship2harkinian/OTRExporter/OTRExporter/Main.cpp`
- [Asset processing](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/ZAPDTR/ZAPD/Main.cpp): `src/2ship2harkinian/ZAPDTR/ZAPD/Main.cpp`

### VR game runtime

- [VR game](https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/2ship2harkinian/mm): `src/2ship2harkinian/mm`
- [VR controls](https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/2ship2harkinian/mm/2s2h/VR): `src/2ship2harkinian/mm/2s2h/VR`
- [Gameplay presets](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/mm/2s2h/PresetManager/PresetManager.cpp): `src/2ship2harkinian/mm/2s2h/PresetManager/PresetManager.cpp`
- [VR menu and settings](https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/mmvr-runtime): `src/mmvr-runtime`

### Resource and saves

- [Archive manager](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/libultraship/src/ship/resource/archive/ArchiveManager.cpp): `src/2ship2harkinian/libultraship/src/ship/resource/archive/ArchiveManager.cpp`
- [Resource manager](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/libultraship/src/ship/resource/ResourceManager.cpp): `src/2ship2harkinian/libultraship/src/ship/resource/ResourceManager.cpp`
- [Save management](https://github.com/fulldivegames/majoras-mask-vr/blob/develop/src/2ship2harkinian/mm/2s2h/SaveManager/SaveManager.cpp): `src/2ship2harkinian/mm/2s2h/SaveManager/SaveManager.cpp`
- [Save states](https://github.com/fulldivegames/majoras-mask-vr/tree/develop/src/mmvr-runtime/save_states): `src/mmvr-runtime/save_states`

### Other components

- **Player**

## Connections

- Player → Setup and import: selects ROM
- Setup and import → ROM extraction: extracts ROM
- Setup and import → Shared storage: prepares storage (evidence: `platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SetupActivity.java`)
- Setup and import → Quest game launch: launches game (evidence: `platform/android/app/src/main/java/com/fulldivegames/majorasmaskvr/SetupActivity.java`)
- Player → Asset export: provides ROM
- Asset export → Asset processing: exports assets
- Player → VR game: plays
- VR game → VR controls: uses gestures (evidence: `src/2ship2harkinian/mm/2s2h/VR/CombatPipelineTest.h`)
- Player → VR menu and settings: opens settings
- Player → Gameplay presets: configures presets
- VR game → Resource manager: loads resources
- Resource manager → Archive manager: queries archives (evidence: `src/2ship2harkinian/libultraship/src/ship/resource/ResourceManager.cpp`)
- VR game → Save management: saves progress (evidence: `src/2ship2harkinian/mm/2s2h/SaveManager/SaveManager.cpp`)
- Player → Save states: saves or resumes
- VR game → Save states: captures state
