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: 3 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/KeeganW/ti4
• Owner: KeeganW
• Created: 2019-08-19T22:47:28.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-06-20T03:53:00.000Z (5 months ago)
• Last Synced: 2024-06-21T14:37:00.996Z (5 months ago)
• Topics: generator, github-page, map, ti4, twilight-imperium
• Language: JavaScript
• Homepage: https://keeganw.github.io/ti4/
• Size: 96.6 MB
• Stars: 24
• Watchers: 2
• Forks: 19
• Open Issues: 34
• Metadata Files:
  • Readme: README.md

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.