https://github.com/isjn-227/gesture_controlled_runner
Gesture-Controlled Runner is a Unity-based endless runner game that utilizes hand gesture recognition for player control. Inspired by the classic Temple Run, this project demonstrates how to integrate gesture tracking into Unity games. It leverages Python scripts for gesture detection and Unity for game development.
https://github.com/isjn-227/gesture_controlled_runner
3d-game game-development mediapipe opencv runner-game temple-run-clone unity
Last synced: 3 months ago
JSON representation
Gesture-Controlled Runner is a Unity-based endless runner game that utilizes hand gesture recognition for player control. Inspired by the classic Temple Run, this project demonstrates how to integrate gesture tracking into Unity games. It leverages Python scripts for gesture detection and Unity for game development.
- Host: GitHub
- URL: https://github.com/isjn-227/gesture_controlled_runner
- Owner: IsJn-227
- License: mit
- Created: 2025-06-04T04:09:44.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-04T10:27:52.000Z (about 1 year ago)
- Last Synced: 2025-06-13T11:51:09.960Z (about 1 year ago)
- Topics: 3d-game, game-development, mediapipe, opencv, runner-game, temple-run-clone, unity
- Language: C#
- Homepage:
- Size: 46.6 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🏃♀️ Unity Runner Game with Gesture Controls
This project is a modified version of a Unity endless runner game (originally by Ankush1122 (https://github.com/Ankush1122/Run)), now controlled using hand gestures via webcam.
## ✨ What's New
- 🎮 Control your character using hand gestures!
- ✋ Swipe hand left/right → Change lanes
- ✋ Raise hand up → Jump
- 🔍 Real-time detection using:
- `MediaPipe`
- `OpenCV`
- `pyautogui` (to simulate keypresses sent to Unity)
## 🛠 Setup Instructions
### 1. Clone the repo
```bash
git clone https://github.com/your-username/gesture-runner-game.git
cd gesture-runner-game
```
### 2. Install Python dependencies
```bash
pip install -r requirements.txt
```
### 3. Run the gesture detection script
```bash
python gesture_control.py
```
### 4. Open the Unity project
- Open Unity Hub → Add the cloned folder
- Use the Unity version mentioned in `ProjectSettings/ProjectVersion.txt`
- Let Unity import all assets
- Open the main scene (e.g., `SampleScene`)
### 5. Play the game
- Click the ▶️ **Play** button in Unity
- Make sure the Python script is running and your webcam is on
- Use gestures to control the game:
- ✋ Swipe left/right → Change lanes
- ✋ Raise hand up → Jump