# Moderace

> Varování, umlčení, bany a kicky s důvodem, s koncem a s obrazovkou, kterou hráč doopravdy uvidí — jeden seznam a veřejná místnost na Discordu, když chceš.

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

Bany a kicky, které mají důvod, konec a obrazovku, kterou hráč doopravdy přečte.
Všechno v `moderation.toml` a na obrazovce Players v editoru.

## Příkazy

```
/keystone ban <hráč> [na jak dlouho] [důvod]
/keystone unban <hráč>
/keystone kick <hráč> [důvod]
/keystone bans
/keystone history <hráč>
```

Doba je obyčejná délka — `7d`, `12h`, `30m`. Bez ní ban nekončí. Důvod je to, co
hráč uvidí na obrazovce, takže se vyplatí ho psát pro něj, ne pro sebe.

`/keystone bans` vypíše, co ještě stojí. `/keystone history <hráč>` vypíše
všechno, co tenhle server tomu člověku kdy udělal — i to, co už skončilo.

Oprávnění jsou `keystone.ban` a `keystone.kick`, každé zvlášť. Platí i pro
`/kick`, `/ban`, `/pardon` a `/banlist` ze hry, když je převzatý Keystone (viz
níž). Moderátor, který není operátor, **nemůže vyhodit ani zabanovat operátora**
ani nikoho v těžší skupině, než je jeho vlastní.

**Důvod hráč doopravdy uvidí.** Každý kick, ban, uzavření kvůli údržbě, restart i
neúspěšné přihlášení nejdřív dočtou, co klient právě poslal, pak pošlou důvod a
teprve potom zavřou spojení. Jinak by Linux spojení resetoval a hráč by místo
důvodu četl `Connection reset by peer`. Ban z Discordu už nikoho neodpojuje z
vlákna serveru.

## Varování

```
/warn <hráč> <důvod>
/warns                 tvoje vlastní
/warns <hráč>          někoho jiného (potřebuje keystone.warn)
```

Taky jako `/keystone warn` a `/keystone warns`. Nové v 0.4.2.

- **Důvod je povinný** a hráč ho přečte hned — nebo jednou při dalším připojení, když zrovna nebyl na serveru.
- **Zapsané se vším ostatním**: `/keystone history` ukáže každé varování s důvodem a autorem a další moderátor vidí, kolik jich už bylo.
- Varování samo nic nezavře. Je to první krok, který pravidla slibují před umlčením nebo banem.
- Právo `keystone.warn`; stejné pořadí, kdo smí trestat koho, jako u banů a umlčení, a sám sebe nikdo nevaruje.
- Webhook moderace dostane `warn` jako každý jiný trest.

## `/ban` a `/kick` ze hry

```
moderation.take-over-vanilla = true
```

**Zapnuté** (výchozí): příkazy, které mají lidem v prstech, zapisují do tohohle
seznamu, končí samy na svoje datum a ukazují obrazovku, kterou jsi napsal.

**Vypnuté**: jsou to zase příkazy hry — což znamená, že ban napsaný jako `/ban`
je pro `/keystone bans` neviditelný, nikdy nevyprší a ukáže „You are banned from
this server." Nechat to vypnuté je rozhodnutí mít dva seznamy banů.

## Obrazovka, kterou hráč uvidí

Tři z nich patří sem a všechny se dají přepsat v `operations.toml` pod `screens`:

| Obrazovka | Kdy |
|---|---|
| `screens.banned` | Ban bez konce |
| `screens.banned-until` | Ban s datem |
| `screens.kicked` | Vyhození |

Do textu se dosazuje `{reason}`, `{by}`, `{until}`, `{left}`, `{player}` a
`{appeal}`. Prázdné řádky jsou povolené a stojí za to je použít — je to jediná
věc, kterou ten člověk v tu chvíli čte.

**`screens.appeal` je adresa, kam se má odvolat**, a dosadí se do každé
obrazovky, která `{appeal}` obsahuje. Ban, ze kterého se nedá nikam napsat, je
ban, o kterém se nikdy nedozvíš, že byl špatně.

## Discord

Když je zapnutý most, ban může platit na obou stranách:

- `discord.ban.game-to-discord` — ban ve hře zabanuje i na Discordu,
- `discord.ban.discord-to-game` — a obráceně,
- `discord.ban.who-may` — čí bany na Discordu smí dosáhnout do hry.

Obojí je ve výchozím stavu vypnuté, protože je to rozhodnutí, ne pohodlí.
Podrobně na stránce [Discord](/docs/keystone/discord).

### Tresty ve veřejné místnosti

```
[punishments]
channel = "<id kanálu>"
kinds = ["warn", "mute", "ban", "kick"]
name-staff = true
```

V `discord.toml` (0.4.2). Každé varování, umlčení, ban a kick se v té místnosti řekne jedním řádkem — kdo, kým, na jak dlouho a proč — a stejně tak zrušený ban nebo umlčení. `kinds` vybere které; s `name-staff = false` místo moderátora stojí „tým". Jména a důvody přijdou tak, jak jsou napsané, nikdy jako formátování, a nic tam nikoho nezmíní. Prázdný `channel` neříká nic.

## Umlčení

```
/mute <hráč> <doba> [důvod]      30m, 12h, 7d nebo forever
/unmute <hráč>
/mutes
```

Taky jako `/keystone mute`, `/keystone unmute` a `/keystone mutes` (když `/mute` drží jiný mod). Právo `keystone.mute`, ověřuje se znovu při každém spuštění.

- **Do stejného seznamu jako bany:** `/keystone history` ukáže každé umlčení s důvodem, autorem a koncem; `GET /v1/mutes` (`players.read`) vypíše ta platná. Skončí samo na své datum — nic si nemusí pamatovat, že ho má zrušit — a přežije restart i odpojení.
- **Co zavře:** chat hráče, příkazy z `mute.blocked-commands` (výchozí `/msg`, `/tell`, `/w`, `/whisper`, `/me`, `/r`, `/reply`, `/teammsg`, `/tm` — poštu nebo party chat jiného modu přidáš jménem), cedulky a knihy (`mute.signs-and-books`) a to, co jeho **propojený Discord účet** píše do mostovaného kanálu. Při každém pokusu se dozví důvod a kolik zbývá. Discord most ztlumenou zprávu vůbec neuslyší.
- **Nikdy na výš postaveného:** nikdo neztlumí hráče v těžší skupině ani operátora (pokud sám není operátor), ani nikoho s `keystone.mute.exempt`. Umlčení od někoho výš **zruší jen on**: `/unmute` tě odmítne a řekne kdo. Vlastní umlčení nikdo nezruší. Konzole může všechno.
- Druhé `/mute` nahradí první, nesčítá se.
- `mute.enabled = false` celé vypne (po restartu).
