View on GitHub.io · View on GitHub.com
Board Layouts · Setup · Usage · Documentation · License
- 2 Players: Regular
- 3 Players: Regular, Small, Large
- 4 Players: Regular, Small, Large
- 5 Players: Regular, Small, Large
- 6 Players: Regular, Large
- 7 Players: Regular, Small, Large
- 8 Players: Regular, Large
5 planetary systems and 3 anomaly/wormhole/empty systems per player. This board layout has 67% more planets per player than normal, so --aggression high and playing to 14 victory points are recommended.
ti4cartographer --players 2 --layout regular
3 planetary systems and 2 anomaly/wormhole/empty systems per player. Uses hyperlanes. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout is well balanced, so --aggression moderate and playing to 10 victory points are recommended.
ti4cartographer --players 3 --layout regular
3 planetary systems and 2 anomaly/wormhole/empty systems per player. This board layout has home systems closer to Mecatol Rex than normal but further away from each other than normal, so --aggression moderate and playing to 10 victory points are recommended.
ti4cartographer --players 3 --layout small
5 planetary systems and 3 anomaly/wormhole/empty systems per player. This board layout has 67% more planets per player than normal and has home systems much further away from each other than normal, so --aggression high and playing to 14 victory points are recommended.
ti4cartographer --players 3 --layout large
3 planetary systems and 2 anomaly/wormhole/empty systems per player. Uses hyperlanes. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout is well balanced, so --aggression moderate and playing to 10 victory points are recommended.
ti4cartographer --players 4 --layout regular
3 planetary systems and 2 anomaly/wormhole/empty systems per player, with 1 additional planetary system and 1 additional anomaly/wormhole/empty system. This board layout has home systems further away from each other than normal, so --aggression high and playing to 10 victory points are recommended.
ti4cartographer --players 4 --layout small
5 planetary systems and 3 anomaly/wormhole/empty systems per player. This board layout has 67% more planets per player than normal and has home systems further away from each other than normal, so --aggression high and playing to 14 victory points are recommended.
ti4cartographer --players 4 --layout large
3 planetary systems and 2 anomaly/wormhole/empty systems per player. Uses hyperlanes. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout is well balanced, so --aggression moderate and playing to 10 victory points are recommended.
ti4cartographer --players 5 --layout regular
3 planetary systems and 2 anomaly/wormhole/empty systems per player. This board layout is well balanced, so --aggression moderate and playing to 10 victory points are recommended.
ti4cartographer --players 5 --layout small
4 planetary systems and 2 anomaly/wormhole/empty systems per player, with 1 additional anomaly/wormhole/empty system. This board layout has 33% more planets per player than normal, so --aggression high and playing to 12–14 victory points are recommended.
ti4cartographer --players 5 --layout large
3 planetary systems and 2 anomaly/wormhole/empty systems per player. This board layout is well balanced, so --aggression moderate and playing to 10 victory points are recommended.
ti4cartographer --players 6 --layout regular
6 planetary systems and 3 anomaly/wormhole/empty systems per player. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout has twice as many planets per player than normal and has home systems further away from Mecatol Rex than normal, so --aggression high and playing to 14 victory points are recommended.
ti4cartographer --players 6 --layout large
3 planetary systems and 2 anomaly/wormhole/empty systems per player. Uses hyperlanes. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout is well balanced, so --aggression moderate and playing to 10 victory points are recommended.
ti4cartographer --players 7 --layout regular
4 planetary systems and 2 anomaly/wormhole/empty systems per player, with 1 additional planetary system and 1 additional anomaly/wormhole/empty system. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout has 38% more planets per player than normal and has home systems further away from Mecatol Rex than normal, so --aggression high and playing to 12–14 victory points are recommended.
ti4cartographer --players 7 --layout small
4 planetary systems and 2 anomaly/wormhole/empty systems per player, with 3 additional planetary systems and 2 additional anomaly/wormhole/empty systems. Uses hyperlanes. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout has 48% more planets per player than normal and has home systems further away from Mecatol Rex than normal, so --aggression high and playing to 14 victory points are recommended.
ti4cartographer --players 7 --layout large
3 planetary systems and 2 anomaly/wormhole/empty systems per player. Uses hyperlanes. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout is well balanced, so --aggression moderate and playing to 10 victory points are recommended.
ti4cartographer --players 8 --layout regular
4 planetary systems and 2 anomaly/wormhole/empty systems per player, with 2 additional planetary systems and 2 additional anomaly/wormhole/empty systems. Requires either the Prophecy of Kings expansion or the Thunder's Edge expansion. This board layout has 42% more planets per player than normal and has home systems further away from Mecatol Rex than normal, so --aggression high and playing to 14 victory points are recommended.
ti4cartographer --players 8 --layout large
The following packages are required:
- C++17 Compiler: Any C++17 compiler will do, such as GCC or Clang. On Ubuntu, install GCC with
sudo apt install g++or Clang withsudo apt install clang. - CMake: On Ubuntu, install with
sudo apt install cmake.
Build the programs with:
mkdir build
cd build
cmake ..
make -jThis builds the main program, build/bin/ti4cartographer, as well as the build/bin/ti4atlas utility.
ti4cartographeris the main program used to generate a randomized balanced board.ti4atlasis a small utility program that prints the various systems ranked from best to worst.
You can optionally run tests from the build directory with:
make testYou can optionally install the programs from the build directory with:
sudo make installThis installs the programs to /usr/local/bin/ti4cartographer and /usr/local/bin/ti4atlas. To uninstall a program, simply delete it.
The ti4cartographer program computes an optimal board and outputs its Tabletop Simulator string. Run ti4cartographer with no arguments or with the --help argument to obtain usage information. Otherwise, for regular use, run ti4cartographer with:
ti4cartographer --players <number> --layout <type> --aggression <type> --version <type> --quiet--players <number>: Required. Specifies the number of players. Choices are2,3,4,5,6,7, or8.--layout <type>: Optional. Specifies the board layout. Choices vary by number of players, but typically includeregular,small, orlarge; see the Board Layouts section. The default isregular.--aggression <type>: Optional. Specifies the degree of expected aggression resulting from the placement of systems on the board. Choices arelow,moderate, orhigh. The default ismoderate. Higher aggression places better systems at equidistant positions compared to the systems in each player's slice, whereas lower aggression does the opposite.--version <type>: Optional. Determines whether the system tiles from the Prophecy of Kings expansion or the Thunder's Edge expansion can be used. Choices arebase(base game only),pok(base game with the Prophecy of Kings expansion),te(base game with the Thunder's Edge expansion), orall(base game with the Prophecy of Kings expansion and the Thunder's Edge expansion). The default isall. Note that 7 and 8 player games require either the Prophecy of Kings expansion or the Thunder's Edge expansion.--quiet: Optional. Activates quiet mode, where the only console output is the generated board's Tabletop Simulator string.
The ti4atlas utility takes no arguments and simply prints out a list of the various systems ranked from best to worst. This ranking only takes into account the individual systems by themselves, and does not account for position on the game board, balance of planets, resources, and influence, suitability as a forward outpost, or other interactions; such considerations are handled by the ti4cartographer program.
Building the documentation is optional and requires additional packages:
- Doxygen: On Ubuntu, install with
sudo apt install doxygen. - Graphviz: On Ubuntu, install with
sudo apt install graphviz. - TeX Live: On Ubuntu, install with
sudo apt install texlive texlive-fonts-extra.
Documentation is disabled by default but can be generated from the build directory with:
cmake .. -DBUILD_DOCS=ON
make docsThis generates HTML documentation using Doxygen. The documentation is located in docs/html. Open the docs/html/index.html file in any web browser to view the documentation.
This work is maintained by Alexandre Coderre-Chabot (https://github.com/acodcha) and licensed under the MIT License. For more details, see the LICENSE file or https://mit-license.org/. This work is based on the Twilight Imperium 4th Edition board game by Fantasy Flight Games. The contents, copyrights, and trademarks of everything involving Twilight Imperium 4th Edition are exclusively held by Fantasy Flight Games; I make no claim to any of these in any way.