# Kity

> Startovní kit při prvním připojení a /kit s čekáním mezi dvěma — denní pro všechny, větší pro ranky. Nové v 0.2.4, výchozí vypnuto.

Source: https://stygion.eu/cs/docs/keystone/kits
Updated: 2026-10-10

Modul `kits`, soubor `kits.toml`. **Vypnutý, dokud ho nezapneš** (`enabled = true` v `kits.toml` nebo obrazovka Nastavení; platí po restartu) — věci zadarmo mění, jak se na serveru hraje.

## Co dělají hráči

- `/kit` vypíše kity, které si smí vzít, a kdy bude který znovu; `/kit <název>` si jeden vezme. Tab nabízí jen ty jejich.
- Kit označený `first-join` přijde sám při úplně prvním připojení.
- Čekání se drží **podle účtu v databázi**: odpojení a připojení, reload ani restart nikomu nedají druhý kit. Zapíše se dřív, než se věci rozdají, takže kit, který se napůl nepovede, je o kit méně, nikdy o kit víc.
- Kit, který jim nepatří, vypadá úplně stejně jako kit, který neexistuje.

## Jak kity napsat

Tři seznamy:

```toml
kits = ["starter once first-join", "daily 24h", "vip 24h groups=vip", "legend 24h groups=legend"]
items = [
  "starter minecraft:stone_sword",
  "starter minecraft:bread 16",
  "daily minecraft:bread 8",
  "vip minecraft:diamond_sword[enchantments={levels:{'minecraft:sharpness':3}}] 1",
]
commands = ["legend crate give {player} 1"]
```

- **`kits`** — název, jak často (`24h`, `7d` nebo `once`), pak volitelně `first-join` a `groups=a,b`: kdo si ho smí vzít kromě držitelů `keystone.kit.<název>`. Počítají se i zděděné skupiny, takže rank, který dědí `vip`, dostane i VIP kit.
- **`items`** — kit, pak předmět **tak, jak ho bere `/give`**: id, komponenty v hranatých závorkách (enchanty, jméno, cokoli, co přidá mod), počet. Řádek kontroluje sama hra; ten, který odmítne, se objeví v logu serveru a zbytek dorazí. Do plného inventáře se zbytek vysype k nohám, jako u `/give`.
- **`commands`** — kit, pak příkaz, který spustí konzole, s `{player}` a `{uuid}`. Na peníze, rank na týden, klíč od bedny. `{player}` je id účtu, kdykoli jméno není obyčejné, takže jméno nikdy nepropašuje selektor jako `@a`.

## Práva

- `keystone.kit` — příkaz (skupina `default` ho má od prvního startu).
- `keystone.kit.<název>` — jeden kit, pokud ho už nepovolí jeho `groups=`.
- `keystone.kit.give` — `/keystone kits give <hráč> <kit>`: předá kit hned, bez ohledu na čekání a bez spuštění nového.

## V editoru a přes API

Obrazovka **Kity** ukáže každý kit, jak často, pro koho a co obsahuje, s odkazy na tři nastavení. `GET /v1/kits` (`server.read`) odpoví totéž.