Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-unity.molca.id/llms.txt

Use this file to discover all available pages before exploring further.

Folder: Assets/_MolcaSDK/_VR/Scripts/Base/ This page covers the common base-layer scripts used by VR scenes:
  • MolcaInteractionBase.cs
  • TeleportValidator.cs
  • PlayerCollisionPrevention.cs

​
MolcaInteractionBase

File: Assets/_MolcaSDK/_VR/Scripts/Base/MolcaInteractionBase.cs
Namespace: MolcaSDK.VR Abstract interaction foundation for XR interactables. It:
  • auto-binds XRBaseInteractable on the same GameObject (or uses assigned one),
  • tracks selectEntered / selectExited,
  • exposes UpdateInteraction() for derived classes,
  • supports optional distance-based force release (maxInteractionDistance),
  • registers itself to the reference system after RuntimeManager initialization.
This is the base class behind documented interaction scripts such as valve and knob handlers.

​
TeleportValidator

File: Assets/_MolcaSDK/_VR/Scripts/Base/TeleportValidator.cs
Requires: XRRayInteractor TeleportValidator gates teleport validity while teleport mode is active:
  • applies a configured interactionMask to the ray interactor,
  • listens to active-ray changes via OnRayInteractorChanged(IXRRayProvider),
  • checks if controller is colliding near a blocked surface (CheckSphere),
  • checks for obstruction between controller and player head (SphereCast),
  • disables raycast mask (0) when invalid to prevent teleport.

​
Inspector notes

  • Wire OnRayInteractorChanged from your controller input manager event.
  • Set interactionMask to geometry that should block invalid teleport traces.
  • Tune controllerCollisionRadius conservatively (default 0.05).

​
PlayerCollisionPrevention

File: Assets/_MolcaSDK/_VR/Scripts/Base/PlayerCollisionPrevention.cs
Requires: CharacterController Helps prevent room-scale clipping into walls/props by checking overlap around the HMD position and nudging the XR origin away from collisions on XZ.

​
Inspector notes

  • Attach to XR Origin root.
  • Set interactionLayer to obstacle layers (walls, furniture, props).
  • Tune playerCollisionRadius based on headset/body clearance.

​
Code

Example derived interaction from MolcaInteractionBase: 
using MolcaSDK.VR;
using UnityEngine;

public class CustomDialInteraction : MolcaInteractionBase
{
    protected override void UpdateInteraction()
    {
        // Custom per-frame interaction logic while selected.
    }
}

​
Troubleshooting

  • Derived interaction never updates - Ensure the object has a valid XRBaseInteractable and is actually selected.
  • Unexpected force release - maxInteractionDistance may be too small; set to 0 to disable distance checks.
  • Teleport still allowed in blocked pose - verify OnRayInteractorChanged wiring and interactionMask layers.
  • Player jitter near obstacles - lower playerCollisionRadius and confirm obstacle colliders are clean (no noisy overlaps).