# kostky

Textová (CLI) hra v kostky pro více hráčů – varianta klasického *Farkle*
(„tisícovky“). Běží celá v terminálu, v Pythonu, s jedinou závislostí
(`tabulate` pro závěrečnou výsledkovou tabulku).

## Požadavky

- Python 3.9+
- Závislost `tabulate` (doinstaluje se automaticky při instalaci)

## Instalace a spuštění

```bash
git clone https://gitea.spacilovi.eu/david/kostky.git
cd kostky
pip install .
kostky
```

Případně bez instalace (s nainstalovaným `tabulate`) přes `python -m kostky`,
nebo izolovaně jako CLI nástroj přes `pipx install .`.

> Pro vývoj: `pip install -e ".[dev]"` – editovatelná instalace včetně `mypy`
> a `ruff`.

## Jak se hraje

### Začátek hry

1. Zadej jméno prvního hráče (povinné, nesmí být prázdné).
2. Přidávej další hráče; zadáním `x` zadávání ukončíš. Jména musí být unikátní.
3. Zadej cílové skóre, nebo nech pole prázdné pro výchozích **10 000**.

### Průběh tahu

Na začátku tahu uvidíš, kdo je na tahu (s jeho skóre a cílem), a hod šesti
kostkami s písmennými pozicemi:

```
Na tahu je Anna (0/10000).
1, 5, 3, 2, 6, 4
^  ^  ^  ^  ^  ^
a  b  c  d  e  f
```

Pak zvolíš jednu z akcí:

| Vstup | Akce |
| --- | --- |
| `pozice kostek` | Odložíš vybrané kostky k vyhodnocení – písmeny (např. `a`, `cd`, `abcdef`). Hodnoty na zvolených pozicích musí dohromady tvořit některou kombinaci z bodovací tabulky. |
| `h` | Hodíš znovu zbývajícími kostkami. Povoleno až poté, co v tomto tahu odložíš aspoň jednu bodující kombinaci. |
| `k` | Ukončíš tah, připíšeš si nasbírané skóre a předáš tah dalšímu hráči. |
| `exit` | Předčasně ukončíš celou hru. |

Odkládat můžeš i víc kombinací po sobě – po každém vyhodnocení pokračuješ se
zbývajícími kostkami a body se v rámci tahu sčítají.

### Smůla, hot dice, vynulování a výhra

- **Smůla (bust):** když čerstvý hod neobsahuje žádnou bodující kombinaci,
  o body z tohoto tahu přijdeš a tah přechází na dalšího hráče.
- **Hot dice:** když se ti podaří odložit všech šest kostek, dostaneš čerstvý
  hod šesti kostkami a pokračuješ ve stejném tahu.
- **Vynulování:** tři po sobě jdoucí nulové tahy vynulují tvé celkové skóre.
  Počet aktuálních nul se vedle skóre ukazuje jako `x` / `xx`.
- **Výhra:** po dokončení každého kola vyhrává osamocený lídr nad cílovým
  skóre; při shodě na první příčce se hraje dál. Na konci se vypíše výsledková
  tabulka s pořadím všech hráčů.

## Bodování

Kompletní tabulka je v souboru [`kostky/hodnoty.csv`](kostky/hodnoty.csv).
Kombinace se vyhodnocuje podle hodnot odložených kostek – na jejich pořadí
nezáleží.

### Stejné kostky

| Kostka | ×1 | ×2 | ×3 | ×4 | ×5 | ×6 |
| --- | --- | --- | --- | --- | --- | --- |
| **1** | 100 | 200 | 1000 | 2000 | 4000 | 8000 |
| **2** | – | – | 200 | 400 | 800 | 1600 |
| **3** | – | – | 300 | 600 | 1200 | 2400 |
| **4** | – | – | 400 | 800 | 1600 | 3200 |
| **5** | 50 | 100 | 500 | 1000 | 2000 | 4000 |
| **6** | – | – | 600 | 1200 | 2400 | 4800 |

(„–“ = daná kombinace samostatně neboduje.)

### Postupky

| Kombinace | Body |
| --- | --- |
| 1-2-3-4-5 | 750 |
| 2-3-4-5-6 | 1000 |
| 1-2-3-4-5-6 | 1500 |

## Licence

Projekt je licencovaný pod [GPL-3.0](LICENSE).