STYGION Dokumentace Hledat v dokumentaci

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.

Keystone 0.5.0 Aktualizováno 2 min čtení
Na téhle stránce 5 částí
  1. Jak se zeptat
  2. Jak se odpovídá
  3. Nastavení
  4. Pro vlastní nástroje
  5. Co se ukládá

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):

Kód
/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.

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.