Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
mnito committed Sep 7, 2017
1 parent e323da0 commit 10671a5
Showing 1 changed file with 62 additions and 0 deletions.
62 changes: 62 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# Charmine

Charmine as it currently stands is an experimental, proof-of-concept command line game. The game concept itself needs to be further developed, the level generator should be less random, and some sort of points system would be nice. This version of Charmine was developed as a sandbox to test the basic concept and also showcase the techniques for creating terminal-based games for Linux and OS X.

## Installation

The `go get` command can be used to install Charmine:

```command
go get github.com/mnito/charmine
```

## Options

### Help

The help command will show help for other options.

```
charmine -help
```

### Controls

Restricting usable controls is possible with this option.

This specific example will restrict input to right and up:

```command
charmine -controls ru
```

Valid options are l,u,d,r. Default is ludr.

### Density

Setting the density will vary the amount of letters that appear in the field.

```command
charmine -density 10
```

Valid densities are between 1 and 100. Increasing the density will result in the appearance of more characters in the field. The default is 45.

### Seed

A seed can be set for the random number generator providing a determinate field per seed under the same conditions.

```command
charmine -seed 123456789
```

### License

Charmine is licensed under the MIT License.

### Author

Michael P. Nitowski

* Email: <mike@nitow.ski>
* Twitter: [@mikenitowski](https://twitter.com/mikenitowski)

0 comments on commit 10671a5

Please sign in to comment.