# NAND Mines
Minesweeper for the Hack machine implemented in Jack language.

Video: https://youtu.be/SpAAYjXAtJ0

<p align="center">
    <img src="https://github.com/idelvall/nand-mines/raw/master/img/nand-mines.gif" alt="NAND Mines board">
</p>

<p align="center">
    <img src="https://github.com/idelvall/nand-mines/raw/master/img/nand-mines-help.gif" alt="NAND Mines help">
</p>

**Nand2Tetris** is an online, self-teachable course on Building a Modern Computer from First Principles http://www.nand2tetris.org/.

This was my project submission for the module 9, a game implemented in the Jack language, a minimalist high level, OO language we have implemented for the Hack machine, a 16-bit hardware machine we had previously built starting from the very ground: logical NAND gates.


Table of Contents
=================
* [General execution instructions](#general-execution-instructions)
* [Acknowledgements](#acknowledgements)
* [Support bugs and requests](#support-bugs-and-requests)
* [Authors](#authors)
* [License](#license)

## General execution instructions

 - Download and install the Nand2tetris Software Suite (http://www.nand2tetris.org/software.php)
 - Compile the src folder with the `JackCompiler` tool.
 - Start the `VMEmulator`.
 - Using File -> Load Program, select the application's directory and click the "Load Program" button.
 - Click the "Yes" button to the Confirmation Message pop-up.
 - Set the Animate: drop-down to "No animation".
 - Set the speed slider to "Fast".
 - Press "F5" to run.
 
## Acknowledgements
- Thanks to all the [nand2tetris crew](http://www.nand2tetris.org/team.php) for this amazing learning experience!.
- This game makes use of some classes of [Nand2Tetris-Games_and_Demos](https://github.com/gav-/Nand2Tetris-Games_and_Demos) for image generation. Thanks Gavin Stewart for sharing your great work!
- Thanks to Golan Parashi for the [Sokoban bitmap editor](https://github.com/idelvall/nand-mines/tree/master/tools/BitmapEditor)!

## Support bugs and requests
https://github.com/idelvall/nand-mines/issues

## Authors

- Ignacio del Valle Alles (<https://github.com/idelvall/>)

Contributions are always welcome and greatly appreciated!

## License
Apache License, Version 2.0


