Skip to content

garysa/circle-catch-game

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Circle Catch Game

A simple and fun pygame-based game where you try to catch moving circles with your mouse cursor.

Description

Circle Catch is an interactive game where a colored circle appears on the screen at random positions. When you hover your mouse over the circle, it jumps to a new random position, changes color, and plays a sound effect. The game keeps track of how many circles you've successfully caught!

Features

  • Random circle positioning
  • Random color generation for each catch
  • Sound effects (can be disabled with -nosound flag)
  • Resizable game window
  • Score counter
  • Smooth 60 FPS gameplay

Requirements

  • Python 3.x
  • pygame
  • numpy

Installation

  1. Clone this repository:
git clone <repository-url>
cd game
  1. Install the required dependencies:
pip install -r requirements.txt

Quick Start

The easiest way to run the game is using the provided bash script:

./start_game.sh

This script will automatically check for dependencies, install any missing packages, and launch the game.

Usage

Using the Launcher Script (Recommended)

Run the game with the bash script:

./start_game.sh           # Start with sound
./start_game.sh -nosound  # Start without sound

The script will:

  • Check if Python 3 is installed
  • Verify all dependencies (pygame, numpy)
  • Automatically install missing dependencies
  • Launch the game

Manual Launch

You can also run the game directly with Python:

python circle_game.py

Command Line Options

  • -nosound: Disable sound effects
    python circle_game.py -nosound

Controls

  • Mouse: Move your cursor over the circle to catch it
  • Q Key: Quit the game
  • Window Close Button: Exit the game

How to Play

  1. Launch the game
  2. Move your mouse cursor over the red circle
  3. When you touch it, the circle will move to a new random position and change color
  4. Try to catch it as many times as you can!
  5. Your score is displayed in the top-right corner

License

This project is open source and available under the MIT License.

About

A simple and fun pygame-based game where you catch moving circles with your mouse

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors