# Oslavy: nová hodnost nahlas

> Když někdo dostane hodnost - koupenou, darovanou nebo jak si zvolíš - slyší to celý server, a čím vyšší hodnost, tím hlasitěji: řádek, titulek, ohňostroj. Novinka 0.2.7, výchozí vypnuto.

Source: https://stygion.eu/cs/docs/keystone/celebrations
Updated: 2026-11-12

Modul `celebrate`, soubor `celebrate.toml`. **Výchozí vypnuto**: aktualizace nikdy sama nerozhodne, že hodnost je novinka. Zapni ho a napiš, co se má slavit.

## Co se slaví

`ranks` má řádek na skupinu, `skupina | úroveň | text`:

```toml
ranks = [
  "vip | 1 | &a{player} is VIP now - thank you!",
  "vip-plus | 2 | &b{player} is VIP+!",
  "legend | 3 | &6&l{player} is a LEGEND!",
]
```

- **Úroveň 1** — řádek v chatu a zvuk pro všechny.
- **Úroveň 2** — navíc titulek na každé obrazovce.
- **Úroveň 3** — navíc příkazy `fireworks` kolem hráče a druhá vlna zvuku.

`{player}` je jeho jméno, `{rank}` jméno skupiny. Počítá se jen skupina, kterou hráč ještě neměl. Kdo je offline, když hodnost přijde (třeba koupená na webu), dostane oslavu při příštím připojení.

Texty jsou na tobě: hráči je čtou v chatu, takže napiš oslavu v jazyce svého serveru (nebo `[en]…[cs]…`).

## Odkud

`sources` říká, které cesty k hodnosti se počítají: `shop`, `vote`, `quest`, `admin`, `playtime`, `config`, `other` — nebo jedna přesně jako `druh:detail`, třeba `other:<jméno klíče>` pro obchod, který dává hodnosti přes API vlastním klíčem. Výchozí je jen `shop`: hodnost daná ručně nebo vyhraná hraním není nákup.

## Dárky

`gifts` má řádek na skupinu, `skupina | text`, s `{from}` pro dárce — `vip | &a{player} got VIP from {from}!`. Použije se, když to, co hodnost dalo, řeklo od koho (`from` v `POST /v1/players/group`); jinak platí řádek z `ranks`. Dárek má stejnou úroveň, zvuk i ohňostroj.

## Zvuk, ohňostroj, Discord

- `sounds` — zvuk, který slyší všichni na každé úrovni, `úroveň | zvuk` (level-up na 1, zvuk výzvy na 2 a 3).
- `fireworks` — příkazy konzole na úrovni 3 kolem hráče; výchozí jsou dva ohňostroje a funguje cokoli, co konzole umí (částice, zvuk, odměna).
- `discord-channel` — pošli to i na Discord: id kanálu, `chat` pro chatovou místnost mostu nebo `events` pro jeho místnost událostí. Prázdné = jen hra; potřebuje modul Discord.

Všechno je nastavení a platí bez restartu. Každé nastavení s výchozí hodnotou je na stránce [Všechna nastavení](/docs/keystone/settings-reference).
