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