HIB

The Haskell Interactive Battleship game. This program has been developed initially as a programming project for the course 'Programming Paradigms' at the University of Antwerp.

The requirement were stated as follows:

• Playing field measures 10 x 10 cells.
• 2 players - let's call them pirates (Arr!).
• 4 ships for each pirate (of length 2, 3, 4 and 5), arranged either horizontally or vertically and no overlapping ships.
• Player's goal is to sink the opponent's fleet by calling out each of the cells belonging to the ships in that fleet.
• On each turn, a player can fire as many shots as he has ships that aren't sunk.
• Well and robust design (of course).

The goal was not to bump a procedural or OO solution into Haskell, but rather to learn how to love and write idiomatic, elegant Haskell code.

Try it..

You can try the game in two ways:

Interactive - The exciting way

$ cd src/
$ runhaskell Main.hs

An example of inputs (notice the piraty output, yarr!):

1: Enter yer name > Alice
Alice: Ahoy!
2: Enter yer name > Bob
Bob: Ahoy!
Alice: Enter yer ship [2 points] > (0,0);(1,0)
Alice: Enter yer ship [3 points] > (0,1);(0,2);(0,3)
Alice: Enter yer ship [4 points] > (4,1);(4,2);(4,3);(4,4)
Alice: Enter yer ship [5 points] > (5,5);(6,5);(7,5);(8,5);(9,5)
Bob: Enter yer ship [2 points] > (9,9);(8,9)
Bob: Enter yer ship [3 points] > (2,1);(3,1);(4,1)
Bob: Enter yer ship [4 points] > (5,1);(5,2);(5,3);(5,4)
Bob: Enter yer ship [5 points] > (8,0);(8,1);(8,2);(8,3);(8,4)
Alice: Gimme chart!
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
Alice: Fire in the hole!
Alice: Gun ready at > (0,0)
Alice: FIRE!
Blimey! Miss!
Alice: Gimme chart!
o - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
Alice: Fire in the hole!
Alice: Gun ready at > (8,0)
Alice: FIRE!
Yo-ho-ho! Hit!
Alice: Gimme chart!
o - - - - - - - x - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
...

As you can see, on each turn, the player's board will be displayed to help indicating where you should make the next guess. At the end of the game, not only the board of both players will be displayed, but also how their fleets were positioned, below an example:

...
Yarr! A ship has gone to Davy Jones' Locker!
Shiver me timbers! Barbarossa be the winner!
Attempts of Barbarossa:
x x x x - - - - - -
x x x x - - - - - - 
- x x x - - - - - - 
- - x x - - - - - - 
- - - x - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
Attempts of Jack Sparrow:
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - - - - 
- - - - - - - o o o
- - - - - - - - o o
- - - - - - - - - o
Fleet of Barbarossa:
% % ~ ~ ~ ~ ~ ~ ~ ~
% % % ~ ~ ~ ~ ~ ~ ~
% % % % ~ ~ ~ ~ ~ ~
% % % % % ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~

Fleet of Jack Sparrow:
% % % % ~ ~ ~ ~ ~ ~
% % % % ~ ~ ~ ~ ~ ~
~ % % % ~ ~ ~ ~ ~ ~
~ ~ % % ~ ~ ~ ~ ~ ~
~ ~ ~ % ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~
~ ~ ~ ~ ~ ~ ~ ~ ~ ~

Go ahead and love it (or not)!

Simulate from file - The boring way

With runhaskell you can also pipeline inputs from file. In that case, the game will abort when EOF has reached (so not necessarilly the end of the game). There's no possibility to read from file and then continue the game in interactive mode.

.. love it!

If you liked the game, you can use cabal to install the game into your computer:

$ cabal configure
$ cabal install [options]

For a complete list of available options, run:

$ cabal help install

When the building and installation succeed, there should be an executable called hib available in the binary directory (you can set them using --bindir=<PATH> option).

Contributing

Yarr!! Send a pull request, post an issue, ... Ye be welcome aboard!