# Tickety

> Otevřený ve hře nebo na Discordu jedním příkazem, zodpovězený tam, kde je tvůj tým, volitelně přeposlaný do vlastní fronty, a konverzace přežije zavření.

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

Hráč napíše `/ticket <co se děje>` a ticket je otevřený. Tvůj tým odpoví — ve
hře přes `/tickets`, nebo v soukromém discordovém kanálu, který se u toho
otevřel. Obojí je ta samá konverzace.

## Bez učení syntaxe

Nové v 0.2.6. `/ticket <co se děje>` otevře ticket hned, druh určuje `default-kind`;
`/ticket bug …` druh dál volí. `/bug` a `/feedback` jsou vlastní příkazy
(`shortcuts`). Odpověď přijde hráči do hry se zvukem, hned, nebo při příštím
připojení.

## Co se nastavuje

`tickets.toml`:

- `kinds` je, co smí kdo otevřít a k čemu to je. Výchozí jsou `help`, `bug` a
  `report`; za šipkou u každého se píše popis, který hráč uvidí, když si ho
  vybere.
- `limit-per-person` je, kolik jich smí mít někdo otevřených naráz. Výchozí tři.
- `cooldown` zabrání tomu, aby ten samý člověk otevíral jeden každou vteřinu.

`discord.tickets.category` dá kanály ticketů do té kategorie a
`discord.tickets.roles` je, kdo na Discordu na ně vidí a smí odpovídat. Bez
kategorie zůstane discordová půlka vypnutá a tickety jsou čistě herní věc —
což je taky v pořádku.

**Veřejné fórum pro některé druhy** (od 0.3.4). V `discord.toml`:

- `tickets.forum` je id fórového kanálu; prázdné to vypne.
- `tickets.forum-kinds` vyjmenuje druhy, které tam půjdou (výchozí `["feedback"]`).
- `tickets.forum-tags` vyjmenuje id štítků fóra, které dostane každý příspěvek, nejvýš 5.

Ticket druhu z fóra (`/feedback <text>`) se stane veřejným příspěvkem v tom fóru, s první řádkou jako názvem, který si může přečíst a odpovědět na něj kdokoli. Odpovědi dojdou hráči do hry stejně jako z kanálu ticketu. Zavření ticketu příspěvek zamkne a zachová. `/ticket` zůstává soukromý kanál. Bot potřebuje ve fóru Create Posts a Manage Threads.

Každá karta ticketu, v kanálu i v příspěvku ve fóru, má tlačítko **Close ticket**. V soukromém kanálu ho smí stisknout každý, kdo kanál vidí; na příspěvku ve fóru jen ten, kdo ticket otevřel (s propojeným účtem), a členové, kteří smějí spravovat vlákna nebo kanály.

## Přeposílání do jiné fronty

Nové v 0.2.6, výchozí vypnuto. S nastaveným `tickets.forward.url` se každý
ticket, řádek i zavření pošle tam jako JSON, s `tickets.forward.key` jako
bearer tokenem. Co se nedoručí, se drží a zkouší tři dny. Odpovědi se vrací
přes `POST /v1/tickets/reply` a `POST /v1/tickets/close` (rozsah klíče
`tickets.write`).

**`verified`** (od 0.3.4): událost `opened` nese `"verified": true` jen tehdy, když
je jméno hráče v tomhle sezení prokázané — server běží v online módu, nebo modul
accounts jméno potvrdil na Discordu u účtu, který je tam propojený. Heslo se
nepočítá: prokazuje jméno tomuhle serveru, ne cizímu účtu jinde. Na druhé straně
ticket s `"verified": false` nikdy nepřiřazuj k účtu člověka; na offline serveru
si kdokoli napíše jakékoli jméno.

Jsou to data odcházející ze stroje, proto je to hlídané: adresa musí být https
na internetu a nastavit ji smí jen vlastník; loopback, LAN, link-local a jména,
která tam vedou, se odmítnou, pokud není `tickets.forward.allow-local`;
přesměrování se nikdy nenásledují; log ukazuje jen schéma a hostitele.

## Přepis

**Zavření ticketu ho nesmaže.** Celá konverzace zůstane uložená v modu, takže
hlášení, které se za měsíc vrátí, má svoji historii, a odpověď, kterou někdo
dal, se dá najít znovu. Discordový kanál se po zavření smaže — je to okno do
ticketu, ne ticket sám. To je rozdíl mezi ticketem a zprávou v chatu.

## Hlášení na lidi

`report` je druh jako každý jiný, ale nahlášenému se to neřekne a do kanálu
nevidí. Co následuje, je [moderace](/docs/keystone/moderation) — ban nese svůj
důvod a toho, kdo ho dal, a hráč ten důvod vidí na obrazovce, která se mu ukáže.
