# První kroky

> Dej si oprávnění, otevři editor a zapni ty části, které chceš.

Source: https://stygion.eu/cs/docs/keystone/first-steps
Updated: 2026-10-09

Keystone začíná skoro se vším vypnutým. Je to schválně: mod, který na serveru, co v životě neviděl, zapne jedenáct funkcí, je mod, jehož vypínáním strávíš první večer.

## Jedna věc, co je dobré vědět hned

**Být operátorem Minecraftu není totéž co smět používat Keystone.** Má vlastní oprávnění, aby „smí restartovat server" a „smí létat" byly dvě různé otázky. Z konzole umíš všechno už teď — konzole smí vždycky — takže se začíná tam.

**Od 0.1.1** skupina `admin` s `keystone.*` na serveru už je, prázdná, takže stačí jedna řádka:

```
keystone permission group admin add <tvoje jméno>
```

**Na 0.1.0** žádná skupina `admin` neexistuje — jediná, která tam je, je `default` a jsou v ní všichni — takže se nejdřív musí vyrobit:

```
keystone permission group admin create 100
keystone permission group admin allow keystone.*
keystone permission group admin add <tvoje jméno>
```

První řádka tu skupinu vyrobí s váhou 100, druhá jí dá všechno a třetí do ní přidá tebe. Od téhle chvíle ti `/keystone` funguje i ve hře.

`keystone permission groups` vypíše, co existuje, a `keystone permission check <hráč> <oprávnění>` odpoví, proč někdo smí nebo nesmí.

## Otevři editor

```
/keystone panel
```

Dá ti odkaz. Klikneš a celý mod se dá nastavit v prohlížeči — editor je uvnitř souboru, který jsi stáhl, takže funguje bez internetu a není k němu účet ani heslo. Odkaz platí pět minut, funguje jednou a vymění se za klíč, který platí den.

Lokální API poslouchá ve výchozím stavu na `127.0.0.1`, takže odkaz otevřeš ze stroje, kde server běží. Odjinud přes SSH tunel — a od 0.1.1 přes `api.reachable-at`, viz [Panel](/docs/keystone/panel).

## Než začneš něco měnit, rozhlédni se

- **Performance** — `/keystone test 20` postaví dvacet testovacích hráčů, změří kolem nich server a řekne ti, kolik lidí tahle mašina s tvým modpackem doopravdy unese a co povolí první. Trvá to pár minut a na novém serveru je to nejužitečnější věc, kterou můžeš udělat.
- **Console** — posledních pár set řádek a vedle nich chat, takže nemusíš na SSH, abys viděl, co se stalo.
- **Players** a **Groups** — kdo tu byl a co smí.

## Zapni si, co chceš

Každá z těchhle věcí je vypnutá, dokud neřekneš jinak, a každá je jedna obrazovka v editoru:

- **[Provoz](/docs/keystone/operations)** — restarty, které se dějí, jen když je co získat, zálohy, které sdílejí to, co se nezměnilo, úklid, který nejdřív slévá a teprve pak maže, a oznámení, která vědí, komu patří. Zálohy jsou vypnuté, dokud neřekneš kam — kam patří, může rozhodnout jen člověk, který ví, kolik má disků.
- **[Discord](/docs/keystone/discord)** — chat oběma směry, role, které následují povýšení, ban, který platí na obou stranách, konzole v kanálu, stav serveru, tickety a způsob, jak někdo dokáže, že účet je jeho (`/discord link` ve hře, `/link <kód>` na Discordu). Chce to token bota a bot potřebuje zapnuté Message Content a Server Members tam, kde jsi ho vyrobil.
- **[Hlasy](/docs/keystone/ranks-and-votes)** — oba protokoly, které hlasovací weby používají, naráz, takže to funguje na všech, ne na polovině. Hlas, který přijde, když je člověk pryč, se schová a vyplatí, až se příště připojí.
- **[Hodnosti za hraní](/docs/keystone/ranks-and-votes)** — povýšení za odehrané hodiny.
- **[Bedny](/docs/keystone/crates)** — klíč za každý den na serveru. Vypnuté, dokud v `crates.toml` nenapíšeš `enabled = true` a nevyplníš, co v bednách je.
- **[Území](/docs/keystone/territory)** — když server má FTB Chunks: víc claimů podle hodnosti a času a `/fly` nad vlastními claimy.
- **[Essentials](/docs/keystone/essentials)** — `/spawn`, warpy a `/vanish`.
- **[Jazyk hráče](/docs/keystone/languages)** — každý si vybere jazyk; ty napíšeš překlad v editoru.
- **[Účty](/docs/keystone/accounts)** — na offline serveru heslo, otázka na Discordu, nebo obojí.
- **[Skiny](/docs/keystone/skins)** — skutečné obličeje na offline serveru a `/skin` z odkazu.
- **[Moderace](/docs/keystone/moderation)** — bany, kicky a obrazovka, kterou hráč uvidí.
- **[Asistent](/docs/keystone/assistant)** — vypnutý, dokud ho nenamíříš na model. Čte čísla tvého serveru a odpovídá na otázky o nich; cokoliv chce změnit, navrhne, a rozhodneš ty.

## Všechno jde čtyřmi cestami

Ať nastavíš cokoliv, totéž se dá udělat ze souboru, z konzole, z editoru i přes rozhraní. Nic není funkce jen pro prohlížeč — což se hodí ve dvě ráno, kdy prohlížeč je zrovna to jediné, co nemáš.

A každá změna nastavení je zapsaná i s tím, jaká byla hodnota předtím, takže `/keystone set history` a `/keystone set undo <číslo>` existují pro ten večer, kdy se ukáže, že to byl špatný nápad.