Release 0.3.8 clutch tuning fix

Clarify the advanced clutch shift controls after tester feedback: clutch bite, clean shift, missed clutch, and the new clutch unload percentage.

Persist and clamp clutch_body_cut in the typed Forza shift tuning config, use it in drivetrain body rumble, and add regression coverage for the rumble reduction path.

Bump package metadata and release notes to 0.3.8.

Author: shiftedx

CHANGELOG.md

@@ -1,3 +1,50 @@
+# DualSense Command Center 0.3.8
+
+Release date: 2026-06-01
+
+0.3.8 is a clutch-tuning fix release. It keeps the 0.3.7 shift behavior, but
+makes the advanced controls easier to understand and easier to edit.
+
+## Clutch Control Fixes
+
+- `Clutch at %` is now `Clutch bite %`, which means the clutch press threshold.
+- `With clutch` is now `Clean shift`.
+- `No clutch` is now `Missed clutch`.
+- New `Clutch unload %` control adjusts how much DSCC-generated drivetrain body
+  rumble drops while the clutch is pressed.
+- Number fields select their current value on focus, so users can type a new
+  value without fighting the existing digit.
+
+## Runtime Safety
+
+- The clutch unload value is stored in the typed Forza shift tuning config.
+- Saved 0.3.7 profiles load safely with the new default value.
+- The backend clamps the new setting before use.
+- A regression test now proves the clutch unload setting changes drivetrain body
+  rumble.
+
+## Thanks
+
+- Thanks to **ゾアン・ファンイ** for testing the clutch build quickly and pointing out
+  where the labels and number fields were getting in the way.
+
+## Validation Gate
+
+This release passed:
+
+```powershell
+cargo +stable-x86_64-pc-windows-gnu fmt --all -- --check
+cargo +stable-x86_64-pc-windows-gnu test -p dscc-agent
+cargo +stable-x86_64-pc-windows-gnu clippy -p dscc-agent --all-targets --target x86_64-pc-windows-gnu -- -D warnings
+npm.cmd --prefix web run typecheck
+npm.cmd --prefix web run build
+npm.cmd --prefix web run test:haptics-graph
+npm.cmd --prefix web run test:button-map
+npm.cmd --prefix web run test:release-size
+npm.cmd --prefix web run test:source-audit
+npm.cmd --prefix web run test:visual-smoke
+```
+
 # DualSense Command Center 0.3.7
 
 Release date: 2026-06-01

Cargo.lock

@@ -21,7 +21,7 @@ lightbar controls, and racing telemetry without Python setup or scripts.
 
 Get the latest Windows installer from [GitHub Releases](https://github.com/shiftedx/dualsense-command/releases/latest).
 
-- Current release: `0.3.7`
+- Current release: `0.3.8`
 - Recommended download: **DSCC Standard** Windows x86_64 MSI
 - Linux builds: beta archive with bundled web UI
 

README.md

@@ -1,6 +1,6 @@
 [package]
 name = "dscc-adapters"
-version = "0.3.7"
+version = "0.3.8"
 edition.workspace = true
 license.workspace = true
 rust-version.workspace = true

crates/dscc-adapters/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "dscc-agent"
-version = "0.3.7"
+version = "0.3.8"
 edition.workspace = true
 license.workspace = true
 rust-version.workspace = true

crates/dscc-agent/Cargo.toml

@@ -656,6 +656,8 @@ pub struct ForzaShiftTuningConfig {
     pub with_clutch_duration_ms: f64,
     #[serde(default = "default_forza_shift_without_clutch_duration_ms")]
     pub without_clutch_duration_ms: f64,
+    #[serde(default = "default_forza_shift_clutch_body_cut")]
+    pub clutch_body_cut: f64,
 }
 
 #[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]

crates/dscc-agent/src/agent_types.rs

@@ -573,6 +573,7 @@ impl Default for ForzaShiftTuningConfig {
             without_clutch_strength: default_forza_shift_without_clutch_strength(),
             with_clutch_duration_ms: default_forza_shift_with_clutch_duration_ms(),
             without_clutch_duration_ms: default_forza_shift_without_clutch_duration_ms(),
+            clutch_body_cut: default_forza_shift_clutch_body_cut(),
         }
     }
 }
@@ -635,6 +636,12 @@ impl ForzaShiftTuningConfig {
             500.0,
             default_forza_shift_without_clutch_duration_ms(),
         );
+        self.clutch_body_cut = finite_clamp(
+            self.clutch_body_cut,
+            0.0,
+            1.0,
+            default_forza_shift_clutch_body_cut(),
+        );
         self
     }
 }
@@ -683,6 +690,10 @@ pub(crate) fn default_forza_shift_without_clutch_duration_ms() -> f64 {
     FORZA_SHIFT_WITHOUT_CLUTCH_DURATION_MS
 }
 
