ti3-sampler

Sample random locations on a TI3 board.
git clone git://git.jtobin.io/ti3-sampler.git
Log | Files | Refs | README | LICENSE

README.md (1270B)


      1 # ti3-sampler  [![BSD License](https://img.shields.io/badge/license-BSD-blue.svg)](https://github.com/jtobin/hnuts/blob/master/LICENSE)
      2 
      3 ![](/assets/ti3-game-board.jpg)
      4 
      5 Sample random board locations in a TI3 game.
      6 
      7 Useful for e.g. setting domain counters only on some limited percentage of the
      8 board.  I find chocking the board full of domain counters slows the game down a
      9 little too much, but you still want a few of them there for fun.  A proportion
     10 of about 0.275 tiles seems to strike a very good balance.
     11 
     12 Supports three, four, five, and six player games.  The tile coordinates are
     13 just reported in terms of position on the nth ring of the board.  North is one,
     14 and then you just count clockwise from there.
     15 
     16 This takes into account the different board configurations for different
     17 players, and so doesn't sample home systems.  Additionally, Mecatol Rex is
     18 always included in the result.
     19 
     20 For the three player game, just interpret the provided coordinates as if all
     21 tiles were present on the board.
     22 
     23 ## Usage
     24 
     25 Just clone the repo, install [Stack](https://www.haskellstack.org/), and run
     26 something like:
     27 
     28 ```
     29 $ stack exec ti3-sampler 4 0.1
     30 Outer 18
     31 Outer 11
     32 Mid 6
     33 Rex
     34 ```
     35 
     36 The first argument is the number of players -- the second is the desired tile
     37 proportion.
     38