STYGION Dokumentace Hledat v dokumentaci

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.

Keystone 0.5.0 Aktualizováno 4 min čtení
Na téhle stránce 7 částí
  1. Co vidí hráči
  2. Body, varování, mute
  3. Seznamy
  4. Formát chatu a jiné mody
  5. Pro vlastní nástroje
  6. Mute a Discord timeout
  7. Soukromí

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.

Pomohla vám tahle stránka?

Otevře panel zpětné vazby s touhle stránkou v příloze. Přistane do jedné fronty se vším ostatním.