# AlphaNumericGuess

**Repository Path**: sabbir/alpha-numeric-guess

## Basic Information

- **Project Name**: AlphaNumericGuess
- **Description**: AlphaNumeric Guess is a logic-based puzzle game where players try to uncover a hidden code made of letters and numbers. 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AlphaNumeric Guess

## Overview

AlphaNumeric Guess is an interactive desktop game developed in Python using Tkinter. The game combines number and alphabet guessing challenges designed to improve logical thinking, prediction skills, and decision-making. Players can choose between Number Guessing Mode and Alphabet Guessing Mode, customize ranges, and progress through increasingly challenging levels.

## Features

### Number Guessing Mode

* Multiple difficulty levels
* Automatic level progression
* Custom number range selection
* Limited attempts per level
* Real-time feedback for each guess
* Score and progress tracking

### Alphabet Guessing Mode

* Random alphabet generation
* Custom alphabet range support
* Instant feedback system
* Simple and engaging gameplay

### Additional Features

* Modern graphical user interface built with Tkinter
* Reset Game option
* Restart Game option
* Keyboard support (Enter key submission)
* Dynamic game messages and feedback
* Beginner-friendly design

## Technologies Used

* Python 3
* Tkinter (GUI Development)
* Random Module
* Object-Oriented and Event-Driven Programming Concepts

## How to Play

### Number Guessing Mode

1. Select Number Guessing Mode.
2. Choose the default range or enter a custom range.
3. Guess the hidden number.
4. Use the feedback to adjust your next guess.
5. Complete levels to unlock higher difficulty stages.

### Alphabet Guessing Mode

1. Select Alphabet Guessing Mode.
2. Choose the alphabet range.
3. Guess the hidden letter.
4. Continue until the correct letter is found.

## Installation

Clone the repository:

```bash
git clone https://gitee.com/sabbir/alpha-numeric-guess.git
```

Navigate to the project directory:

```bash
cd AlphaNumericGuess
```

Run the application:

```bash
python AlphaNumericGuess.py
```

## Project Structure

```text
AlphaNumericGuess/
│
├── AlphaNumericGuess.py
└── README.md
```

## Learning Objectives

This project demonstrates:

* Python programming fundamentals
* GUI development with Tkinter
* Event-driven programming
* User input handling
* Game logic implementation
* Software design and problem-solving

## Future Improvements

* Save high scores
* Leaderboard system
* Sound effects
* Achievement badges
* Additional game modes
* Enhanced visual themes

## Author

**Md Mahamudul Hasan Sabbir**
Software Engineering Student
China University of Petroleum (East China)

## License

This project is intended for educational and learning purposes.