Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/KeeganW/ti4

TI4 Map Generator - Generate a custom, unique, and balanced Twilight Imperium 4 galaxy map to use in your next game!
https://github.com/KeeganW/ti4

generator github-page map ti4 twilight-imperium

Last synced: about 1 month ago
JSON representation

TI4 Map Generator - Generate a custom, unique, and balanced Twilight Imperium 4 galaxy map to use in your next game!

Awesome Lists containing this project

README

        

# TI4 Generator
A web tool to generate Twilight Imperium 4 game boards through many custom settings.

## Web Quick Start

Visit the [web page located on github pages](https://keeganw.github.io/ti4/). This is running from the `gh-pages` branch.

## Development Setup

1. Install Node and NPM for your OS using [their website](https://nodejs.org/en/) or brew on Mac (`brew install node`)
1. In the root directory of the cloned project, run `npm install`
1. Once it is done, you can start the development server with `npm start`. If a web page is not automatically opened, go to [localhost:3000/ti4](http://localhost:3000/ti4)

## Using the Tool

The tool has many features, go poke around! Here is a list of notable features:

- Automatic map generation based on user input. Options include:
- Using new Prophecy of Kings content
- Setting the player count
- Setting what the board will look like from various custom maps
- Setting how tiles are places by working with their weights
- Seeding the generation with a custom number between 1-10,000
- Automatically picking races for players
- Set player names for showing on the map
- Set races that can be picked from
- Randomization of how tiles are placed
- Moving better planets towards the middle
- Drag and drop tiles to customize your board
- Zoom in and out to get a better idea of what certain tiles are
- Show an overlay with the tile numbers for when you are ready to build your board
- Replace any tiles on the board with any unused tiles
- Show detailed information about the adjacenct planets to each home system
- Sharable links to send to your friends
- Copy the tile string to view in Table Top Simulator (TTS)

## Pushing Changes to Github Pages

```bash
npm run deploy
```

Using react's `gh-pages` you can simply run the above command to deploy to the github page.