Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎮 Game Hub – Python Mini Project

A clean, modular, and interactive console-based gaming application built in Python. This project combines simplicity with thoughtful design by offering multiple games, persistent scoring, and a structured architecture—making it ideal for academic evaluation and practical learning.


🚀 Features

Multiple Games in One Hub

  • ✊ Stone – Paper – Scissors
  • 🎲 Dice Roll Game

🧠 Smart Game Design

  • Best of 3 rounds system
  • Randomized gameplay using Python’s random module
  • Clear win/lose/draw logic

📊 Score Tracking System

  • Tracks wins, losses, and draws
  • Displays real-time score after gameplay

💾 Persistent Storage

  • Saves scores to a file (score.txt)
  • Automatically loads previous progress

📜 Game History

  • Stores and displays all played rounds
  • Helps visualize performance over time

🎨 Improved User Experience

  • Clean terminal UI with headers and formatting
  • Shortcut inputs (e.g., s for stone)
  • Menu-driven navigation

🔁 Replay System

  • Play multiple rounds seamlessly without restarting

📁 Project Structure

game_hub/
│
├── main.py            # Entry point (menu + flow control)
├── sps_game.py        # Stone-Paper-Scissors logic
├── dice_game.py       # Dice game logic
├── utils.py           # UI helpers & input handling
├── score_manager.py   # Score tracking & file handling
└── history.py         # Game history tracking

▶️ How to Run

  1. Clone or download the project
  2. Open terminal in the project folder
  3. Run the program:
python main.py

🧠 Concepts Used

  • Functions and modular programming
  • File handling (read/write)
  • Random number generation
  • Loops and conditionals
  • Data structures (lists, dictionaries)
  • Separation of concerns (clean architecture)

🎯 Why This Project Stands Out

This project goes beyond basic requirements by focusing on:

  • Modular design (multiple files for scalability)
  • User experience (interactive UI + smooth flow)
  • Persistent data (score saving system)
  • Extensibility (easy to add new games/features)

It demonstrates not just coding ability, but also software design thinking.


🔮 Future Enhancements

  • GUI version using Tkinter
  • Leaderboard system
  • Multiplayer mode
  • Sound effects for gameplay
  • Additional mini-games

📌 Project Description (Short)

A modular Python-based game hub featuring Stone-Paper-Scissors and Dice games, with score tracking, persistent storage, and interactive gameplay through a menu-driven interface.


👨‍💻 Author

Harjot Singh B.Tech – Artificial Intelligence & Data Science


⭐ Final Note

This project reflects a balance between simplicity and thoughtful engineering—turning a basic assignment into a structured and engaging application.


About

A modular Python game hub featuring Stone-Paper-Scissors and Dice Roll games. Includes score tracking, best-of-3 gameplay, game history, and file-based persistence. Built with clean functions and a menu-driven interface for an interactive and structured user experience.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages