# eclipse_tools

[Eclipse](https://boardgamegeek.com/boardgame/72125/eclipse) is one of my favorite boardgames.  

This repository contains the beginnings of a website to provide helpful utilities for players. 

## Faction Randomizer 

The first tool (currently in construction) is a faction randomizer - if one owns all the expansions there are 24 
different playable factions with no standardized way to select them at random.  The faction randomizer will allow you 
to specifywhich expansions you own, and how many "generic" (i.e. Terran, Magellan, or Octantis) factions you want included 
in the random pool, and ensure that no invalid combinations are generated.

Your preferences for randomization will be stored in cookies, so you are already set up for the next game.

### Explanation for non-players: 
Each players uses a cardboard play mat showing their faction. The play mats are all
printed with an alien species on one side and a "generic" faction on the other side. In the base game, it's six
aliens with different abilities and six "Terrans".  The terrans are all identical except for color. Some players 
of the base game might want to randomly select between the six aliens and one terran, some might want to include zero 
terrans, or four, or whatever.




# Eclipse Tools

[Eclipse](https://boardgamegeek.com/boardgame/72125/eclipse) is one of my favorite boardgames.  

This repository contains the beginnings of a website to provide helpful utilities for players. 

## Faction Randomizer 

The first tool (currently in construction) is a faction randomizer - if one owns all the expansions there are 24 
different playable factions with no standardized way to select them at random.  The faction randomizer will allow you 
to specifywhich expansions you own, and how many "generic" (i.e. Terran, Magellan, or Octantis) factions you want included 
in the random pool, and ensure that no invalid combinations are generated.

Your preferences for randomization will be stored in cookies, so you are already set up for the next game.

### Explanation for non-players: 
Each players uses a cardboard play mat showing their faction. The play mats are all
printed with an alien species on one side and a "generic" faction on the other side. In the base game, it's six
aliens with different abilities and six "Terrans".  The terrans are all identical except for color. Some players 
of the base game might want to randomly select between the six aliens and one terran, some might want to include zero 
terrans, or four, or whatever.


## LICENSE AND CONTRIBUTION

Licensed under MIT license, see LICENSE.txt.  If you'd like to contribute, please issue pull requests after ensuring
that tests are passing. All contributors agree to abide by the code of conduct (Contributor Covenant 1.4), see 
CODE_OF_CONDUCT.md.

Add license and code of conduct.
Add license and code of conduct.
