# Nastavení

> Čtyři cesty, jak změnit tu samou věc, jeden soubor na modul a žádný restart.

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

## Čtyři dveře, jedna místnost

Každé nastavení jde změnit čtyřmi cestami a všechny zapisují stejnými dveřmi:

- **editorem** — `/keystone panel`, obrazovka Settings,
- **konzolí** — `/keystone set <jméno> <hodnota>`,
- **souborem** — `config/keystone/<modul>.toml`,
- **lokálním API** — pro tvoje vlastní nástroje.

Uložení se projeví hned. Nic z toho nepotřebuje restart a nikoho to nevyhodí.

## Kde bydlí

Jeden soubor na modul, v `config/keystone/`:

| Soubor | Co drží |
|---|---|
| `keystone.toml` | Samotný mod: ladicí log, maskované příkazy, adresa a port lokálního API, jazyk (`[language]`), chat (`[chat]`) a sledování chyb (`[errors]`). |
| `discord.toml` | Most: token, server, kanály, propojení účtů, bany, zrcadlo konzole, upozornění, stav serveru. |
| `operations.toml` | Restarty, zálohy, úklidy, oznámení a obrazovky, které lidi vidí při vyhození nebo když je server zavřený. |
| `progress.toml` | Hodnosti za odehraný čas. |
| `votes.toml` | Naslouchání hlasům, které hlasy se počítají, odměny, série a společné cíle. |
| `crates.toml` | Denní bedny: klíče, šance, odměny a předměty s vlastním vzhledem. Vypnuté, dokud majitel neřekne `enabled = true`. |
| `territory.toml` | Claimy z FTB Chunks: bonusy podle hodnosti a času, `/fly`. |
| `essentials.toml` | `/spawn`, warpy, homes, `/rtp`, `/tpa`, `/back` a `/vanish`. |
| `tickets.toml` | Druhy ticketů, kolik jich najednou, prodleva. |
| `accounts.toml` | Jak se na offline serveru dokazuje, že účet je něčí. |
| `skins.toml` | Skutečné skiny na offline serveru. |
| `moderation.toml` | Bany a to, jestli je `/ban` a `/kick` z hry vede sem. |
| `tablist.toml` | Co ukazuje tab list. |
| `bench.toml` | Zátěžový test a co z něj odchází. |
| `assistant.toml` | Model pro asistenta ve hře. |

Překlady jsou vedle, v `config/keystone/lang/<kód>.properties` (viz [Jazyk hráče](/docs/keystone/languages)).

Každý soubor se zapisuje i s komentáři. **Ten soubor je ta příručka** — co
nastavení znamená, stojí hned vedle něj, ne v tabulce, kterou by někdo musel
držet v souladu. Vypnutý modul svoje nastavení ukazuje taky (pod poznámkou, že je
vypnutý), takže jde připravit dřív, než se zapne; výjimku dělají provoz, moderace,
skiny, tab list a asistent, které ve vypnutém stavu ukážou jen `enabled`.

## Jméno je celá cesta

`/keystone set bench.radius 512` — modul, pak nastavení, tečky oddělují sekce.
`discord.link.required-to-join`, `operations.restart.when`,
`operations.clean.over-entities`, `bench.share-live`. **Zkrácené jméno bez
modulu konzole nezná** a odpoví seznamem toho, co existuje nejblíž. Editor
ukazuje ta samá jména, takže věc, kterou ti někdo poradí změnit, je věc, kterou
umíš napsat.

`/keystone set` bez hodnoty řekne, jak to je teď; `/keystone set` bez ničeho
vypíše všechno.

## Past: výchozí hodnota, která se pohnula

**Změněný default se nepropíše na server, který má uloženou starou hodnotu.**
Jakmile je nastavení jednou v souboru, je to odpověď toho serveru, a novější
verze Keystone s lepším defaultem na tom nezmění nic. Nás to 6. 9. 2026 stálo dvě
špatná měření: `bench.radius` zůstal na 256 na serveru, kterému se default mezitím
pohnul, a přišlo se na to až podle divných čísel.

Když jedeš podle rady, co říká „default je teď X", podívej se nejdřív, co říká
tvůj vlastní soubor.

## Vrácení zpátky

```
keystone set history
keystone set undo <číslo>
```

Každá změna je zapsaná i s tím, kdo ji udělal, odkud a jaká byla hodnota
předtím. U tajemství se stará hodnota nikdy neschovává — jen se řekne, že se
vyměnila.

## Co se nikdy nepíše ven

Tajemství jsou hodnoty jako každá jiná a bydlí v těch samých souborech — proto
`config/keystone/` patří do záloh a **ne** do veřejného repozitáře. Keystone
maskuje svoje vlastní citlivé příkazy z logů, konzole i auditních řádků;
`keystone.mask-commands` přidá i cizí, když má nějaký mod příkaz, co bere heslo.