/VirtualGang

CSC290 Assigments

Primary LanguageJava

ColorSweeper 💣

Navigation

Game Description

The game places the user on a minefield where the user must reveal all of the safe spaces without pressing a bomb. The game adds an unique twist to the classic game, Minesweeper, by Curt Johnson. This twist involves the use of colors to group different bombs, adding a new level of difficulty and strategy to the game. A secret hint is hidden in the game to ease the difficulty this new twist brings to the game. The game was coded using Java and CSS.

Screenshots

Screen 1 Screen 2
Screen 3 Screen 4

Installation and Download

ColorSweeper is in the form of a .jar file. This format is able to be easily downloaded and played. Steps to Download and Install game through file managment:

  1. Install the Java runtime environment (if not already downloaded)
  2. Download Repository by going into this link and Click Download on the top right of the screen.
  3. Download Zip file into any directory you wish to save file
  4. Unzip the file using a decompressing software (ex: 7-zip)
  5. Double click on the jar file

Steps to Download and Install game through Command Line:

  1. Install the Java runtime environment (if not already downloaded)
  2. Pull repository through the command line (git clone https://github.com/AlgorithmIsFun/VirtualGang)
  3. Go into the repo by accessing through commandline (cd VirtualGang)
  4. To access the jar file, use the command line java -jar <myjarfile.jar>

Jar File Download Jar File

How to Play

When the game launches, the player is met with the Title screen. The player can then choose between 3 pre-defined game modes or customize their own. Next, the player can interact with the minefield. The minefield contains 3 types of boxes: Bombs, Numbers, and Whitespaces. The player can either choose to reveal or flag a certain box. However, the user cannot flag a different color bomb unless they have flagged all bombs of their current color. The player must reveal all non-bomb boxes to win the game.

Configurations

1)The Board size must be at least 4x4 2)The number of bombs must not exceed the total number of squares in the Board 3) The number of colors must not exceed the total number of bombs 4) Negative integers are not valid 5) Non-integers are not valid

Contributions

Contributions were made by the VirtualGang team comprised with: Ritvik Bhardwaj (Aipiox Techson) , Alexei Blinov, Asmah Al-arryan, Abdullah Khan, Ali Ibrahim.

For an indepth documentation on all of the classes in ColorSweeper, please check the resource documentation.txt.

Licence

ColorSweeper is licenced by Apache License. Please see LICENCE.md.txt file for more information.