# Ankety v chatu a na Discordu

> Tým se zeptá přes /poll create ve hře nebo /poll na Discordu; všichni odpoví tlačítkem ve hře nebo na Discordu a propojený hráč hlasuje jednou. Novinka 0.4, výchozí vypnuto.

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

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

## Jak se zeptat

Ve hře (oprávnění `keystone.polls.create`):

```
/poll create 2h "Asfalt, nebo beton na spawnu?" "Asfalt" "Beton"
/poll create 1d Asfalt, nebo beton na spawnu? | Asfalt | Beton
```

Dvě až šest odpovědí; délka je nepovinná (`default-length`, den; `0` nechá anketu otevřenou, dokud ji tým nezavře; nikdy déle než `longest`, 30 dní). Naráz běží nejvýš `most-open` (5) anket. `/poll close <id>` jednu ukončí dřív.

Na Discordu vezme `/poll` bota otázku, dvě až šest odpovědí a nepovinnou délku (`discord-command`, zapnuto). Nabízí se rolím z `discord-creators` a každému, kdo má Discord propojený s hráčem, který má `keystone.polls.create` - nikomu jinému, protože nepropojené jméno nic nedokazuje.

## Jak se odpovídá

- **Ve hře** dostane každý online otázku s tlačítkem pro každou odpověď a jejím dosavadním podílem; s klientskou částí Keystone je to karta oznámení se štítkem POLL. `/poll` vypíše otevřené ankety, `/poll vote <id> <n>` hlasuje příkazem (oprávnění `keystone.polls`, které má výchozí skupina).
- **Na Discordu** jde karta s tlačítky do `discord-channel` (výchozí `events` - místnost událostí z modulu Discord; `chat`, id kanálu, nebo prázdné, aby ankety zůstaly ve hře).
- **Jeden součet pro obojí.** Hráč s propojeným Discordem hlasuje jednou, ve hře nebo na Discordu, a hlas z doby před propojením se započítá.
- `change-vote` (zapnuto): hlas jde změnit, dokud anketa běží. `who-votes = linked` pustí hlasovat jen lidi s propojeným Discordem (výchozí `everyone`).
- `remind-on-join` (zapnuto): kdo se připojí, když anketa běží, a ještě nehlasoval, ji uvidí.

Když skončí (časem nebo `/poll close`), výsledek jde do hry a s `result-post` (zapnuto) na Discord jako nová karta; stará karta přijde o tlačítka tak jako tak. Vlastní ankety Discordu se nepoužívají: bot v nich za hráče hlasovat neumí.

## Nastavení

| Nastavení | Výchozí | Co dělá |
|---|---|---|
| `enabled` | false | celý modul; chce restart |
| `discord-channel` | `events` | kam jde karta s tlačítky: id kanálu, `chat` nebo `events`; prázdné nechá ankety ve hře |
| `default-length` | `1d` | délka, když ji `/poll create` neuvede; `0` = do zavření |
| `longest` | `30d` | nejdelší doba, po kterou smí anketa běžet |
| `most-open` | 5 | anket otevřených naráz |
| `who-votes` | `everyone` | `everyone` nebo `linked` |
| `change-vote` | true | hlas jde během ankety změnit |
| `remind-on-join` | true | ukázat běžící anketu hráči, který nehlasoval |
| `result-post` | true | karta s výsledkem na Discordu po skončení |
| `discord-command` | true | nabízet `/poll` na Discordu |
| `discord-creators` | prázdné | id rolí na Discordu, které se smí ptát přes `/poll` |
| `name`, `discord-colour` | prázdné, `#5865F2` | jméno na štítku karty (prázdné: jméno serveru) a barva karty na Discordu |

## Pro vlastní nástroje

`GET /v1/polls` (scope `polls.read`); `POST /v1/polls/create`, `/v1/polls/close` a `/v1/polls/vote` (scope `polls.write`) - hlas za hráče nebo za Discord id, z vlastního webu nebo bota. Každá změna je událost `PollChanged`.

## Co se ukládá

Ankety a hlasy jsou v `keystone.db` tvého serveru. Ze serveru nic neodchází kromě karet na tvém vlastním Discordu, a to jen s nastaveným `discord-channel`.
