From 0e7bc2de18022e1565d8924e4190bc6b77bba3cb Mon Sep 17 00:00:00 2001
From: merith-tk <merith@merith.xyz>
Date: Sat, 19 Oct 2024 10:55:29 -0700
Subject: [PATCH] update more controls to better utilize a few things

---
 documents/controls.md | 49 +++++++++++++++++++++++++++++--------------
 1 file changed, 33 insertions(+), 16 deletions(-)

diff --git a/documents/controls.md b/documents/controls.md
index 2678263..e4717e4 100644
--- a/documents/controls.md
+++ b/documents/controls.md
@@ -1,6 +1,15 @@
-Here is a proposal for controller layout (using quest controllers as base since they can usually be readjusted to most controllers easily)
+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**
 
-### **1. Seated (Ship) Controls**
 - **Right Controller**
   - **Stick**: Ship Rotation
     - Up/Down: Pitch
@@ -9,10 +18,11 @@ Here is a proposal for controller layout (using quest controllers as base since
   - **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 1 to 9)
-    - Grip + B: Cycle Control Group Up (wraps from 9 to 1)
+    - 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
@@ -28,7 +38,10 @@ Here is a proposal for controller layout (using quest controllers as base since
     - Grip + X: Grid Power
     - Grip + Y: Toggle Antenna
 
-### **2. Character (Jetpack) Controls**
+---
+
+## **2. Character (Jetpack) Controls**
+
 - **Inherits from Ship Controls with the following alterations:**
 
 - **Right Controller**
@@ -39,11 +52,13 @@ Here is a proposal for controller layout (using quest controllers as base since
   - **B (upper face)**: Jetpack Thrusters Down (analog downward thrust)
   - **Trigger**: Use tool (left click equivalent)
   - **Grip**: Secondary Action Layer
-    - Grip + A: Increase Jetpack Thrust
-    - Grip + B: Decrease Jetpack Thrust
+    - Grip + A: Jetpack Thrust Down
+    - Grip + B: Jetpack Thrust Up
     - Grip + Stick Left/Right: Roll (Jetpack roll)
-    - Grip + Stick Click: `K` Menu (same as Ship)
-  
+    - 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
@@ -52,23 +67,25 @@ Here is a proposal for controller layout (using quest controllers as base since
     - Right: Jetpack Thrust Right
   - **Y**: Toggle Jetpack Power
   - **X**: Inertial Dampeners (same as Ship)
-  - **Trigger**: Forward thrust (same as Ship, use for analog Jetpack forward thrust)
+  - **Trigger**: Forward thrust (analog)
   - **Grip**: Secondary Action Layer
-    - Grip + Trigger: Reverse Thrust (same as Ship)
+    - Grip + Trigger: Reverse Thrust (analog)
     - Grip + Stick Click: `G` Menu
     - Grip + X: Jetpack Boost
     - Grip + Y: Toggle Helmet
 
-### **3. Character (No Jetpack) Controls**
+  > **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 tool action (right-click equivalent)
-    - Grip + Stick Click: Interact (`F` equivalent)
-
+    - Grip + Trigger: Secondary Trigger Action (right click equivalent for tool use)
+  
 - **Left Controller**
   - **Stick**: Player Movement
     - Up: Analog Forward
@@ -77,4 +94,4 @@ Here is a proposal for controller layout (using quest controllers as base since
     - Right: Analog Strafe Right
   - **Y**: Toggle Lights
   - **X**: Inertial Dampeners (same as Jetpack)
-  - **Trigger**: Jump or Sprint (tap for jump, hold for sprint)
\ No newline at end of file
+  - **Trigger**: Jump or Sprint (tap for jump, hold for sprint)