FallingWordsPygameZero

A fast typing game built with Pygame Zero where random words fall from the top of the screen. Type the leading letter of a word to chip it away before it reaches the bottom.

Features

• Falling word gameplay with increasing difficulty
• Level progression every 10 completed words
• Score tracking with bonus points per level
• Mistake and accuracy counters
• Instant round reset if any word reaches the bottom
• Colorful text rendering and simple arcade loop

Gameplay Rules

• Words spawn at random x positions and fall downward.
• Press a key to match the first character of a falling word.
• The game prioritizes words that are lower on the screen first.
• Each correct key removes one character from the matched word.
• Completing a word gives 5 * current_level points.
• Incorrect keys reduce points by 1 and increase mistakes.
• Every 10 completed words increases the level by 1.
• If any word exits the bottom of the screen, the round resets:
  • Points, level, word count, correct count, and mistakes return to zero/initial values.
  • Active words are cleared.

Tech Stack

• Python
• Pygame Zero
• Faker

Requirements

• Python 3.10+ recommended

Dependencies are listed in requirements.txt:

• pgzero
• Faker

Setup

1. Clone this repository.
2. (Optional) Create and activate a virtual environment.
3. Install dependencies:

pip install -r requirements.txt

Run the Game

From the project folder:

python main.py

Controls

• Keyboard letters: type the next character of a word

Project Structure

.
|-- main.py
|-- requirements.txt
|-- README.md
`-- LICENSE

Possible Improvements

• Add a start screen and game-over screen
• Persist best score to a local file
• Add sound effects and background music
• Spawn curated word lists by difficulty/theme
• Add pause/resume and restart hotkeys