Architecture

This page is product-neutral: it describes Molca Core and where VR, Digital Twin, and Shared code sit relative to each other and Unity. It does not assume you are building a VR training app.

If you are building…	Go to
VR training (scenarios, XR, tour)	VR SDK overview · VR architecture · VR content hierarchy
Digital Twin (POI, panels, `_MolcaDT`)	DT architecture · DT overview
Bootstrap & settings (any product)	Runtime and settings

Layers (stack)

Read top → bottom as “depends on the row below”. Your project sits on optional product packages, all on Molca Core, all on Unity.

Layer	What lives here
Your project	Scenes, authored assets, your gameplay/integration code.
Product SDK (use the folders your template ships)	VR — `Assets/_MolcaSDK/_VR` · DT — `Assets/_MolcaDT` · Shared — `Assets/_MolcaSDK/Code`
Molca Core	`Packages/com.molca.core/` — RuntimeManager, DI, events, references, sequences, HTTP, modals, `SettingModule` / GlobalSettings.
Unity	Player loop, rendering, XR, UI, networking stacks.

You may use Core only, or Core plus any combination of VR / DT / Shared — see Platforms.

Core building blocks (glossary)

These types/concepts are shared wherever Core is referenced:

Term	Role
MolcaProjectSettings	Root ScriptableObject: RuntimeManager prefab + GlobalSettings (project settings).
RuntimeManager	Scene-persistent host for subsystems and service location (RuntimeManager).
RuntimeSubsystem	`MonoBehaviour` registered with RuntimeManager (`TourSubsystem`, session, etc., depending on prefab) (subsystem).
GlobalSettings	Bag of `SettingModule` assets (modular config) (Global settings).
EventDispatcher	Typed pub/sub for application events (events).
Reference system	Stable ids for telemetry / linking (references).
SequenceController	Runs a tree of Steps (sequences).
Step	One node in a sequence; may nest children; drives completion rules (Step).
HttpClient / data	Config-driven HTTP and caching patterns (HTTP client).

VR adds scenario, session, and XR concepts on top of Core; DT adds twin managers, POI, and panel flows — see the product architecture pages above.

Where to read next

Goal	Page
Choose which SDK folder applies	Platforms
Startup chain (settings → prefab → modules)	Runtime and settings
VR scenarios, sessions, tour, glossary	VR architecture
DT folders and twin domain	DT architecture
Compatibility / validation	Compatibility and validation

Unity Editor

Sdk Overview Editor — SDK project window

Overview

Common Tasks

Molca Core

Shared module (MolcaSDK)

Molca SDK - VR

Molca SDK - DT

Layers (stack)

Core building blocks (glossary)

Where to read next

Unity Editor

​Layers (stack)

​Core building blocks (glossary)

​Where to read next

​Unity Editor

Layers (stack)

Core building blocks (glossary)

Where to read next

Unity Editor