About the Game

The Battlefield game is an interesting console game designed to emulate 2 nations at war. As a player, you can choose between a multi-player mode or a CPU simulated mode (single player).

When the game starts, each player is given a battle area (N x M matrix) with a representation of Soldiers. There are 3 type of Soldier and the number and type of Soldiers a Player get is based on the current game currentLevel

C - Corporal
S - Sergeant
G - General

There are 3 categories of weapons in the game;

Pistol
Shotgun
Bazooka

A Soldier can only use weapons according to their ranks. For example, a Corporal can only use a Pistol, a Sergent can use a Pistol and a Shotgun while a General can use any of the 3 weapons.

For a CPU simulated mode, the computer randomly selects a name from some list of TRANSFORMER names. For every currentLevel, each player is assigned the same number of soldiers, weapons and arsenal.

Setting up the game

Perquisite: Ensure you have java >=1.8 runtime installed in your environment. You also need to install git and maven to run the commands for setup.

1. Clone this repository

git clone https://github.com/damilolasodiq/battlefield

2. Goto the directory where the repository is created and run the command;

mvn clean install

How to play

1. Open a command line terminal on your Mac or PC and run the command below from the location you cloned the repository;

java -jar target/Battlefield-1.0-SNAPSHOT.jar BattleFieldGameLauncher

2. After reading this instructions, you would follow subsequent instructions on the screen to set a game mode (CPU or multi-player)
3. You will be required to enter a name for your character e.g John, Xavi, Elixir e.t.c
4. You can type PAUSE at any time during a game play to pause the game.
5. The currentLevel information, current player name and health status of both players are shown on the top of the screen at everytime
6. You can type STAT at any moment in the game to check your full stat such as number of Soldier killed, number of soldiers injured, number of points, inventory of your arsenal and so on.
7. To launch an attack, you need to specify the position of your Soldier to carry out the attack to also a position in the battle area of your opponent where the attack your be carried out. For example, you type 0134 to select your Soldier at row 1 col 0 to carry out an attack on row 3 col 4 in the opponent's battle area.
8. For every attack, you can see the effect on the enemies field. X means your attack hit a position without a Soldier in which case, you don't get a point but your Soldier weapon loses a bullet. ! means your attack hit a Soldier on the enemies field and the Soldier died. - means a position on the battle field that is yet to be explored.
9. Every Soldier type has a range they can shoot for example, a Corporal cannot shoot as far as a Sergeant and a Sergeant cannot shoot as wide as general
10. If a Soldier tries to shoot to a point on the enemy's area where his cannot reach, his weapon reduces by a round but there's no effect on the enemies field and hence, no point awarded.
11. You can view this instruction anytime during a game play by typing HELP
12. To End the game, type QUIT or EXIT at any time.

How points are calculated

1. Anytime you attack an opponent's area that does not have a Soldier or you shoot an area that is out of range or you shoot an already blasted area, you do not get a point, yet your weapon reduces by a round
2. Depending on the Weapon used to attack, a point is gained for every successful attack (i.e when your a players soldier is able to hit another player's solder) However, an additional point is awarded whenever a junior ranked officer kills a higher ranked officer e.g when your Corporal hits your enemy's General or Sergent