https://github.com/rakshan0004/cipherguess
CipherGuess is a simple word guessing game built with Spring Boot and Thymeleaf. Players try to guess a randomly selected word by submitting one letter at a time, with a limited number of tries. The game provides feedback on correct and incorrect guesses, and allows players to restart once the game ends.
https://github.com/rakshan0004/cipherguess
springboot3 thymeleaf
Last synced: about 1 year ago
JSON representation
CipherGuess is a simple word guessing game built with Spring Boot and Thymeleaf. Players try to guess a randomly selected word by submitting one letter at a time, with a limited number of tries. The game provides feedback on correct and incorrect guesses, and allows players to restart once the game ends.
- Host: GitHub
- URL: https://github.com/rakshan0004/cipherguess
- Owner: Rakshan0004
- Created: 2025-01-22T11:35:28.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-26T15:22:40.000Z (about 1 year ago)
- Last Synced: 2025-01-30T11:14:54.120Z (about 1 year ago)
- Topics: springboot3, thymeleaf
- Language: Java
- Homepage:
- Size: 22.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# CipherGuess - Word Guessing Game
**CipherGuess** is a word guessing game where players need to guess a randomly chosen word by guessing one letter at a time. The game provides a limited number of chances to make guesses, and it displays the word with underscores for unguessed characters. When all characters are guessed correctly or when all tries are exhausted, the game ends.
---
## Features
- Random word selection from a predefined list.
- Users can guess one letter at a time.
- The game shows the word with blanks for unguessed letters.
- Tracks and displays the number of remaining tries.
- Displays success and failure messages.
- Option to restart the game after completion.
---
## Technologies Used
- **Spring Boot** - Backend framework for handling game logic and requests.
- **Thymeleaf** - Template engine to render dynamic HTML views.
- **Java** - Programming language for the backend.
- **HTML/CSS** - Frontend technologies for game interface.
- **JavaScript** - Client-side interactivity (optional for further enhancements).
---
## Getting Started
Follow these instructions to get a copy of the project up and running on your local machine.
### Prerequisites
- **JDK 17+** - Java Development Kit
- **Maven** - For project build and dependencies
- **Spring Boot** - For the application framework
- **Git** - For version control
### Installation
1. **Clone the repository**:
```bash
git clone https://github.com/yourusername/CipherGuess.git
Navigate to the project directory:
bash
Copy
Edit
cd CipherGuess
Build the project using Maven:
bash
Copy
Edit
mvn clean install
Run the application:
bash
Copy
Edit
mvn spring-boot:run
The application should now be running on http://localhost:8080.
Usage
Visit the home page at http://localhost:8080/game-home.
Enter a single letter guess and click Try.
If you guess correctly, the word will be revealed. If not, the number of remaining tries decreases.
Once all tries are used or the word is guessed, the option to Restart the Game will be displayed.
Click the Restart Game button to play again.
File Structure
arduino
Copy
Edit
CipherGuess/
│
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ ├── com/
│ │ │ │ └── rakshan/
│ │ │ │ └── CipherGuess/
│ │ │ │ ├── controllers/
│ │ │ │ ├── services/
│ │ │ │ ├── utils/
│ │ ├── resources/
│ │ │ ├── templates/
│ │ │ │ └── game-home-page.html
│ │ │ ├── static/
│ │ │ │ └── css/
│ │ │ │ └── style.css
│ ├── application.properties
├── README.md
Contributing
Feel free to fork the repository and submit pull requests for bug fixes, improvements, or new features.
Steps for contributing:
Fork the repository
Create a new branch (git checkout -b feature-branch)
Commit your changes (git commit -m 'Add new feature')
Push to your branch (git push origin feature-branch)
Open a pull request
License
This project is licensed under the MIT License - see the LICENSE file for details.