🚗 Car Racing Game (Python Midterm Project)

---

✨ Status

🚧 Completed
🧠 Built with Python 3.14.3
🎮 Uses pygame-ce
🎯 Designed for Midterm Evaluation

---

🎮 Game Overview

This is a classic car racing game built for a Python midterm project. The player controls a car, avoids obstacles, and tries to achieve the highest score possible. The game features modular code, a clean UI, and persistent high scores.

---

🔥 Features

• 🧩 Clean & Modular Code (OOP, separate modules for entities, utils, settings)
• ⚡ Optimized Performance (uses efficient game loop and asset loading)
• 🖥️ User-Friendly Interface (simple controls, clear visuals)
• 📊 High Score Tracking (CSV-based, persistent)
• 🎵 Sound & Graphics (custom assets, background music, icons)
• 📁 Well-Structured Project Architecture

---

📌 Tech Stack

• Python 3.14.3
• pygame-ce
• Git & GitHub
• VS Code

---

🗂️ Project Structure

├── Main.py
├── Game.py
├── Settings.py
├── Utils.py
├── requirements.txt
├── README.md
├── Entities/
│   ├── Car.py
│   ├── CarObstacle.py
│   └── CarPlayer.py
├── Db/
│   ├── FileLoader.py
│   ├── Paths.py
│   └── Hiscore.csv
├── Assets/
│   ├── Background/
│   │   ├── Image/
│   │   │   ├── bg_game_over.png
│   │   │   ├── bg_hiscore.png
│   │   │   └── bg_home.png
│   │   └── Sound/
│   │       ├── beep.ogg
│   │       ├── charmer.mp3
│   │       └── explosion.wav
│   ├── CarModels/
│   │   ├── bike.png
│   │   ├── bike2.png
│   │   ├── bmw.png
│   │   ├── bmw2.png
│   │   ├── bmw3.png
│   │   ├── camaro.png
│   │   ├── camaro2.png
│   │   ├── challenger2.png
│   │   ├── challenger3.png
│   │   ├── convertible.png
│   │   ├── dumptruck.png
│   │   ├── figo.png
│   │   ├── figo2.png
│   │   ├── gwagon.png
│   │   ├── gwagon2.png
│   │   ├── lambo.png
│   │   ├── lambo2.png
│   │   ├── lancer.png
│   │   ├── lancer2.png
│   │   ├── landcruiser.png
│   │   ├── landcruiser2.png
│   │   ├── landcruiser3.png
│   │   ├── lexus.png
│   │   ├── lexus2.png
│   │   ├── lexus3.png
│   │   ├── mini.png
│   │   ├── mustang2.png
│   │   ├── mustang3.png
│   │   ├── patrol.png
│   │   ├── patrol2.png
│   │   ├── pickup.png
│   │   ├── pickup2.png
│   │   ├── pickup3.png
│   │   ├── porsche.png
│   │   ├── raptor.png
│   │   ├── raptor2.png
│   │   ├── sunny.png
│   │   ├── suv.png
│   │   ├── suv2.png
│   │   ├── taxi.png
│   │   ├── taxi2.png
│   │   ├── tida.png
│   │   ├── tida2.png
│   │   ├── tida3.png
│   │   ├── tow_truck.png
│   │   ├── tow_truck2.png
│   │   ├── tow_truck3.png
│   │   ├── truck2.png
│   │   ├── truck3.png
│   │   ├── van.png
│   │   ├── van2.png
│   │   ├── van3.png
│   │   ├── wrangler.png
│   │   ├── wrangler2.png
│   │   ├── wrangler3.png
│   │   └── wrangler4.png
│   ├── Icon/
│   │   └── icon.ico
│   ├── Road/
│   │   └── road1.png
└───|

---

🚦 How to Run

1. Install Python 3.14.3 and pygame-ce
2. Clone this repository
3. pip install -r requirements.txt
4. Run Main.py:

python Main.py

---

📝 Design

The game is designed using object-oriented principles:

• Game loop: Managed in Game.py, handles events, updates, and rendering.
• Entities: Player and obstacle cars are separate classes in Entities/.
• Settings: All constants and configuration in Settings.py.
• Utils: High score management, randomization, and display helpers.
• Assets: Images and sounds are loaded dynamically from the Assets/ folder.
• Persistence: High scores are saved in a CSV file for replayability.

---

📦 Requirements

• Python 3.14.3
• pygame-ce

Install dependencies:

Python 3.x (x>10)
pip install pygame-ce

---

🙏 Credits

Developed by iammrranik for a Python midterm project.