Skip to content

billmei/nand2minesweeper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nand2minesweeper

🎞 Watch the Demo 🎞

What is this?

This is my final project (Project 9) for the nand2tetris course! It's a Minesweeper game written in the Jack language.

nand2tetris is one of the most rewarding computer science courses I've taken. The course challenges us to build a full application (in this case, Minesweeper) using a high level language (the Jack language) compiled using a compiler we wrote ourselves, with an operating system we write ourselves, running on a hardware platform (the Hack machine) we designed ourselves, powered by a CPU we wired together ourselves. There is nothing left to "magic" and everything is built by the students down to the transistors!

Who are you?

I'm Bill Mei, the author of Painless CSS, and professional software developer. Hire me.

How to load the game

Download the nand2tetris software suite and run the script tools/VMEmulator.sh (on Unix machines) or tools/VMEmulator.bat (on Windows machines).

In the VMEmulator Java Applet, click on the folder icon to open a project, and then navigate to the nand2minesweeper directory.

Click on the nand2minesweeper folder and then click "Load Program" to load it.

Click "Yes" when it says "No implementation was found for some functions which are called in the VM code".

Set the "Animate" dropdown option to "No animation".

Finally, click on the fast forward button to run the game!

I pre-compiled the .vm files for you in the in the nand2minesweeper directory so you can run the game without compiling. If you would like to compile the .vm files yourself, then use your nand2tetris software suite to run the JackCompiler to compile all the .jack files in the nand2minesweeper folder into .vm files.

How to play Minesweeper

Use the arrow keys to move the cursor around the grid.

Press space to reveal a cell under your cursor. If you reveal a mine, it explodes, and the game is over! If you reveal a cell and it is not a mine, then a number will be shown on that cell. This number indicates the number of mines that are adjacent to that cell, in all 8 directions (horizontally, vertically, and diagonally).

Press f to plant a flag over a cell you suspect is a mine. This way, you can remind yourself which cells to avoid. Press f again to remove the flag.

Press r to restart the game at any time.

Press q to quit the game and halt execution.

Screenshots

Game in Progress


Game Lost


Game Won


Tutorial



License

MIT License

About

Minesweeper game written in Jack for the nand2tetris course

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published