Dinosaur Edward Game

Dinosaur Edward Game is a game based on the popular Chrome dinosaur game (T-rex), developed in Java 21, using only Java without any auxiliary libraries. The game is created with the help of Spring Boot to start the system and Lombok to make the code less verbose. Additionally, the game features an artificial intelligence that uses natural selection in a genetic algorithm, allowing you to choose between playing against the network or training it.

Download the Game

To try out the game, download the version compatible with your operating system:

• Download for macOS (AArch64)
• Download for Linux (x64)
• Download for Windows (x64)

After downloading, simply run the downloaded file on your operating system to install the game.

Enjoy the game and have fun!

Main Features

• The game is inspired by the Chrome dinosaur game (T-rex).
• Developed in Java 21, using only Java without any auxiliary libraries.
• Uses Spring Boot to start the system.
• Uses Lombok to make the code less verbose.
• The game features an artificial intelligence based on a neural network trained by a genetic algorithm.

How to Play

• Use the arrow keys for jumping or crouching to avoid enemies.
• Keep the dinosaur alive for as long as possible.
• For every enemy avoided, your score will increase.

Game Mode Against the Artificial Intelligence

1. After starting the game, select the "Play versus Artificial Intelligence" option in the main menu.
2. Use the arrow keys to control the dinosaur.
3. Try to avoid enemies and survive for as long as possible.
4. Your score will be displayed in the top right corner.

Artificial Intelligence Training Mode

1. After starting the game, select the "Train the Artificial Intelligence" option in the main menu.
2. The neural network will undergo a training process using a genetic algorithm.
3. The training progress will be displayed in the top right corner.
4. At the end of the training, the weights of the neural network will be saved for future use.

System Requirements

• Java Development Kit (JDK) 21

How to Run the Game

1. Make sure you have Java 21 installed on your system.
2. Clone this repository to your development environment.
3. Navigate to the root directory of the project.
4. Run the following commands in the terminal to compile and execute the game:

./mvnw clean install
./mvnw spring-boot:run

Generating a Final Installable Version

If you are a developer and want to generate a final installable version of the game for different platforms, follow the instructions below:

Note: Application packages must be built on the target platform. The system used for packaging must contain the application, a JDK, and software needed by the packaging tool.

macOS

Run the following command:

./mvnw clean install -P macos

This will create a dinosaur-edward-game.dmg file in the target/output folder.

Linux

Run the following command:

./mvnw clean install -P linux

This will create a dinosaur-edward-game.deb file in the target/output folder.

Windows

Run the following command:

./mvnw clean install -P windows

This will create a dinosaur-edward-game.exe file in the target/output folder.

After following these instructions, you will have the final installable versions for each platform, ready to be distributed or shared with users.

Important: Remember to build the application packages on the target platform to ensure compatibility. The system used for packaging must contain the application, a JDK, and the software needed by the packaging tool for each specific platform.

The following platforms and formats are supported with the required software:

• Linux: deb
  • For Ubuntu Linux, the fakeroot package is required.
• macOS: dmg
  • Xcode command line tools are required.
• Windows: exe
  • WiX 3.0 or later is required.

Credits

The Dinosaur Edward Game was developed by Edward.

Acknowledgements

I would like to express my gratitude to the Chrome browser's dinosaur game project for serving as inspiration. I would also like to thank Spring Boot and Lombok for making my life easier. Lastly, heartfelt thanks go to my dear and beloved wife.

Contribution

Contributions are welcome! If you would like to contribute to the Dinosaur Edward Game, please feel free to submit a pull request.