From a60338bf1e18b9066f006d88257d4ef08b44291b Mon Sep 17 00:00:00 2001
From: Nicola Papale <nico@nicopap.ch>
Date: Sun, 2 Jul 2023 16:24:44 +0200
Subject: [PATCH] 0.11 Section: Gamepad Rumble Support

Part of #657
---
 content/news/2023-07-07-bevy-0.11/index.md | 43 ++++++++++++++++++----
 1 file changed, 36 insertions(+), 7 deletions(-)

diff --git a/content/news/2023-07-07-bevy-0.11/index.md b/content/news/2023-07-07-bevy-0.11/index.md
index 3d0bc99389..90456d8a26 100644
--- a/content/news/2023-07-07-bevy-0.11/index.md
+++ b/content/news/2023-07-07-bevy-0.11/index.md
@@ -15,13 +15,42 @@ Since our last release a few months ago we've added a _ton_ of new features, bug
 
 <!-- more -->
 
-* **Feature**: description
-
-## Feature
-
-<div class="release-feature-authors">authors: @todo</div>
-
-Description
+* **Gamepad Rumble API**: an ECS-friendly way of making controllers rumble
+
+## Gamepad Rumble API
+
+<div class="release-feature-authors">authors: @johanhelsing, @nicopap</div>
+
+You can now use the `EventWriter<GamepadRumbleRequest>` system parameter to
+trigger controllers force-feedback motors.
+
+[`gilrs`], the crate bevy uses for gamepad support, allows controlling
+force-feedback motors. Sadly, there were no easy way of accessing the
+force-feedback API in bevy without tedious bookkeeping.
+
+Now bevy has the `GamepadRumbleRequest` event to do just that.
+
+```rust
+fn rumble_system(
+    gamepads: Res<Gamepads>,
+    mut rumble_requests: EventWriter<GamepadRumbleRequest>,
+) {
+    for gamepad in gamepads.iter() {
+        rumble_requests.send(GamepadRumbleRequest::Add {
+            gamepad,
+            duration: Duration::from_secs(5),
+            intensity: GamepadRumbleIntensity::MAX,
+        });
+    }
+}
+```
+
+The `GamepadRumbleRequest::Add` event triggers a force-feedback motor,
+controlling how long the vibration should last, the motor to activate,
+and the vibration strength. `GamepadRumbleRequest::Stop` immediately stops all
+motors.
+
+[`gilrs`]: https://crates.io/crates/gilrs
 
 ## <a name="what-s-next"></a>What's Next?