# Filtr sprostých slov

> Sprostá slova se změní na kachny a bramboráky, body za každé vedou k přátelskému varování a pak k čím dál delším mute, nadávky na rasu a výhrůžky se nezobrazí vůbec - s vlastními seznamy, API, událostmi a podepsaným webhookem. Novinka 0.4, výchozí vypnuto.

Source: https://stygion.eu/cs/docs/keystone/swear-filter
Updated: 2026-11-16

Modul `filter`, novinka Keystone 0.4. Je vypnutý, dokud v `config/keystone/filter.toml` (nebo v **Settings**) nenastavíš `enabled = true` a nerestartuješ server - `enabled` modulu se čte jednou, při startu serveru.

## Co vidí hráči

Sprosté slovo v chatu se změní na něco neškodného a hloupého - `kachna`, `bramborák`, `okurka`, `knedlík` česky, `duck`, `potato`, `pickle` anglicky. Velká písmena zůstanou: `KURVA` je `KACHNA`. Zbytek zprávy se nemění.

Totéž platí:

- pro **Discord bridge** oběma směry (`where.discord`); těžká nadávka z Discordu se do hry nepřenese vůbec;
- pro **cedulky a knihy** (`where.signs-and-books`): cedulka se sprostým slovem se nezapíše a hráč se dozví proč.

Co hráč napsal, se nikdy nepřepisuje. Slova se mění až při kreslení řádku, pro každého čtenáře zvlášť - server tak může nechat tým číst originál (`original = staff` a oprávnění `keystone.filter.original`). Výchozí je `nobody`: všichni čtou náhrady. Rozhoduje server, ne hráč.

## Body, varování, mute

| Co se stane | Výchozí | Nastavení |
|---|---|---|
| Body za každé chycené slovo | 1, nejvýš 3 za zprávu | `points.per-word`, `points.most-per-line` |
| Body samy mizí v klidu | 1 za 10 minut | `points.decay-by`, `points.decay-every` |
| Soukromé přátelské varování | při 3 bodech (jednou za stoupání) | `points.warn-at` |
| Mute | při 5 bodech, pak se body počítají znovu | `points.mute-at` |
| Každý další mute od filtru v okně je delší | 5, 15, 60 minut | `mute.lengths`, `mute.window` (24h) |
| Tým dostane ticket | při 3. mute od filtru v okně | `ticket-after` |

Ztlumený hráč vidí proč a na jak dlouho, jako u každého `/mute`; mute platí i pro soukromé zprávy, `/me`, cedulky, knihy a zprávy jeho propojeného Discord účtu do hry.

**Rasistické nadávky a výhrůžky** (těžké seznamy) body přeskočí: zpráva se **nezobrazí vůbec**, pisatel dostane mute hned (`severe.mute`, 60 minut, nebo víc podle žebříčku) a tým záznam: obrazovka *Moderation* v editoru, `GET /v1/moderation/caught`, webhook a s `alert-channel` i post na Discord. Text se uchová jen u těžkých zpráv (`keep-text`); běžné nadávky se neukládají nikdy.

Kdo má `keystone.filter.exempt`, body nesbírá (slova se mu ale nahrazují).

## Seznamy

Jar nese seznamy pro angličtinu (`en`) a češtinu se slovenštinou (`cs`); `languages` vybírá, které se použijí, a každý seznam se zkouší na každou zprávu. `built-in = false` = jen vlastní.

| Nastavení | Co |
|---|---|
| `words.mild` | vlastní sprostá slova: nahradit a počítat |
| `words.severe` | vlastní slova, která se nezobrazí nikdy |
| `words.allowed` | slova, která se nechytí nikdy, i když na ně nějaká položka sedí |
| `funny.en`, `funny.cs` | na co se chycená slova mění; prázdné = vestavěná |

Jak je položka napsaná, určuje, kolik chytí - proto projde *Scunthorpe*, *kokos* i *sranda*:

- `slovo` - jen celé slovo;
- `kmen*` - slovo, které tím začíná (`kurv*` chytí *kurvy*, *kurvou*);
- `*část*` - kdekoli ve slově, jen pro kmeny, které nic nevinného neobsahuje;
- `dvě slova` - za sebou (`zabij se`);
- `slovo=náhrada` - vlastní náhrada.

Filtr před porovnáním vrátí obvyklé triky: diakritiku (`kůrvá`), podobná písmena z jiných abeced (cyrilské `к`, stejně jako `/nick`), široká a stylizovaná písmena, l33t (`sh1t`, `a$$`), `*` místo písmena, zdvojená písmena (`kurvaaa`), písmena oddělená mezerami či tečkami (`k u r v a`) a slovo rozdělené na dvě (`kur va`).

`/keystone filter test <zpráva>` (a pole na obrazovce *Moderation*) zkusí zprávu, aniž by ji kdo viděl nebo se počítala. `/keystone filter points <hráč>` a `/keystone filter clear <hráč>` ukážou a smažou body (oprávnění `keystone.filter`).

## Formát chatu a jiné mody

Aby šel řádek měnit pro každého čtenáře, píše ho se zapnutým filtrem Keystone sám - ve tvém formátu, nebo ve výchozím, když je `chat.format.enabled` vypnuté. Když chat formátuje jiný mod a `chat.step-aside` je zapnuté, Keystone ustoupí a filtr slova nenahradí (konzole to jednou řekne); vypni `chat.step-aside`.

## Pro vlastní nástroje

Filtr nezná žádný konkrétní server. Všechno, co rozhodne, oznámí:

- **Události** pro mody: `SwearCaught` (kdo, kde, jak vážné, k čemu to vedlo), `MuteRequested` / `MuteLiftRequested` (požádat o mute nebo jeho zrušení; odpoví modul moderace), `PlayerPunished` se zdrojem `filter` u každého mute od filtru.
- **API** (klíče s `moderation.read` / `moderation.write`): `GET /v1/moderation/mutes`, `GET /v1/moderation/history?player=`, `POST /v1/moderation/mute` (`player`, `for`, `reason`), `POST /v1/moderation/unmute`, `GET /v1/moderation/points`, `GET /v1/moderation/caught`, `POST /v1/moderation/points/clear`, `GET /v1/moderation/words`, `POST /v1/moderation/check`.
- **Webhook** (`moderation.toml`): `webhook.url` (https mimo tvou síť; `webhook.allow-local` pro bota na stejném stroji), `webhook.secret`, `webhook.events` (warn, mute, unmute, ban, unban, kick, swear). Každý POST je JSON s `X-Keystone-Timestamp` (sekundy) a `X-Keystone-Signature: sha256=<hex HMAC-SHA256 z "<timestamp>.<tělo>" klíčem>`; přepočítej a staré časy odmítni. Událost `swear` nese text jen u těžkých zpráv.

## Mute a Discord timeout

V `discord.toml`, stejně jako bany: `mute.game-to-discord` dá propojenému hráči na Discordu timeout na stejně dlouho (Discord dovolí 28 dní; delší mute nebo bez konce přidá roli `mute.role`), `mute.discord-to-game` ztlumí hráče, kterému dali timeout na Discordu. Zrušení na jedné straně ruší obě, v ledgeru je to jeden záznam. Obojí výchozí vypnuto; bot potřebuje oprávnění **Moderate Members** a roli nad těmi, komu timeout dává.

## Soukromí

Filtr čte chat, zprávy přes Discord bridge, cedulky a knihy jen na tvém serveru; nikam nic neposílá, dokud nenastavíš webhook nebo kanál pro alerty. Text těžkých zpráv zůstává v `keystone.db`, dokud je zapnuté `keep-text`.
