# Tenka 天下 — World conquest strategy game

> Tenka 天下 — World conquest strategy game: seeded rules for two to six, world and Europe maps, dice, cards, saved games and a playable table for React, Vue, Svelte, Angular or plain HTML. Zero dependencies.

Install with `npm install @johnmorrisdotca/tenka`. Every page below is also an HTML page at the same address ending in .html; the documentation's home is https://johnmorrisdotca.github.io/tenka/docs/. The examples on the reference pages are run when the site is built, and what they print is shown under them.

## Guides

- [Getting started](https://johnmorrisdotca.github.io/tenka/docs/guides/getting-started.md): Install Tenka, start a seeded game and play one legal move.
- [Play a complete turn](https://johnmorrisdotca.github.io/tenka/docs/guides/play-a-turn.md): Follow the phases of a full turn, let the engine decide what is legal, and run the computer players.
- [Read battles and trade cards](https://johnmorrisdotca.github.io/tenka/docs/guides/battles-and-cards.md): Read battle outcomes from dice, use the native attack and blitz actions, and trade card sets.
- [Save, restore and export](https://johnmorrisdotca.github.io/tenka/docs/guides/save-and-replay.md): Save a game as its deal and moves, restore it by replaying them, and export a readable record.
- [Share a daily starting deal](https://johnmorrisdotca.github.io/tenka/docs/guides/daily-games.md): Share a daily starting deal from the UTC date, and keep past days reproducible.
- [Mount and embed a table](https://johnmorrisdotca.github.io/tenka/docs/guides/mount-and-embed.md): Mount a table in the DOM or as a custom element, and keep private names out of events and frames.
- [State and seeded rules](https://johnmorrisdotca.github.io/tenka/docs/guides/state-and-random.md): See how a game is one value, how dice and plans draw from separate random streams, and how the source is laid out.
- [Maps, SVG and dressing](https://johnmorrisdotca.github.io/tenka/docs/guides/maps-and-dressing.md): Use the map connections the rules read, draw them as SVG, and dress the table with Korokoro dice and Toranpu cards.
- [Troubleshooting and FAQ](https://johnmorrisdotca.github.io/tenka/docs/guides/troubleshooting.md): Find out why a start, a move or a saved game is null, and why a table will not load.
- [Upgrading and other engines](https://johnmorrisdotca.github.io/tenka/docs/guides/upgrading.md): Move from 1.x to 2.x, update within 2.x, and come from a mutable-board or networked engine.

## Reference

- [@johnmorrisdotca/tenka/shapes](https://johnmorrisdotca.github.io/tenka/docs/api/shapes/index.md): How Tenka's world is drawn: one outline per territory, where its counter stands, the sea links and the continents' borders.
- [@johnmorrisdotca/tenka/ui](https://johnmorrisdotca.github.io/tenka/docs/api/ui/index.md): Tenka drawn and played in the browser, in plain DOM: a whole table against the computer (`mountTenka`), and the map on its own (`tenkaMapSvg`, drawn from `tenkaMapModel`).
- [@johnmorrisdotca/tenka/react](https://johnmorrisdotca.github.io/tenka/docs/api/react/index.md): React table
- [@johnmorrisdotca/tenka/dressing](https://johnmorrisdotca.github.io/tenka/docs/api/dressing/index.md): Tenka's table dressed in the family's dice and cards: Korokoro's dice for the dice of every attack, tumbling onto the faces the game threw, and Toranpu's cards for the cards in a hand, with a territory card of Tenka's own and a back of Tenka's own for the deck.
- [@johnmorrisdotca/tenka/element](https://johnmorrisdotca.github.io/tenka/docs/api/element/index.md): Table element
- [@johnmorrisdotca/tenka/element/define](https://johnmorrisdotca.github.io/tenka/docs/api/element-define/index.md): Define the default table when imported; no effect on a server.
- [@johnmorrisdotca/tenka](https://johnmorrisdotca.github.io/tenka/docs/api/main/index.md): Tenka 天下: the classic world-conquest game on a map of the modern world, for two to six players, as plain functions over plain data.

## Optional

- [Changelog](https://johnmorrisdotca.github.io/tenka/docs/changelog.md): every release
- [Every export, in full](https://johnmorrisdotca.github.io/tenka/llms-full.txt)
- [Source](https://github.com/johnmorrisdotca/tenka)