/OOPP-Quizzz-game

Full-stack Java application (energy awareness quiz like game) created in a team of six during a period of 10 weeks

Primary LanguageJava

OOP-Project Group 8

Description of project

The goal of this project is to create a Quizzz-like game, focussing on energy sustainability. The project will be based on a Spring-based back-end with a OpenJFX front-end. This project is made over a period of 10 weeks in which we learn to use new frameworks, collaborate and much more.

Group members

Profile Picture Name Email
Rafael Petouris Rodriguez de Paterna R.PetourisRodriguezdePaterna@student.tudelft.nl
Petra Postelnicu P.Postelnicu@student.tudelft.nl
Vlad Nitu V.P.Nitu@student.tudelft.nl
Marcin Jarosz M.W.Jarosz@student.tudelft.nl
Joshua Gort J.Gort@student.tudelft.nl
Sophie van der Linden S.A.vanderLinden@student.tudelft.nl

How to run it

How to add the activities to the repository

After cloning the repository on your machine, we provide 2 options to follow for adding the activities to the repository:
NOTE: We added the unzipper in order to make the repository more user-friendly, therefore we advise you to go for step 1.

  1. Directly adding the .zip file:
    "activities.zip" (that contains activities.json file and the photos related to the activites) should be downloaded from the following link: https://gitlab.ewi.tudelft.nl/cse1105/2021-2022/activity-bank/-/releases.

After accessing the link, you need to click on the other link pointed below in order to get the required .zip file donwloaded on your machine. ![](https://gitlab.ewi.tudelft.nl/cse1105/2021-2022/team-repositories/oopp-group-08/repository-template/uploads/239e739f506f25dd2bf18c69d17dcf8e/activitiesziplocation.png)
Then, it should be renamed as "activities.zip" and added in the "resources" folder from the server-side, that is located on the following path: "server/src/main/resources/{here should the activities.zip be added}"
This can be simply done by drag-and-dropping the "activities.zip" in the correct located "resources" folder, the one described above.
If the zipper is added accordingly (named as activities.zip and containing the correct content, the one downloaded by accesing previous links), the server will inform you that it 'Succesfully unzipped activities.zip' and then "Activities added to repo".
If this is not the case, the server will let you know that a problem occured (such as: "activities.json was not found"). 2. **Directly adding the activities.json file and all photos**:
If you do not want to make use of our unzipper (that's integrated in the code), you can manually add the activities.json and all 78 folders with images) in "resources/activities/{insert_here}", where the "activities" folder will be manually added by you.

How to set up the game

After the activities are added to the correct folder, the game will be run using Gradle. You should follow the following steps

  1. Make sure you have Gradle installed on your machin (run 'Gradle -version' in terminal. If the command appears as "not found", then you need to install Gradle).
  2. Open your chosen InteliJ, press the bottom-left corner (which will provide some options) and then press on "Gradle".
  3. Now, you should see Gradle tool window on the right of your IDEA. Click on "Tasks/application (in other words, the first directory and its first subdirectory).
  4. Now you should see two executables: 'bootRun' and 'run'. By clicking on 'bootRun' the server should start (only one instance at a time). Then, by clicking on 'run' a client instance will start (more instances can be run at a time).
  5. If all the previous steps were followed accordingly, now you should be able to play the game. Enjoy!

How to contribute to it

As there is always room for improvement, future users can contribute as following

  1. If you spot any bugs, please let us know in order to fix the product as soon as possible. Our emails can be found in the "Group members" section.
  2. If you have any idea that is relevant in improving our game, we are looking forward to hearing your proposals.

Copyright / License (opt.)