# Molca Unity Docs

> Technical documentation for Molca Unity: Molca Core, Shared module, VR training SDK, and Digital Twin SDK.

## Docs

- [ColorID (theming)](https://docs-unity.molca.id/core/color-id.md): ColorModule SettingModule, ColorID components, ColorSchemeManager, ColorIDReference, and ColorUtility.
- [Content packages (Addressables)](https://docs-unity.molca.id/core/content-packages.md): Core ContentPackage system and Addressables build hooks in the shared SDK.
- [Core step types](https://docs-unity.molca.id/core/core-step-types.md): ParallelStep, AnimationStep, IntCounterStep, FloatListenerStep, and other non-VR steps.
- [CSV Step Importer](https://docs-unity.molca.id/core/csv-step-importer.md): Import step metadata from CSV into a SequenceController hierarchy.
- [DataManager](https://docs-unity.molca.id/core/data-manager.md): Networked data providers, caching, model subscriptions, and batch data processing.
- [Dependency injection](https://docs-unity.molca.id/core/dependency-injection.md): Inject attribute, scene injection, and manual resolution for dynamically created objects.
- [EventDispatcher](https://docs-unity.molca.id/core/event-dispatcher.md): String-keyed and generic publish/subscribe events.
- [HttpClient and HttpRequestAsset](https://docs-unity.molca.id/core/http-client.md): Async HTTP, ScriptableObject-defined endpoints, and integration with session code.
- [Localization](https://docs-unity.molca.id/core/localization.md): LocalizationModule settings, LocalizationManager subsystem, LocalizedText, and dynamic runtime entries.
- [ModalManager](https://docs-unity.molca.id/core/modal-manager.md): Message, confirmation, loading, and typed modal hosting.
- [Reference system](https://docs-unity.molca.id/core/reference-system.md): ReferenceManager, ReferenceableComponent, and SceneObjectReference.
- [RuntimeManager](https://docs-unity.molca.id/core/runtime-manager.md): Application bootstrap, service container, and initialization gate.
- [Runtime subsystem](https://docs-unity.molca.id/core/runtime-subsystem.md): RuntimeSubsystem lifecycle, InitializationPriority, and prefab placement.
- [SequenceController](https://docs-unity.molca.id/core/sequence-controller.md): Ordered step execution, pause/resume, and step advancement.
- [Sequence Visualizer](https://docs-unity.molca.id/core/sequence-visualizer.md): Unity Editor window to inspect sequences, change step types, and open the CSV Step Importer.
- [Step (base class)](https://docs-unity.molca.id/core/step.md): Step status, completion rules, StepId, and auxiliaries.
- [DT SDK architecture](https://docs-unity.molca.id/dt/architecture.md): How the Digital Twin SDK layers on Unity and Molca Core, and key domain terms.
- [DT network and mapping](https://docs-unity.molca.id/dt/network-and-mapping.md): NetworkManager pipelines, token renewal, and JsonMapping evaluation in _MolcaDT.
- [Digital Twin SDK overview](https://docs-unity.molca.id/dt/overview.md): Scope of Assets/_MolcaDT in molca-sdk-dt and how it relates to Molca Core.
- [DT POI and panels](https://docs-unity.molca.id/dt/poi-and-panels.md): POIManager, follow targets, and panel handlers for machine detail UX.
- [DT project layout](https://docs-unity.molca.id/dt/project-layout.md): Folder map under Assets/_MolcaDT for molca-sdk-dt.
- [DT startup flow](https://docs-unity.molca.id/dt/startup-flow.md): Scene startup manager sequence for _MolcaDT and practical wiring checks.
- [Architecture](https://docs-unity.molca.id/overview/architecture.md): How Molca Core sits under Unity and how VR, Digital Twin, and Shared modules relate — product-neutral.
- [Compatibility and validation](https://docs-unity.molca.id/overview/compatibility-and-validation.md): Conventions for SDK/version compatibility, environment assumptions, and page validation cadence.
- [Introduction](https://docs-unity.molca.id/overview/introduction.md): Who this documentation is for, how Molca Core relates to product SDKs (VR, DT), and how to navigate the site.
- [SDKs and repositories](https://docs-unity.molca.id/overview/platforms.md): Which Molca Unity packages exist, where they live in source, and which doc sections apply.
- [Runtime and settings overview](https://docs-unity.molca.id/overview/runtime-and-settings.md): How Molca boots Unity at runtime: project settings, RuntimeManager, GlobalSettings modules, and VR subsystems.
- [Troubleshooting](https://docs-unity.molca.id/overview/troubleshooting.md): Hub for common issues — open the section that matches your product area.
- [Troubleshooting — Core & setup](https://docs-unity.molca.id/overview/troubleshooting-core.md): Bootstrap, DI, localization, UI shell, networking, content packages, and events.
- [Troubleshooting — Digital Twin SDK](https://docs-unity.molca.id/overview/troubleshooting-dt.md): Scope, networking, JSON mapping, and POI behavior in _MolcaDT.
- [Troubleshooting — Shared module](https://docs-unity.molca.id/overview/troubleshooting-shared.md): GameManager, media, preload, and AuthUI patterns in _MolcaSDK Code.
- [Troubleshooting — VR SDK](https://docs-unity.molca.id/overview/troubleshooting-vr.md): Scenario, session, player, steps, scoring, tour, and VR-specific flows.
- [Add scoring to VR activities](https://docs-unity.molca.id/recipes/add-vr-activity-scoring.md): Configure scoring for VR training activities with step-level scoring and session integration.
- [Create and dispatch custom events](https://docs-unity.molca.id/recipes/create-custom-events.md): Use EventDispatcher for decoupled cross-component communication.
- [Implement custom VR interactions](https://docs-unity.molca.id/recipes/implement-custom-vr-interaction.md): Create custom VR interaction components extending MolcaInteractionBase for specialized interaction behaviors.
- [Implement dependency injection in custom components](https://docs-unity.molca.id/recipes/implement-dependency-injection.md): Use [Inject] attribute to access services in custom MonoBehaviour components.
- [Integrate HTTP requests with data persistence](https://docs-unity.molca.id/recipes/integrate-http-data-persistence.md): Combine HttpClient and DataManager for API calls with local caching.
- [Load and use content packages](https://docs-unity.molca.id/recipes/load-content-packages.md): Load Addressable content packages at runtime using ContentPackageLoader.
- [Set up a basic sequence with custom steps](https://docs-unity.molca.id/recipes/setup-basic-sequence.md): Create a SequenceController with custom Step components for ordered execution.
- [Set up a VR scenario from scratch](https://docs-unity.molca.id/recipes/setup-vr-scenario.md): Create a complete VR training scenario with activities, steps, and session flow.
- [Global Settings](https://docs-unity.molca.id/setup/global-settings.md): SettingModule list loaded when RuntimeManager initializes.
- [Molca Project Settings](https://docs-unity.molca.id/setup/molca-project-settings.md): Root ScriptableObject that points at the RuntimeManager prefab and GlobalSettings.
- [New scenario quick start](https://docs-unity.molca.id/setup/new-scenario-quickstart.md): Manual checklist from SimulationScenarioData (or TourScenarioData) through scene wiring to ScenarioDataConfig and testing.
- [Scenario Data Config](https://docs-unity.molca.id/setup/scenario-data-config.md): SettingModule that registers scenario collections and resolves scenario assets.
- [Scenes and build settings](https://docs-unity.molca.id/setup/scenes-and-build-settings.md): Preload / Auth / Home flow, SharedString scene names, Quest and PC VR builds.
- [VR session flow (how-to)](https://docs-unity.molca.id/setup/vr-session-flow-how-to.md): Practical checklist for auth, session creation, scene load, and event wiring in molca-sdk-vr.
- [Auth UI](https://docs-unity.molca.id/shared/auth-ui.md): AuthUI and UserData for login screens.
- [GameManager](https://docs-unity.molca.id/shared/game-manager.md): Cross-scene subsystem for HTTP error UX and global game hooks.
- [Media system](https://docs-unity.molca.id/shared/media-system.md): MediaLoader and handlers for image, video, document, and text.
- [Shared modals](https://docs-unity.molca.id/shared/modals.md): Text, selection, progress, keyboard, and notification modals in _MolcaSDK/Code.
- [Preload checks](https://docs-unity.molca.id/shared/preload-checks.md): PreloadCheck, IPreloadCheck, FirstLaunchCheck, and VRPreloadCheck.
- [UI widgets](https://docs-unity.molca.id/shared/ui-widgets.md): Theme-aware buttons, billboard UI, progress, language, and layout helpers.
- [Utilities](https://docs-unity.molca.id/shared/utilities.md): Input, QR, proximity, transforms, toggles, and small helpers.
- [VR SDK architecture](https://docs-unity.molca.id/vr/architecture.md): VR training layers on Molca Core, scenario terminology, app flow, and session integration.
- [Base Components](https://docs-unity.molca.id/vr/base-components.md): Shared VR base scripts for interaction, teleport validation, and room-scale collision prevention.
- [Controller Visual](https://docs-unity.molca.id/vr/controller-visual.md): Hand/controller model switching, button rim highlighting, and hand animation input bridge.
- [DeviceManager](https://docs-unity.molca.id/vr/device-manager.md): Headset activation, device checks, and org content fetch for managed deployments.
- [Home UI](https://docs-unity.molca.id/vr/home-ui.md): HomeUIManager, scenario cards, modules, and leaderboard presentation.
- [Gaze Interaction Implementation](https://docs-unity.molca.id/vr/implementation/gaze-interaction.md): Complete guide to implementing gaze-based inspection or verification using LookAtStep and ProgressFeedbackUI.
- [General Interaction Patterns Implementation](https://docs-unity.molca.id/vr/implementation/general-interaction-patterns.md): Guide to combining existing steps and interactions for flexible patterns like clickable detection via GrabStep, gaze-triggered actions with XRGazeItem, and composite multi-step interactions.
- [Interactable Grab Object Implementation](https://docs-unity.molca.id/vr/implementation/interactable-object.md): Complete guide to implementing grab interactions with visual feedback using XRGrabInteractable, StepObjectHighlightAuxiliary, and StepDirectionBeltController.
- [Localization Implementation](https://docs-unity.molca.id/vr/implementation/localization-and-role-based-content.md): Guide to implementing multi-language support in VR scenarios using DynamicLocalization, ModalConfirmation, QuestionStep, and StepInfoDisplayAuxiliary.
- [Popup Modal Confirmation Implementation](https://docs-unity.molca.id/vr/implementation/popup-modal-confirmation.md): Complete guide to implementing popup modals with confirmation using PopupStep and modal UI components.
- [Question Modal Answer Implementation](https://docs-unity.molca.id/vr/implementation/question-modal-answer.md): Complete guide to implementing question modals with answer validation using QuestionStep and multiple-choice UI.
- [KnobInteraction](https://docs-unity.molca.id/vr/interactions/knob-interaction.md): Wrist-twist knob rotation with optional snap positions.
- [MolcaInteractionBase](https://docs-unity.molca.id/vr/interactions/molca-interaction-base.md): Shared VR interaction behavior for XRI grab and analog controls.
- [ValveInteraction](https://docs-unity.molca.id/vr/interactions/valve-interaction.md): Wheel-style valve rotation from hand position with limits and callbacks.
- [VR Locomotion](https://docs-unity.molca.id/vr/locomotion.md): Teleport + continuous movement setup aligned with Unity XRI template patterns.
- [ScenarioActivity](https://docs-unity.molca.id/vr/scenario-activity.md): Activity root linking SequenceController, steps, and scoring/session hooks.
- [Scenario Data](https://docs-unity.molca.id/vr/scenario-data.md): ScriptableObject asset that defines a VR training scenario's metadata, activities, and scene loading configuration.
- [ScenarioManager](https://docs-unity.molca.id/vr/scenario-manager.md): Scenario state machine, activities, pause, and session integration.
- [Scenario mode drivers](https://docs-unity.molca.id/vr/scenario-mode-drivers.md): IScenarioModeDriver, SimulationScenarioModeDriver, and TourScenarioModeDriver.
- [ScenarioNetworkConfig](https://docs-unity.molca.id/vr/scenario-network-config.md): Asset vs YAML modes and default VR API path fragments.
- [Scenario UI](https://docs-unity.molca.id/vr/scenario-ui.md): Completion screens, leaderboard rows, and in-scenario HUD.
- [ActivityScoring](https://docs-unity.molca.id/vr/scoring/activity-scoring.md): Activity-level score aggregation with its own ScoringConfig.
- [ScenarioScoring](https://docs-unity.molca.id/vr/scoring/scenario-scoring.md): Scenario-wide scoring roll-up and time-based helpers.
- [ScoringConfig](https://docs-unity.molca.id/vr/scoring/scoring-config.md): ScoringType enum and CalculateScore behavior.
- [StepScoringAuxiliary](https://docs-unity.molca.id/vr/scoring/step-scoring-auxiliary.md): Per-step scoring configuration and session posting integration.
- [VR assets and scenes](https://docs-unity.molca.id/vr/sdk-assets-and-scenes.md): How ScriptableObject scenario data, session flow scenes, scenario scenes, and tour additive scenes fit together.
- [VR content hierarchy (simulation & tour)](https://docs-unity.molca.id/vr/sdk-content-hierarchy.md): From settings modules to scenario assets; then activities and steps (simulation) or tour areas and spots (tour).
- [VR SDK overview](https://docs-unity.molca.id/vr/sdk-overview.md): What the Molca VR training SDK includes and which docs to read first.
- [Session authentication](https://docs-unity.molca.id/vr/session-authentication.md): Visitor OTP and member email/password login via ScenarioSessionManager.
- [Session loading and events](https://docs-unity.molca.id/vr/session-loading-and-events.md): CreateSession, LoadSession helpers, scene load, and UnityEvents on ScenarioSessionManager.
- [CodeInputStep](https://docs-unity.molca.id/vr/steps/code-input-step.md): Numeric or code entry step completion.
- [EnvironmentChangeStep](https://docs-unity.molca.id/vr/steps/environment-change-step.md): Triggers or waits on environment / scene variant swaps.
- [GrabStep](https://docs-unity.molca.id/vr/steps/grab-step.md): XR grab/release completion rules for XRGrabInteractable targets.
- [KnobStep](https://docs-unity.molca.id/vr/steps/knob-step.md): Completes when KnobInteraction reaches a target angle.
- [LookAtStep](https://docs-unity.molca.id/vr/steps/look-at-step.md): Gaze dwell and cone threshold toward a target transform.
- [PopUpStep](https://docs-unity.molca.id/vr/steps/popup-step.md): Gates progression on UI popup acknowledgment or completion.
- [StepBridge and SequenceBridge](https://docs-unity.molca.id/vr/steps/step-bridge.md): Cross-sequence coordination steps.
- [TeleportStep](https://docs-unity.molca.id/vr/steps/teleport-step.md): Teleport event hook (stock SDK may require a patch to call Complete).
- [ValveActionStep](https://docs-unity.molca.id/vr/steps/valve-action-step.md): Valve-oriented step variant with action-specific completion rules.
- [ValveStep](https://docs-unity.molca.id/vr/steps/valve-step.md): Completes when ValveInteraction reaches a target angle.
- [VR step auxiliaries](https://docs-unity.molca.id/vr/steps/vr-step-auxiliaries.md): StepInfo titles for Scenario UI task lists, scoring, haptics, controller hints, mode-aware events, and analog UI helpers.
- [Tour areas and spots](https://docs-unity.molca.id/vr/tour/tour-area-and-spots.md): TourAreaManager, TourSpotController, and TourProgressHelper.
- [TourSubsystem](https://docs-unity.molca.id/vr/tour/tour-subsystem.md): Additive tour areas, spot teleport, and home scene routing.
- [VRFadeManager](https://docs-unity.molca.id/vr/vr-fade-manager.md): Fullscreen fade quad for transitions and scenario completion.
- [VRInventoryManager](https://docs-unity.molca.id/vr/vr-inventory-manager.md): In-VR item storage and retrieval.
- [VRPlayerManager](https://docs-unity.molca.id/vr/vr-player-manager.md): XR Origin, locomotion providers, and controller visuals.

## OpenAPI Specs

- [openapi](https://docs-unity.molca.id/api-reference/openapi.json)