An open API service indexing awesome lists of open source software.

https://github.com/haimanm3/endless-runner-game

Java is required on your computer to run the .jar file. Have fun!
https://github.com/haimanm3/endless-runner-game

agile java javarequired scrum

Last synced: 17 days ago
JSON representation

Java is required on your computer to run the .jar file. Have fun!

Awesome Lists containing this project

README

        

# ๐Ÿ•น๏ธ Endless Runner Game - Tweety Bird

A Java-based endless runner game developed as a Software Engineering Capstone project at Rhode Island College (RIC). Built in a team of four using Agile and Scrum methodologies, the game features dynamic obstacle generation, menu navigation, pause/resume functionality, and a score tracking system.

๐ŸŽ“ **Featured at the RIC Software Engineering Showcase**

> ๐Ÿ›  Java is required on your computer to run the included `.jar` file.

![Built With Java](https://img.shields.io/badge/Built%20With-Java-red)
![Status](https://img.shields.io/badge/Playable-Yes-success)
![Responsive](https://img.shields.io/badge/Cross--Platform-Yes-blue)

## ๐Ÿš€ Features

- ๐ŸŽฎ **Endless Runner Gameplay** โ€“ Randomized obstacles and infinite dynamic background scrolling
- ๐Ÿง  **Basic AI Logic** โ€“ Dynamic difficulty progression based on score
- โธ๏ธ **Pause & Resume** โ€“ Real-time game state control
- ๐Ÿ **Scoring System** โ€“ Tracks and displays high scores in-game
- ๐Ÿ“œ **Main Menu & Game Over Screens** โ€“ User-friendly interfaces with keyboard interaction
- โš™๏ธ **Object-Oriented Design** โ€“ Modular architecture using standard Java principles
- ๐Ÿ“… **Agile + Scrum Workflow** โ€“ Weekly sprints and project boards using Trello and GitHub

---

## ๐Ÿ› ๏ธ Technologies Used

| Purpose | Technology |
|--------------------|-------------------|
| Game Engine / Logic| Java (JDK 17+) |
| Packaging | JAR File |
| Version Control | Git + GitHub |
| Methodology | Agile + Scrum |

---

## ๐ŸŽฎ Demo

Here's a visual preview of Tweety Bird:


Welcome Screen
ย ย 
Game Over Screen

- **Left:** Welcome screen and main menu interface.
- **Right:** Game Over screen showing playerโ€™s score.

---

## โ–ถ๏ธ How to Use

Follow these steps to run the Tweey Bird endless runner game locally on your computer.

---

### ๐Ÿ’ป Prerequisites

- **Java** must be installed on your system (JDK 8 or later).
- To check if Java is installed, open a terminal or command prompt and run:

```bash
java -version
```

If it's not installed, download it from:
๐Ÿ‘‰ https://www.oracle.com/java/technologies/javase-downloads.html

---

### ๐Ÿ“ฆ Step 1: Download the Game

- Clone the repository or download it as a ZIP and extract it.
- Inside the root folder, youโ€™ll find a file named: `TweetyBird.jar`

---

### โ–ถ๏ธ Step 2: Run the Game

1. Open a terminal or command prompt.
2. Navigate to the folder containing the `.jar` file:

```bash
cd path/to/Endless-Runner-Game
```

3. Run the game with the following command:

```bash
java -jar TweetyBird.jar
```

> ๐Ÿ’ก The game will open in a window. Use your keyboard to control the player and try to dodge obstacles for as long as possible!

---

### ๐Ÿงฏ Troubleshooting

- **Nothing happens when I run the JAR?**
- Make sure youโ€™re using the correct version of Java (JDK 8+).
- If the file doesnโ€™t open on double-click, try running it via terminal with the command above.

- **Performance issues?**
- Close other applications while running the game.
- Ensure your system is not blocking Java execution.

---

## ๐Ÿ™Œ Acknowledgments

- **Rhode Island College (RIC)** โ€“ For providing the opportunity to develop and showcase this project as part of the Software Engineering Capstone.
- **Professor J. Port** โ€“ For mentorship and guidance throughout the course.
- **Team Members** โ€“ For their collaboration, code contributions, and weekly standups that brought the game to life.
- **Java Game Development Community** โ€“ For tutorials and resources that helped shape the foundation of the game's architecture.
- **Showcase Attendees** โ€“ For testing the game, providing feedback, and encouraging further development.