SE-VR/documents/controls.md

Here’s your revised VR controls proposal, incorporating the updates for block scrolling and other notes:

---

# **VR Controls Proposal**

This document proposes VR controls based on the Oculus Quest controller layout.

---

## **1. Seated (Ship) Controls**

- **Right Controller**
  - **Stick**: Ship Rotation
    - Up/Down: Pitch
    - Left/Right: Yaw
  - **A (lower face)**: Control Group 1
  - **B (upper face)**: Secondary Trigger Action (right click)
  - **Trigger**: Primary Trigger Action (left click)
  - **Grip**: Secondary Action Layer
    - Grip + A: Cycle Control Group Down (wraps from 0 to 9)
    - Grip + B: Cycle Control Group Up (wraps from 9 to 0)
    - Grip + Stick Left/Right: Roll
    - Grip + Stick Click: `K` Menu
  
- **Left Controller**
  - **Stick**: Analog Lateral Thrust (up, down, left, right)
    - Up: Analog Thrust Up
    - Down: Analog Thrust Down
    - Left: Analog Thrust Left
    - Right: Analog Thrust Right
  - **Y**: Parking
  - **X**: Inertial Dampeners
  - **Trigger**: Analog Forward Thrust
  - **Grip**: Secondary Action Layer
    - Grip + Trigger: Analog Reverse Thrust
    - Grip + Stick Click: `G` Menu
    - Grip + X: Grid Power
    - Grip + Y: Toggle Antenna

---

## **2. Character (Jetpack) Controls**

- **Inherits from Ship Controls with the following alterations:**

- **Right Controller**
  - **Stick**: Character Rotation
    - Up/Down: Pitch (Jetpack orientation)
    - Left/Right: Yaw (Jetpack orientation)
  - **A (lower face)**: Jetpack Thrusters Up (analog upward thrust)
  - **B (upper face)**: Jetpack Thrusters Down (analog downward thrust)
  - **Trigger**: Use tool (left click equivalent)
  - **Grip**: Secondary Action Layer
    - Grip + A: Jetpack Thrust Down
    - Grip + B: Jetpack Thrust Up
    - Grip + Stick Left/Right: Roll (Jetpack roll)
    - Grip + Stick Click: `K` Menu
    - **Grip + Trigger**: Secondary Trigger Action (right click)
  > **Note:** Grip + A/B could be repurposed for block scrolling or weapon reloads, depending on future implementation.

- **Left Controller**
  - **Stick**: Jetpack Lateral Movement (up, down, left, right)
    - Up: Jetpack Thrust Forward
    - Down: Jetpack Thrust Backward
    - Left: Jetpack Thrust Left
    - Right: Jetpack Thrust Right
  - **Y**: Toggle Jetpack Power
  - **X**: Inertial Dampeners (same as Ship)
  - **Trigger**: Forward thrust (analog)
  - **Grip**: Secondary Action Layer
    - Grip + Trigger: Reverse Thrust (analog)
    - Grip + Stick Click: `G` Menu
    - Grip + X: Jetpack Boost
    - Grip + Y: Toggle Helmet

  > **Note:** There should be a setting to swap the stick up/down and trigger/grip+trigger actions on the left controller for user preference.

## **3. Character (No Jetpack) Controls**

- **Inherits from Jetpack Controls with the following alterations:**

- **Right Controller**
  - **Position/Rotation**: Player Reticle (where your tool is pointing)
  - **Trigger**: Use tool (e.g., welding, drilling—left click equivalent)
  - **Grip**: Secondary Action Layer
    - Grip + Trigger: Secondary Trigger Action (right click equivalent for tool use)
  
- **Left Controller**
  - **Stick**: Player Movement
    - Up: Analog Forward
    - Down: Analog Backward
    - Left: Analog Strafe Left
    - Right: Analog Strafe Right
  - **Y**: Toggle Lights
  - **X**: Inertial Dampeners (same as Jetpack)
  - **Trigger**: Jump or Sprint (tap for jump, hold for sprint)