uni

University stuff
git clone git://git.margiolis.net/uni.git
Log | Files | Refs | README | LICENSE

README.md (1347B)


      1 # minescurses
      2 
      3 A minesweeper game using the `ncurses` and `SDL2` libraries. The game was originally made as a university assignment of mine, but I decided to take it a bit further afterwards.
      4 
      5 ## How to play
      6 
      7 The objective is to simply find and defuse all the mines.  
      8 
      9 * Enter number of columns
     10 * Enter number of rows
     11 * Enter number of mines
     12 * Move with `w`/`s`/`a`/`d` or Vim keys (`k`/`j`/`h`/`l`)
     13 * Open cell with `[ENTER]`, or `o`
     14 * Flag cell with `f`
     15 * Defuse mine (only if flagged) with `g`
     16 * You win if you defuse all the mines
     17 * You lose in case you open a mine or you try to defuse a flagged cell not containing a mine
     18 
     19 Additional controls
     20 
     21 * `m`: Open control menu
     22 * `p`: Pause audio
     23 * `+`: Volume up
     24 * `-`: Volume down
     25 * `q`: Quit
     26 
     27 ## To Do
     28 
     29 * Add more error checks
     30 * Load score log to ui
     31 * Add colors
     32 * Add UTF-8 support
     33 * Fix wrong mine spawning bug
     34 * Fix flickering and cursor
     35 
     36 ## Execution
     37 
     38 ### Linux / Unix / macOS
     39 
     40 **Dependencies**
     41 * `make`
     42 * `ncurses`
     43 * `SDL2`
     44 * `SDL2_mixer`
     45 
     46 ```shell
     47 $ cd path_to/minecurses
     48 $ make
     49 $ make run
     50 $ make clean # optional
     51 ```
     52 
     53 ## Preview
     54 
     55 ### Start screen
     56 ![startmenu](https://user-images.githubusercontent.com/54286563/78460772-52a25e00-76cc-11ea-976b-10212e228ca0.png)
     57 ### Gameplay
     58 ![gameplay](https://user-images.githubusercontent.com/54286563/78460709-bc6e3800-76cb-11ea-92f4-ab58e141e9be.png)