RhythmBall3D

(Rhythm Ball 3D) is a 3D perspective music rhythm runner game. Players control a colorful ball navigating a track in depth, dodging or matching oncoming obstacles in sync with the music.

### Core Mechanics

1. **Color Matching**: Your ball has four possible colors (Red, Yellow, Blue, Purple), and obstacles share the same color scheme. You must **match the obstacle's color** to pass through it and score points. A color mismatch results in an immediate game over.

2. **Rhythm Sync**: Obstacles are generated in precise sync with the music's beat. As the background music plays, obstacles rush toward the player from afar.

3. **3D Perspective**: The game simulates a 3D depth effect — obstacles gradually scale up as they approach, creating a strong sense of speed and spatial immersion.

### Controls

- **Touch & Drag**: Swipe left or right on the screen to move the ball horizontally.

- **Movement Range**: The ball can move approximately ±200 units laterally on the track.

### Game Flow

1. **Start Screen**: Tap the "Start" button to enter the game.

2. **Song Selection**: Choose from multiple songs, each with its own unique rhythm chart and beatmap.

3. **Gameplay**: Control your ball to match/dodge obstacles, collect coins, and aim for the highest score.

4. **Result Screen**: View your final score, collected coins, and star rating.

### Scoring & Rating

| Item | Description |

|------|-------------|

| **Combo Score** | Each successful obstacle match increases your combo counter. Higher combos yield more points per match (max 20 combo). |

| **Coins** | Collect coin items on the track to increase your coin count. |

| **Star Rating** | Based on song completion progress: 1 star at 30%, 2 stars at 60%, 3 stars at 95%. |

| **Encouragement** | Every 5 combos triggers a "Great" or "Nice" visual feedback. |

### Obstacle Types

| Type | Color(s) | Description |

|------|----------|-------------|

| **Static Obstacle** | Red / Yellow / Blue / Purple | Stationary color barrier — match the color to pass. |

| **Moving Obstacle** | Red / Yellow / Blue / Purple | Horizontally moving barriers that require prediction. |

| **Color Platform** | Red / Yellow / Blue / Purple | Changes your ball's color when touched — use them strategically to prepare for upcoming obstacles. |

| **Coin** | Gold | Collect to increase your coin counter. |

| **Finish Line** | — | Reaching it triggers a victory. |

### Win Condition

- Successfully reach the end of the song track to trigger a victory result.

### Lose Condition

- If your ball's color does not match the obstacle's color, the game ends immediately.

### Tips

- Use color platforms strategically to switch your ball's color in preparation for upcoming obstacles.

- Pay attention to the movement patterns of moving obstacles and predict their direction in advance.

- Maintaining your combo streak significantly boosts your final score.

---

*Last updated: July 2026*