+pub(crate) fn default_forza_shift_clutch_body_cut() -> f64 {
+    FORZA_SHIFT_CLUTCH_BODY_CUT
+}
+
 pub(crate) fn normalize_forza_shift_clutch_mode(mode: &str) -> &'static str {
     match mode {
         "off" => "off",

crates/dscc-agent/src/config_model.rs

@@ -131,7 +131,7 @@ pub(crate) fn forza_rumble_output(
     } else {
         0.0
     };
-    let clutch_uncouple = 1.0 - clutch * 0.78;
+    let clutch_uncouple = 1.0 - clutch * shift_tuning.clutch_body_cut;
     let drivetrain = (rpm * rpm * (0.35 + throttle * 0.65) * clutch_uncouple).clamp(0.0, 1.0);
 
     let mut low = 0.0;

crates/dscc-agent/src/effects/output_enhancements.rs

@@ -88,5 +88,6 @@ pub(crate) const FORZA_SHIFT_WITH_CLUTCH_STRENGTH: f64 = 0.58;
 pub(crate) const FORZA_SHIFT_WITHOUT_CLUTCH_STRENGTH: f64 = 1.0;
 pub(crate) const FORZA_SHIFT_WITH_CLUTCH_DURATION_MS: f64 = 130.0;
 pub(crate) const FORZA_SHIFT_WITHOUT_CLUTCH_DURATION_MS: f64 = 240.0;
+pub(crate) const FORZA_SHIFT_CLUTCH_BODY_CUT: f64 = 0.78;
 pub(crate) const FORZA_SUSPENSION_IMPACT_TRIGGER_AT: f64 = 0.42;
 pub(crate) const FORZA_SUSPENSION_IMPACT_RESET_AT: f64 = 0.22;

crates/dscc-agent/src/runtime_constants.rs

@@ -173,6 +173,64 @@ fn forza_surface_rumble_is_suppressed_while_stationary() {
     assert!(rumble.high_frequency > 0.25);
 }
 
+#[test]
+fn forza_clutch_body_cut_controls_drivetrain_rumble() {
+    let mut forza = ForzaTelemetryConfig::default().normalized();
+    forza.body_rumble_mode = "dscc_full_control".to_string();
+    for effect in &mut forza.effects {
+        effect.enabled = false;
+    }
+    let throttle = forza
+        .effects
+        .iter_mut()
+        .find(|effect| effect.id == "throttle_resistance")
+        .expect("default throttle tuning exists");
+    throttle.enabled = true;
+    throttle.intensity = 100;
+    throttle.route = "body_both".to_string();
+
+    let snapshot = |clutch| {
+        SignalSnapshot::from_updates([
+            signal_update("input.throttle", 1.0),
+            signal_update("input.brake", 0.0),
+            signal_update("input.clutch", clutch),
+            signal_update("input.handbrake", 0.0),
+            signal_update("vehicle.rpm_ratio", 0.9),
+            signal_update("vehicle.speed_kmh", 96.0),
+            signal_update("wheel.slip.max", 0.0),
+            signal_update("wheel.slip.front_max", 0.0),
+            signal_update("wheel.slip.rear_max", 0.0),
+            signal_update("surface.rumble.max", 0.0),
+            signal_update("surface.rumble_strip.max", 0.0),
+            signal_update("surface.puddle.max", 0.0),
+            signal_update("suspension.travel.max", 0.0),
+            signal_update("vehicle.acceleration.magnitude", 0.0),
+            signal_update("drivetrain.shift_pulse", 0.0),
+        ])
+    };
+
+    let coupled =
+        forza_rumble_output(&forza, &snapshot(0.0), 1.0, "Balanced").expect("throttle rumble");
+    let uncoupled =
+        forza_rumble_output(&forza, &snapshot(1.0), 1.0, "Balanced").expect("reduced rumble");
+    assert!(
+        uncoupled.low_frequency < coupled.low_frequency * 0.35,
+        "default clutch body cut should reduce drivetrain rumble, got {} from {}",
+        uncoupled.low_frequency,
+        coupled.low_frequency
+    );
+
+    forza.shift.clutch_body_cut = 0.0;
+    let no_cut =
+        forza_rumble_output(&forza, &snapshot(1.0), 1.0, "Balanced").expect("no-cut rumble");
+    assert!(
+        (no_cut.low_frequency - coupled.low_frequency).abs() < 0.001,
+        "0% clutch unload should preserve drivetrain rumble, got {} from {}",
+        no_cut.low_frequency,
+        coupled.low_frequency
+    );
+}
+
 #[test]
 fn forza_suspension_impact_latches_landing_body_thump() {
     let mut runtime = test_forza_effect_runtime();