Discord bot

The Rook Průvodce pro hráče, vypravěče i správce

The Rook je Discord bot pro správu TTRPG serveru od prvního oznámení hry až po dlouhodobou údržbu kampaní. Hráčům dává rychlé hody, postavy, životy a seznam přání; GMům pomáhá zakládat herní kanály, plánovat termíny, připomínat sezení a držet pohromadě postavy v konkrétní hře; správcům přidává přehledy (ne)aktivity, správu rolí pomoc reakcí, automatické uvítání a provozní nástroje.

Bot je navržený hlavně pro opakované používání přímo v Discordu. Místo jednorázových zpráv často vytváří stálé panely s tlačítky: roll panel pro hody, clock dashboard pro progress clocks, GM panel pro práci s herním kanálem nebo gameroom panel s termínem a seznamem postav. K panelům se dá vracet stejně jako k běžným zprávám v kanálu.

Oblast	Co The Rook umí
Hody	Obecný dice parser, tajné hody, počítání úspěchů, Lex Arcana, osobní a sdílené roll panely, trvalé tabulky výsledků a progress clocks.
Hry a termíny	Jednorázové i opakované termíny, připomínky před sezením, RSVP tlačítka, přehled příštích her a oznámení nové hry.
Postavy	Postavy a aliasy po kanálech, automatické herní přezdívky, poznámky k postavám, portréty, party karta a sledování HP včetně více slotů.
GM nástroje	Zakládání herních kanálů, správa herních rolí, archivace vláken a kanálů, gameroom panel pro každou hru a rychlé nástroje pro ping hráčů.
Komunita	Seznam přání her, role podle reakcí, uvítací zprávy, dočasná ikona serveru a omezené role pingy pro nabídky her.
Provoz	Týdenní reporty, grafy, statistiky hodů, kontroly neaktivních kanálů, stav bota, logy a údržba databáze.

Rychlý start v Discordu

Tato stránka slouží jako kompletní průvodce. Přímo v Discordu je nejrychlejší začít příkazem /help, který zobrazí stručnou nápovědu a odkaz sem.

Začněte lomítkem

Do textového kanálu napište / a začněte psát název příkazu, například roll, nextgame nebo mycharacter. Discord ukáže dostupné parametry i krátký popis. Na serveru může být víc botů se stejnými příkazy. Zkontrolujte si, že mluvíte s The Rook.

Využívejte návrhy

U polí označených jako 🔍 návrhy napište pár písmen a vyberte položku z nabídky. U polí označených jako ▾ výběr ze seznamu je potřeba vybrat jednu z nabízených možností.

Všímejte si viditelnosti

Některé odpovědi bota jsou v kanálu zveřejněny pro všechny, jiné jsou soukromé a vidíte je jen vy. Soukromé odpovědi se hodí pro nápovědu, tajné hody, nastavení postavy nebo administraci. Bot má většinou nastaveno, zda jsou jeho odpovědi veřejné nebo soukromé. Viditelnost nicméně můžete u nastavení hodů.

Panely slouží opakovaně

Příkazy jako /rt2, /clocks, /gming a /gameroom vytvářejí stálé zprávy s tlačítky. Používejte původní panel místo zakládání dalších kopií.

První užitečné příkazy Hráč: /help, /r dice:1d20, /mycharacter set, /hp, /wish add.
GM: /gming pro založení hry, /gameroom pro panel v herním kanálu, /nextgame set nebo /nextgame recurring pro nastavení termínu hry.
Správce: /status, /weeklyreport, /reactionrole, /welcome.

Přehled příkazů

Všechny příkazy jsou slash příkazy (začínají /) a fungují v textových kanálech serveru. Některé GM příkazy vytvoří stálý interaktivní panel s tlačítky, ke kterému se dá později vracet.

Příkaz	Pro koho	Co dělá
Hráč
/roll, /r	Hráč	Obecný hod kostkami; `dice:lex 25` spustí Lex Arcana hod
/lex	Hráč	Lex Arcana hod — s parametry hodí rovnou, bez nich otevře dialog
/lexplan	Hráč	Doporučí optimální kostky pro Lex Arcana bez samotného hodu
/rt	Hráč	Panel s tlačítky pro hod — panel vidíte pouze vy, výsledky hodů jsou veřejné
/rt2, /rt3	Hráč	Veřejný persistentní panel — hody se zapisují do téže zprávy
/rollcustom	Hráč	Správa vlastních tlačítek pro /rt panel (add, remove, list)
/clocks	Hráč	Progresivní hodiny (progress clocks) ve stylu Blades in the Dark
/mycharacter	Hráč	Správa vlastní postavy v kanálu (set, show, on, alwayson, off, autorename, clear)
/hp	Hráč	Sledování životů postavy — nastavení, úprava, více slotů (postava + přivolání apod.), zobrazení s barevným indikátorem
/hpview	GM / Admin	Zobrazí životy hráčů v kanálu nebo napříč serverem
/armory	Hráč	Sdílené zásoby, výpůjčky, vracení a oznámení zničených předmětů
/goals	Hráč / GM	Společné a hráčské cíle, dokončení, obnovení a stálá nástěnka
/wish add, remove, mine, clear	Hráč	Přání her — přidání, odebrání, přehled, smazání vlastního seznamu
/wish random, ping	Hráč	Losování náhodného přání, ping hráčů kteří si přáli danou hru
/ping	Hráč	Bezpečně označí vybranou roli; běžný člen nejvýše jednou za hodinu
/autojoin	Hráč	Zapne, vypne nebo zobrazí vlastní automatické připojování k dostupným veřejným vláknům
/mystats	Hráč	Vaše statistiky hodů kostkami za celé období, aktuální týden nebo dnešek
/gamealias mine	Hráč	Zobrazí vaše vlastní přezdívky postav
/help	Hráč	Nápověda inline v Discordu
GM
/gming	GM	Správa herního kanálu — vytvoření, role, archivace
/gameroom	GM	Herní panel — termíny, upozornění, postavy; hráči si z panelu nastavují vlastní postavu a přezdívku
/nextgame	GM	Nastavení, přesun, připomínky, role a historie termínů hry v kanálu
/gamealert	GM	Oznámení o nové hře do novinky (ping role)
/secret	GM	Soukromě odhalovaná tajemství a přehled hráčů, kteří je četli
/gmchannel	GM	Vytvoří herní textový kanál v kategorii Probíhající hry
/partycard	GM	Vygenerování karty s profilem celé skupiny
/sortchannels	GM	Seřazení kanálů v kategorii abecedně
/archive	GM	Přesun kanálu nebo vlákna do kategorie Archive
/gmrole, /gmrole-add, /gmrole-remove, /gmrole-list	GM	Vytvoření a správa bezpečných žlutých herních rolí
Admin
/gamealias	Admin	Správa postav, portrétů a herních přezdívek (subpříkaz mine nemá omezení, ostatní admin)
/rttable	Admin	Správa sdílených serverových tabulek pro /rt (add, remove, clear, list)
/wishes	Admin	Přehled všech přání seskupených podle hry; volitelně s věkem a různými způsoby řazení
/wish addfor, removefor, clearfor	Admin	Správa přání za jiné hráče
/inactive, /inactivethreads	Admin	Přehled a správa neaktivních kanálů/vláken
/playing	Admin	Přehled aktivních her
/weeklyreport	Admin	Týdenní report aktivity serveru
/reactionrole	Admin	Zprávy s výběrem rolí přes reakce
/settempicon	Admin	Dočasná ikona serveru
/makegm	Admin	Ruční přidání GM role uživateli
/createchannel	Admin	Vytvoří textový kanál v zadané kategorii
/renamevoice	Admin	Přejmenuje hlasový kanál
/pinghistory	Admin	Přehled posledních /ping pokusů
/autojoinlist	Admin	Soukromý přehled uživatelů s aktivním autojoinem
/graphs	Admin	Statistiky serveru jako grafy
/summary	Admin	Obrázkové shrnutí aktivity serveru
/welcome	Admin	Nastavení uvítacích zpráv pro nové členy
/runmaintenance	Admin	Ruční spuštění údržby databáze
/log	Admin	Zobrazí posledních N řádků logu bota (zpráva viditelná pouze vám)
/status	Admin	Zobrazí stav bota — smyčky, nastavení reportu, databáze, latence

Hody kostkami

Jak funguje automatické doplňování Discord U některých parametrů Discord nabídne seznam možností při psaní. Platí dvě pravidla:
🔍 návrhy — Discord při psaní nabídne seznam možností ze serveru (existující tabulky, přání, kategorie…). Lze psát pro filtrování. U parametrů označených „nebo nový" lze zadat i hodnotu, která v seznamu není — seznam je jen orientační.
▾ výběr ze seznamu — Discord zobrazí pevný seznam možností. Musíte vybrat jednu z nabízených hodnot, volný text nefunguje.

Obecné hody — /roll, /r

/roll Hod obecnou formulí — nejpoužívanější příkaz (alias: /r)

Parametr	Typ	Popis
dice	text 🔍 návrhy — nebo nový	Výraz hodu, např. `1d20+5`, `4d6`, `10d10>=8`. Discord vždy nabídne základní kostky (d20, d12, d10, d8, d6, d4, d100) a navíc vaše uložené hody z `/rollcustom`. Lze zadat libovolný výraz.
purpose	text volitelný	Komentář k hodu (zobrazí se ve výsledku)
keep_highest	číslo volitelný	Ponechat pouze X nejvyšších hodů
keep_lowest	číslo volitelný	Ponechat pouze X nejnižších hodů
explode	bool volitelný	Kostky explodují při maximálním hodu (výchozí: ne)
secret	bool volitelný	Výsledek uvidíte pouze vy (výchozí: ne)
success_target	číslo volitelný	Počítat úspěchy od této hodnoty výše

Příklady /r dice:1d20+5 — hod d20 s bonusem 5
/r dice:4d6 keep_highest:3 — hod na vlastnosti (zahoď nejnižší)
/r dice:10d10>=8 — počítání úspěchů od 8 výše
/r dice:3d6 explode:True — explodující šestky
/r dice:1d20 secret:True purpose:Tajná akce — tajný hod s popisem
/r dice:lex 25 — Lex Arcana hod s 25 kostkovými body
/r dice:lex 25 hard — Lex Arcana s obtížností hard
/r dice:lexplan 25 — doporučení kostek bez hodu

Lex Arcana Systém Lex Arcana se ovládá přes /lex nebo /lexplan. Bez parametrů otevřou dialog; s parametrem dice_points provedou akci okamžitě (/lex 25 hard, /lexplan 25). Bot automaticky vybere optimální kombinaci kostek. /lex provede hod s osudem (explodující maximum) a zobrazí ✅/❌. /lexplan zobrazí jen doporučení 💡 bez hodu. Obtížnost lze zadat jako číslo (12) nebo název (easy, hard).

/lex Lex Arcana hod — s parametry hodí rovnou, bez nich otevře dialog

Pokud zadáte dice_points, hod proběhne okamžitě. Bez parametrů se otevře dialog se třemi poli.

Parametr / pole dialogu	Povinné	Popis
dice_points	ne	Kostkové body, např. `25`. Bez zadání se otevře dialog.
difficulty	ne	Číslo nebo název: `easy`=3 · `normal`=6 · `hard`=12 · `extreme`=18 (výchozí: normal)
secret	ne	Skrytý hod — výsledek uvidíte jen vy. V dialogu zadejte `ano`.

/lexplan Doporučí optimální kostky pro Lex Arcana bez samotného hodu

Pokud zadáte dice_points, doporučení se zobrazí okamžitě (💡). Bez parametrů se otevře dialog.

Parametr / pole dialogu	Povinné	Popis
dice_points	ne	Kostkové body, např. `25`. Bez zadání se otevře dialog.
difficulty	ne	Číslo nebo název obtížnosti (výchozí: normal)

Lex Arcana tlačítka lze přidat do /rt a /rt2 panelů: zadejte lex pro tlačítko hodu (výchozí název: Lex Arcana: hodit) nebo lexplan pro tlačítko doporučení (výchozí název: Lex Arcana: naplánovat).

Panely s tlačítky — /rt, /rt2, /rt3

Interaktivní hod kostkami přes tlačítkové panely. Tlačítka vycházejí z vašich vlastních hodů (/rollcustom) nebo sdílené serverové tabulky (/rttable).

/rt Panel s tlačítky pro hod — panel vidíte pouze vy, výsledky hodů jsou veřejné

Parametr	Typ	Popis
table	text volitelný 🔍 návrhy	Název sdílené tabulky místo vlastních hodů. Discord nabídne existující tabulky — vyberte jednu.

/rt2 Veřejný persistentní panel — hody se zapisují do téže zprávy

Parametr	Typ	Popis
table	text volitelný 🔍 návrhy	Název sdílené tabulky. Discord nabídne existující tabulky — vyberte jednu.
preset	▾ výběr ze seznamu volitelný	`prázdná tabulka` nebo `základní kostky`; výchozí: vlastní hody uživatele. Musí být jedna z nabízených hodnot.
title	text volitelný	Vlastní nadpis panelu
history	bool volitelný	Vlákno pro archiv hodů při přetečení (výchozí: ano)

Panel má vyhrazený poslední řádek: Oddělovač (kdokoliv), Přidat hod, Odebrat hod, Vymazat a Uložit šablonu (autor nebo admin). Odebrat hod otevře soukromý výběr konkrétního tlačítka a zachová historii hodů. Hozí tlačítka zabírají řádky 0–3 (max 20). Jako hod lze zadat lex (hod, výchozí název: Lex Arcana: hodit) nebo lexplan (doporučení, výchozí název: Lex Arcana: naplánovat). Tlačítko Uložit šablonu uloží celé rozložení panelu včetně barev jako sdílenou tabulku načitatelnou přes /rt table:název.

/rt3 Jako /rt2, ale poslední hod se zobrazí jako samostatná embed zpráva pod panelem

Parametry totožné s /rt2. Panel (ovládání + historie) je první embed; nejnovější hod je druhý embed přímo pod ním, před tlačítky.

Vlastní tlačítka — /rollcustom

Spravuje vaše osobní tlačítka pro hody v /rt a /rt2 panelech. Uložené hody se nabízejí jako návrhy při psaní /roll dice:.

/rollcustom add Přidá nebo upraví vlastní tlačítko pro hod

Parametr	Typ	Popis
label	text	Text tlačítka, např. `Útok` nebo `Zranění` (max 32 znaků)
dice	text	Zápis hodu, např. `1d20+15` nebo `1d6+1d8+6`. Zadejte `lex` pro tlačítko hodu Lex Arcana nebo `lexplan` pro tlačítko doporučení — kliknutí otevře dialog místo přímého hodu.
color	▾ výběr ze seznamu volitelný	Barva tlačítka: modrá, šedá, zelená, červená (výchozí: modrá). Musí být jedna z nabízených hodnot.

/rollcustom remove Odebere tlačítko z vašeho panelu

Parametr	Typ	Popis
label	text 🔍 návrhy	Text tlačítka k odebrání. Discord nabídne vaše existující tlačítka — vyberte ze seznamu.

/rollcustom list Zobrazí vaše uložené vlastní hody

Žádné parametry. Zobrazí přehled všech vašich tlačítek s hodovým zápisem a barvou — zpráva viditelná pouze vám.

Sdílené tabulky — /rttable

Správa sdílených tlačítkových tabulek pro celý server. Sdílené tabulky se volají pomocí /rt table:název. Vyžaduje admin.

/rttable add Přidá nebo upraví tlačítko ve sdílené tabulce (admin)

Parametr	Typ	Popis
table	text 🔍 návrhy — nebo nový	Název tabulky. Discord nabídne existující tabulky, ale lze napsat nový název pro vytvoření nové.
position	číslo	Pozice tlačítka (od 0)
label	text	Text tlačítka
dice	text	Zápis hodu

/rttable remove | clear | list Odebrání tlačítka, smazání tabulky, přehled tabulek

Ve všech třech příkazech nabídne Discord 🔍 návrhy pro parametr table — vyberte ze seznamu existujících tabulek.
remove: params table + position. clear: param table. list: param table volitelný (bez něj ukáže všechny tabulky).

Progresivní hodiny — /clocks

/clocks Interaktivní panel s progress clocks (styl Blades in the Dark)

Parametr	Typ	Popis
title	text volitelný	Nadpis dashboardu
clock_name	text volitelný	Název první hodiny
segments	číslo volitelný	Počet segmentů první hodiny: 4, 6, 8 nebo 12 (výchozí: 4)
filled	číslo volitelný	Počet předvyplněných segmentů (výchozí: 0)

Z panelu lze přidávat další hodiny, posouvat segmenty a mazat hodiny. Panel se aktualizuje na místě původní zprávy.

Plánování her

/nextgame

/nextgame set Nastaví jednorázový termín příští hry v kanálu

Parametr	Typ	Popis
date	text	Datum, např. `26.6.` nebo `26.6.2026`
time	text	Čas ve 24h formátu, např. `19:00`
reminder_hours_before	číslo volitelný	Kolik hodin předem odeslat připomínku (výchozí: 24)
game_length_hours	číslo volitelný	Délka hry v hodinách (výchozí: 4)
public	číslo volitelný	Viditelnost: `1` veřejná, `0` jen hráči, `-1` skrytá (výchozí: 1)

/nextgame recurring Nastaví opakovanou hru (každý týden nebo ob týden)

Parametr	Typ	Popis
weekday	▾ výběr ze seznamu	Den v týdnu (pondělí – neděle). Musí být jedna z nabízených hodnot.
time	text	Čas ve 24h formátu, např. `19:00`
interval_weeks	číslo volitelný	Každých X týdnů (výchozí: 1)
reminder_hours_before	číslo volitelný	Kolik hodin předem odeslat připomínku (výchozí: 24)
game_length_hours	číslo volitelný	Délka hry v hodinách (výchozí: 4)
start_date	text volitelný	Datum první hry, pokud se liší od nejbližšího dne v týdnu
public	číslo volitelný	Viditelnost: `1` veřejná, `0` jen hráči, `-1` skrytá (výchozí: 1)

/nextgame show Zobrazí příští hru pro aktuální kanál

Žádné parametry. Vypíše datum, čas a viditelnost nadcházejícího termínu.

/nextgame list Vypíše všechny naplánované hry na serveru

Parametr	Typ	Popis
visitors_only	bool volitelný	Zobrazit jen veřejné hry (výchozí: ne)

/nextgame skip Přeskočí aktuální opakovaný termín a posune na příští

Parametr	Typ	Popis
reason	text volitelný	Důvod přeskočení, zobrazí se v kanálu

/nextgame move Jednorázově přesune nejbližší termín na nové datum a čas

Parametr	Typ	Popis
date	text	Nové datum nejbližšího termínu, např. `26.6.` nebo `26.6.2026`
time	text	Nový čas ve 24h formátu, např. `20:00`

U opakované hry se posune jen nejbližší výskyt. Další termíny se vrátí k běžnému rozvrhu.

/nextgame reminder Zapne, vypne nebo přečasuje připomínku hry

Parametr	Typ	Popis
enabled	text 🔍 návrhy	`A`/`ano` pro zapnutí, `N`/`ne` pro vypnutí.
hours_before	číslo volitelný 🔍 návrhy	Kolik hodin před hrou připomínku poslat. Bez hodnoty zůstane aktuální načasování.
tag_role	ano/ne volitelný	Označit propojenou herní roli. Výchozí hodnota je ne; bez hodnoty zůstane aktuální nastavení. Zapnutí bez propojené role je povoleno, ale bot upozorní, že je potřeba použít `/nextgame role`.

/nextgame role | unrole Propojí herní kanál s bezpečnou herní rolí nebo propojení zruší

role vyžaduje parametr role. Bot přijme jen bezpečnou žlutou herní roli, která patří na server. Připomínka ji označí pouze po výslovném zapnutí parametrem tag_role v /nextgame reminder; výchozí stav je bez označení.

/nextgame clear Smaže termín hry

Odstraní termín z databáze a aktualizuje gameroom panel (pokud existuje).

/nextgame history Zobrazí historii odehraných her

Parametr	Typ	Popis
channel	kanál volitelný	Kanál, jehož historii chcete zobrazit. Výchozí je aktuální kanál.
all_channels	bool volitelný	Admin: zobrazí historii za celý server.

/gamealert

/gamealert Odešle oznámení o nové hře do novinky (pinguje roli)

Parametr	Typ	Popis
text	text	Text oznámení (zobrazí se za pingem role)
thread	vlákno volitelný	Vlákno z nabízených her k přiložení odkazu
image	příloha volitelný	Obrázek k oznámení — nelze kombinovat s plánováním
schedule_date	text volitelný	Datum odeslání, např. `28.6.` nebo `28.6.2026`. Vyžaduje i `schedule_time`.
schedule_time	text volitelný	Čas odeslání ve 24h formátu, např. `19:00`. Vyžaduje i `schedule_date`.

Zpráva se odešle do kanálu novinky a označí roli pro oznámení her. Příkaz má cooldown (GM ho nemůže spamovat); správci cooldown nemají.

Plánované odeslání: Zadejte schedule_date + schedule_time — bot oznámení naplánuje a odešle automaticky v zadaný čas. Naplánované alerty jsou viditelné v /status.

Postavy & aliasy

/gamealias

Správa postav a herních přezdívek v konkrétním kanálu. Bot ukládá jméno postavy, volitelnou zkratku a poznámku; při aktivní hře nebo ručním zapnutí umí dočasně změnit Discord přezdívku hráče na jméno postavy.

/gamealias set Nastaví postavu hráči (vyžaduje admin)

Parametr	Typ	Popis
user	uživatel	Hráč, kterému se nastavuje postava
character	text	Jméno postavy
short	text volitelný	Zkratka jména (zobrazí se v závorce za jménem)
notes	text volitelný	Poznámky ke postavě (max 200 znaků)

Přezdívka je po nastavení vypnutá Po /gamealias set je alias výchozně vypnutý. Hráč si ho zapne sám tlačítkem Zapnout si přezdívku nebo GM přes /gamealias enable.

/gamealias remove Odebere postavu hráči

Parametr	Typ	Popis
user	uživatel	Hráč, kterému se odebírá postava

/gamealias list Zobrazí seznam všech postav v kanálu

Výstup /gamealias list — přehled postav v kanálu dračí-hlídka

/gamealias enable | disable Zapne/vypne přezdívku pro konkrétního hráče (admin)

Parametr	Typ	Popis
user	uživatel	Hráč

/gamealias mine Zobrazí vaše aliasy napříč serverem (hráč)

Žádné parametry. Zobrazí přehled vašich postav ve všech kanálech — zpráva viditelná pouze vám. Nevyžaduje admin.

/gamealias all | cleanup Přehled a údržba aliasů na serveru (admin)

all — vypíše všechny aliasy na celém serveru.
cleanup — smaže aliasy a naplánované hry pro smazané nebo archivované kanály.

/gamealias setportrait | clearportrait | testpartycard · /mycharacter setportrait Portréty postav a kontrola party karty (admin)

setportrait uloží obrázek postavy z přiloženého souboru, clearportrait ho odebere a testpartycard pošle testovací party kartu pro aktuální kanál. Hráč může vlastní portrét nahrát přes /mycharacter setportrait. Přijímají se pouze JPEG, PNG a WebP soubory do 4 MB a bezpečných rozměrů.

/mycharacter

Skupinový příkaz pro hráče — každý hráč spravuje vlastní postavu v kanálu. Nevyžaduje admin ani GM roli.

/mycharacter set Nastaví vlastní postavu v aktuálním kanálu

Parametr	Typ	Popis
character	text	Jméno postavy
short	text volitelný	Zkratka (zobrazí se v závorce za jménem)
notes	text volitelný	Poznámka ke postavě (max 200 znaků)

Modální dialog z gameroom panelu — ekvivalent /mycharacter set

/mycharacter on | alwayson | off Zapne/vypne aktivní přezdívku

on — zapne přezdívku hned teď (bot ji denně resetuje kolem 4:00).
alwayson — zapne trvale, denní reset se nevztahuje.
off — vypne aktivní přezdívku a vrátí původní Discord přezdívku.

Pokud máte nastaveny životy (/hp) a přezdívka je aktivní, zobrazí se před jménem barevný indikátor HP (např. 🔴 Arb (Galw)). Barva se aktualizuje při každém použití /hp.

/mycharacter autorename Zapne nebo vypne automatické přejmenování při začátku naplánované hry

Parametr	Typ	Popis
mode	▾ výběr ze seznamu	`on` — bot přejmenuje automaticky při začátku hry. `off` — automatické přejmenování je vypnuto; manuální `/mycharacter on` stále funguje.

/mycharacter show | clear Zobrazí nastavenou postavu / odebere postavu

Žádné parametry. show — zobrazí přehled viditelný pouze vám. clear — smaže postavu z databáze.

/hp

Sledování životů postavy pro aktuální kanál. Životy jsou uloženy per-hráč per-kanál a zobrazují se s barevným indikátorem. Každý hráč může mít až 5 slotů (postava, přivolaný tvor apod.).

/hp Nastaví nebo zobrazí aktuální a maximální životy s barevným indikátorem

Parametr	Typ	Popis
hp	text volitelný	Aktuální životy: číslo (`15`), maximum (`max`), přičtení do maxima (`+5`, nesníží existující přeléčení), přeléčení přes maximum (`++5`) nebo odečtení (`-3`). Bez parametru zobrazí aktuální stav.
max	číslo volitelný	Maximální životy. První nastavení zároveň nastaví i aktuální životy na stejnou hodnotu.
slot	text volitelný	Název pojmenovaného slotu (max 30 znaků, např. `Přivolání`). Bez hodnoty pracuje s hlavním slotem postavy.
remove	ano/ne volitelný	Smaže pojmenovaný slot zadaný v `slot:`. Hlavní slot nelze smazat.
showinmycharacter	▾ výběr ze seznamu volitelný	`on` — zobrazí barevný indikátor HP v přezdívce postavy. `off` — indikátor se nezobrazí. Platí pouze pro hlavní slot.

Barevné indikátory
🟢 100% · 🔵 více než 75 % · 🟡 více než 50 % · 🟠 více než 25 % · 🔴 více než 0 % · ⚫ 0 nebo méně

Příklady
/hp max:40 — nastaví maximum na 40 a aktuální HP na 40.
/hp hp:28 — nastaví aktuální HP na 28.
/hp hp:max — nastaví aktuální HP na maximum.
/hp hp:-5 — odečte 5 od aktuálních HP.
/hp hp:+2 — přičte 2 k aktuálním HP, nejvýše do maxima; pokud jsou HP už nad maximem, nesníží je.
/hp hp:++2 — přičte 2 i přes maximum.
/hp — zobrazí všechny sloty.
/hp slot:Přivolání max:20 — vytvoří pojmenovaný slot a nastaví maximum na 20.
/hp slot:Přivolání hp:-3 — odečte 3 od slotu Přivolání.
/hp remove:true slot:Přivolání — smaže slot Přivolání.

Pokud je přezdívka postavy aktivní (viz /mycharacter on) a showinmycharacter je zapnuto, bot okamžitě aktualizuje Discord přezdívku s novým indikátorem hlavního slotu. Při vypnutí přezdívky nebo konci hry se vrátí původní přezdívka bez indikátoru.

/hpview

Zobrazí životy hráčů v kanálu nebo napříč serverem. Dostupné pro vypravěče a správce, odpověď je vždy viditelná pouze tazateli.

/hpview Přehled životů hráčů v kanálu (GM / Admin)

Parametr	Typ	Popis
user	uživatel volitelný	Zobrazit životy konkrétního hráče v tomto kanálu (všechny jeho sloty).
all_channels	ano/ne volitelný	Zobrazit životy všech hráčů na celém serveru seřazené podle kanálů. Dostupné pouze správcům.

Příklady
/hpview — životy všech hráčů v aktuálním kanálu.
/hpview user:@Arya — všechny HP sloty hráče Arya v tomto kanálu.
/hpview all_channels:true — přehled celého serveru (jen správci).

/partycard

/partycard Vygeneruje kartu skupiny jako obrázek

Vytvoří grafickou kartu s portréty a jmény všech postav v kanálu. Portréty se nahrávají jako Discord přílohy přes /gamealias setportrait nebo /mycharacter setportrait; načítání z URL není podporováno. Kartu lze zobrazit i z panelu tlačítkem Místní družina.

Zbrojnice

/armory

Zbrojnice spravuje společné vybavení včetně více kusů stejného předmětu. Ve výchozím stavu má každý kanál vlastní zbrojnici; GM nebo správce může server přepnout na jednu společnou zbrojnici.

list ukazuje dostupný a celkový počet i aktuální dlužníky. Každý předmět zabírá jediný řádek; dlužníci a jejich počty jsou uvedeni v závorkách za stavem zásob. Každý hráč může přes add vložit vybavení, přes borrow si dostupné kusy vypůjčit, přes claim si je trvale přivlastnit a přes return nebo return-all je vrátit. Přivlastnění sníží celkovou zásobu a nevytvoří výpůjčku. borrowed zobrazí výpůjčky vybraného hráče. details ukáže nebo upraví sekci a katalogové údaje; tuto správu mohou používat i hráči.

/armory destroy Oznámí zničení vypůjčeného předmětu

Zničený nebo spotřebovaný kus už není možné vrátit. Příkaz veřejně oznámí hráče, předmět, počet a volitelný důvod; současně sníží výpůjčku i celkovou zásobu. GM může stejnou událost zaznamenat za jiného hráče přes destroy-for.

/armory name | ruleset | scope | board-set | sheet-set Nastavení pro GM a správce

name zobrazí aktuální název; GM nebo správce nastaví vlastní název parametrem name: a pomocí reset:true vrátí výchozí název. ruleset vybírá systém katalogu a rozložení zrcadla; standardní předměty dědí statistiky z katalogu a unikátní předměty ukládají jen lokální změny. scope přepíná kanálový a serverový rozsah. Existující zbrojnice se nesloučí bez confirm_merge:true; stejné názvy sečtou zásoby i zachovají všechny výpůjčky. board-set založí v určeném kanálu stálou automaticky aktualizovanou sekvenci zpráv. Smazanou nebo dočasně nedostupnou zprávu bot znovu vytvoří.

Každý řádek v části posledních změn obsahuje vlastní čas. Nástěnka má tlačítka Vypůjčit, Přivlastnit si, Vrátit, Vrátit vše, Přidat předmět, Upravit předmět a Detail předmětu. Výběry jsou soukromé a u velkých zbrojnic stránkované po 25 položkách. Přidání nejprve nabídne kategorii zvoleného systému a potom standardní předmět. Ten lze přidat beze změny, nebo jako zvlášť pojmenovanou variantu s vlastním efektem a poznámkami, která dědí zbývající katalogové statistiky.

Předměty na nástěnce jsou zobrazené přímo pod kategoriemi zvoleného systému, bez dalšího nadpisu zásob. Je-li zapnuté zrcadlo, hned za názvem zbrojnice se zobrazí odkaz Google Sheet. Dlouhý seznam se nezkracuje: bot ho stejným způsobem jako seznam přání automaticky rozdělí do několika navazujících zpráv. Ovládací tlačítka zůstávají pouze na poslední zprávě.

GM a správci mohou také použít remove, rename, board-show, board-refresh a board-disable.

sheet-set nastaví jednosměrné zrcadlo do předem vytvořeného vyhrazeného listu Google Sheets. Zrcadlo zachovává původní sekce a jejich rozdílné sloupce, barvy, zalamování, rámečky a zaškrtávací políčka; každý fyzický kus má vlastní řádek. Názvy předmětů na Discord nástěnce odkazují na první odpovídající řádek. Bot také vytvoří a udržuje list Full Catalogue se všemi předměty zvoleného systému. SQLite zůstává jediným zdrojem dat a bot ze Sheets nic neimportuje. Stav a chyby ukáže sheet-status; sheet-refresh vynutí zápis a sheet-disable vypne další aktualizace bez smazání obsahu listu.

Tajemství

/secret

GM nebo správce zveřejní panel s tlačítkem Odhalit tajemství. Každý člen, který panel vidí, obdrží aktuální obsah pouze v soukromé ephemeral zprávě. Bot zaznamená první a poslední odhalení, počet kliknutí a poslední přečtenou verzi.

/secret create | edit | show | listObsah a verze

create a edit otevírají víceřádkový formulář s podporou Discord Markdownu. Změna soukromého obsahu vytvoří novou verzi; hráči, kteří četli starší verzi, jsou v přehledu označeni jako zastaralí, dokud znovu nekliknou. Čísla tajemství jsou místní pro aktuální kanálovou nebo serverovou kolekci.

/secret reveals | close | reopen | delete | scopeAudit a správa

reveals soukromě ukáže čtenáře, čas, počet kliknutí a stav verze. close odhalování vypne a reopen ho obnoví. Výchozí rozsah je kanál; přechod na jednu serverovou kolekci a zpět používá stejné potvrzované slučování jako zbrojnice. Ephemeral zpráva není vidět v kanálu, ale nezabraňuje hráči obsah zkopírovat nebo zachytit.

Cíle

/goals

Výchozí seznam obsahuje Hlavní cíle s podtitulem Za hrdinskou schopnost, Další cíle a Hráčské cíle. Hráči spravují vlastní hráčské cíle; GM a správci mohou spravovat vše.

Dokončený cíl zůstane na původním místě, zobrazí se přeškrtnutě a lze ho obnovit. Dokončený Hlavní cíl má tři fajfky jako zdůraznění odměny za hrdinskou schopnost; ostatní cíle mají jednu. Pokud text už obsahuje vlastní přeškrtnutí, při dokončení se bezpečně skryje a po obnovení se vrátí. Kategorie nejsou oddělené nadbytečným prázdným řádkem. Smazání je trvalé. Hráčské cíle zobrazují autora a jsou plně společné: kterýkoliv hráč je může přidat, upravit, dokončit, obnovit nebo smazat.

/goals category-* | scope | name | board-*Nastavení GM/správce

Kategorie lze přidávat, upravovat, řadit a mazat. Oprávnění může být jen pro GM, pro vlastní cíle hráčů, nebo společné pro všechny. Výchozí rozsah je kanál a přechod na serverový seznam používá potvrzované slučování. Nástěnku lze umístit do libovolného textového kanálu; dlouhý obsah se rozdělí do navazujících zpráv.

Nástěnka nabízí Přidat, Upravit, Dokončit, Obnovit a Smazat. Soukromé výběry každému zobrazí jen kategorie a cíle, které smí spravovat.

Přání

/wish

Skupinový příkaz pro správu herních přání. Přání jsou viditelná v kanálu #přání (nebo ekvivalentním) a hráči si je mohou spravovat sami.

/wish add Přidá hru do vlastního seznamu přání

Parametr	Typ	Popis
game	text 🔍 návrhy — nebo nový	Název hry, RPG systému nebo oneshotového dobrodružství. Discord nabídne existující přání ze serveru, ale lze napsat zcela nový název.

/wish remove Odebere hru z vlastního seznamu přání

Parametr	Typ	Popis
game	text 🔍 návrhy	Název hry k odebrání. Discord nabídne vaše přání — vyberte ze seznamu.

/wish mine Zobrazí vlastní seznam přání — viditelné pouze vám

Žádné parametry. Zobrazí přehled her, které jste si přáli, včetně věku každého přání (počet dní od přidání, např. 42 d) — zpráva viditelná pouze vám.

/wish random Vylosuje náhodné přání ze seznamu všech hráčů (GM)

Parametr	Typ	Popis
count	číslo volitelný	Počet losovaných přání (výchozí: 1)

/wish ping Oznámí hráčům, kteří si přáli danou hru (GM)

Parametr	Typ	Popis
game	text 🔍 návrhy	Název hry. Discord nabídne všechna přání na serveru — vyberte ze seznamu.

/wish clear Smaže vlastní seznam přání

Žádné parametry. Admin verze /wish clearfor user:@hráč smaže přání jinému hráči. Podobně fungují /wish addfor a /wish removefor.

Administrace

Ostatní příkazy

/wishes Zobrazí všechna přání na serveru seskupená podle hry (admin)

Parametr	Typ	Popis
show_ages	bool volitelný	Zobrazit věk přání v počtu dní, např. `42 d` (výchozí: ne)
sort_by	▾ výběr ze seznamu volitelný	Způsob řazení: `name` — abecedně podle hry (výchozí) · `age` — hry s nejstaršími přáními první, uživatelé v každé hře seřazeni od nejstaršího přání · `individual` — plochý seznam jeden záznam na řádek (hra — uživatel — věk), seřazen od nejstaršího

Zpráva se odešle veřejně do kanálu. Věky přání (show_ages) nejsou viditelné v základním výstupu — jsou dostupné jen pro správce nebo vlastní seznam (/wish mine).

/sortchannels Seřadí textové kanály v kategorii abecedně

Parametr	Typ	Popis
category	text volitelný 🔍 návrhy	Název kategorie k seřazení (výchozí: Probíhající hry). Discord nabídne existující kategorie — vyberte jednu, nebo pište pro filtrování.

/archive Přesune kanál nebo vlákno do kategorie Archive

Parametr	Typ	Popis
channel	kanál volitelný	Textový kanál nebo vlákno k archivaci
thread	text volitelný 🔍 návrhy	Odkaz, mention nebo ID vlákna/příspěvku. Discord nabídne vlákna v kanálu — vyberte ze seznamu nebo zadejte ID/mention.
destination	kanál volitelný	Cílový kanál pro archiv vlákna (výchozí: `#archiv-nabízených-her`)
delete_after	bool volitelný	Smazat vlákno po zkopírování (výchozí: ne)

/gmrole Vytvoří bezpečnou žlutou označitelnou roli pro hru

Parametr	Typ	Popis
name	text	Název nové herní role
users	text volitelný	Uživatelé jako mentiony nebo ID, kterým se role rovnou přidá

/gmrole-add | /gmrole-remove Přidá nebo odebere bezpečnou herní roli hráčům

Parametr	Typ	Popis
role	role	Bezpečná žlutá herní role k přidání nebo odebrání
users / user	text nebo uživatel	`/gmrole-add` přijímá více uživatelů jako mentiony nebo ID; `/gmrole-remove` odebírá roli jednomu uživateli.

/weeklyreport Automatické týdenní reporty aktivity serveru (admin)

Bot umí odesílat dva typy reportů, každý do vlastního kanálu, v nastavený čas každý týden. Vše se nastavuje přes subpříkazy:

Subpříkaz	Co dělá
setchannel	Nastaví kanál, do kterého se daný typ reportu odesílá. Parametry: `report` (typ) + `channel` (kanál).
enable \| disable	Zapne nebo vypne automatické odesílání daného typu reportu. Parametr: `report` (typ).
schedule	Nastaví den a hodinu odeslání (výchozí: pondělí 9:00). Parametry: `report`, `weekday`, `hour`.
preview	Zobrazí náhled veřejného shrnutí — ve výchozím stavu ho vidíte jen vy. Parametry: `period` (minulý nebo aktuální týden, výchozí: aktuální), `testing` (zobrazí i prázdné sekce), `public` (při `true` odešle náhled veřejně do aktuálního kanálu).
adminpreview	Zobrazí náhled moderátorského shrnutí — ve výchozím stavu ho vidíte jen vy. Parametry: `period`, `public` (při `true` odešle náhled veřejně do aktuálního kanálu).
backfill-words	Doplní počty slov pro zprávy uložené v databázi. Parametr: `period`.

Dva typy reportu Veřejné shrnutí (report:veřejné shrnutí) — grafická karta s čísly za týden: celkový počet zpráv, aktivní hráči, herní sezení, hlasový čas, noví členové, reakce, hody kostkami a počet hodů. Odesílá se do veřejného kanálu.

Moderátorské shrnutí (report:moderátorské shrnutí) — textový přehled pro GM/správce: nové nabídky her, aktivita tržiště a design koutku, akce, Diskuzní klub, přehled kanálů, přírůstek členů, odchody. Obsahuje i statistický graf. Odesílá se do GM/admin kanálu.

Typický postup nastavení 1. /weeklyreport setchannel report:veřejné shrnutí channel:#obecné
2. /weeklyreport setchannel report:moderátorské shrnutí channel:#gm-info
3. /weeklyreport enable report:veřejné shrnutí
4. /weeklyreport enable report:moderátorské shrnutí
5. Volitelně: /weeklyreport schedule report:veřejné shrnutí weekday:pondělí hour:9

/playing Vypíše aktuální hry a jejich poslední aktivitu (admin)

Parametr	Typ	Popis
category	text volitelný 🔍 návrhy	Kategorie ke kontrole (výchozí: Probíhající hry). Discord nabídne existující kategorie.
order_by	▾ výběr ze seznamu volitelný	Řazení: `název hry`, `GM`, `poslední zpráva` (výchozí: název hry). Musí být jedna z nabízených hodnot.

/inactive Vypíše textové kanály bez aktivity (admin)

Bez parametrů: vypíše všechny textové kanály, ve kterých nikdo nepsal déle než 30 dní, seskupené podle kategorie. Ignoruje kategorie jejichž název obsahuje archiv. Kanály bez jediné zprávy v databázi jsou vypsány zvlášť.

Parametr	Typ	Popis
days	číslo volitelný	Hranice neaktivity ve dnech (výchozí: 30)

/inactivethreads Vypíše neaktivní vlákna nebo příspěvky ve fóru (admin)

Bez parametrů: zkontroluje vlákna/příspěvky v kanálu #✅nabízené-hry bez aktivity déle než 30 dní. Pro každé vlákno zobrazí název, autora, datum poslední zprávy, počet dnů neaktivity a zda je archivováno.

Parametr	Typ	Popis
channel	kanál volitelný	Textový nebo fórový kanál ke kontrole (výchozí: #✅nabízené-hry)
days	číslo volitelný	Hranice neaktivity ve dnech (výchozí: 30)

/reactionrole Spravuje zprávy, kde si uživatelé přidávají nebo odebírají role reakcí

Subpříkaz	Co dělá
post	Vytvoří novou reaction-role zprávu. Parametry: `role`, volitelně `channel`, `emoji`, `color`, `title`, `description`, `role_description`.
add	Přidá další emoji/roli na existující zprávu podle `message_id`.
edit	Upraví existující zprávu nebo konkrétní emoji/roli.
list	Zobrazí uložené reaction-role zprávy na serveru.

Bot kontroluje, že vybraná role je bezpečná pro samoobslužné přiřazení a že ji sám dokáže spravovat.

/settempicon Dočasně změní ikonu serveru a naplánuje automatický návrat (admin)

Nastaví novou ikonu serveru z obrázkové přílohy a uloží aktuální ikonu pro pozdější obnovu. Při nastavení i při automatickém návratu pošle bot oznámení do nastaveného GM report kanálu, případně přímo do #moderátoři. V oznámení je přiložená ikona, která byla v daný moment nahrazena.

Parametr	Typ	Popis
icon	obrázková příloha	Nová dočasná ikona serveru. Soubor musí být obrázek.
revert_date	datum	Datum návratu původní ikony. Formáty: `1.7.`, `1.7.2026`, `2026-07-01`. Návrat proběhne o půlnoci pražského času.

Pokud příkaz použijete znovu před návratem, přepíše existující naplánovanou obnovu pro daný server.

/welcome Nastavení uvítacích zpráv pro nové členy (admin)

Subpříkaz	Co dělá
show	Zobrazí aktuální nastavení uvítání a náhled zprávy.
setchannel	Nastaví textový kanál, kam se mají posílat uvítací zprávy.
setmessage	Nastaví text uvítací zprávy. Lze použít zástupné výrazy `{mention}`, `{name}`, `{server}`. Limit je 1800 znaků.
test	Odešle testovací uvítací zprávu do nastaveného kanálu.
enable \| disable	Zapne nebo vypne automatické uvítání nových členů.

/autojoin · /autojoinlist Automatické připojování k dostupným veřejným vláknům

/autojoin je veřejný příkaz dostupný všem členům serveru. Bez parametru soukromě zobrazí vaše nastavení; parametr enabled ho zapne nebo vypne pouze pro vás a aktuální server.

Příkaz / parametr	Pro koho	Popis
/autojoin enabled:True	Všichni členové	Zapne připojování k novým veřejným vláknům a příspěvkům fóra, které už smíte vidět.
/autojoin enabled:False	Všichni členové	Vypne budoucí připojování; neopouští vlákna, ke kterým už jste připojeni.
/autojoinlist	Pouze správce	Soukromě a bez označování vypíše uživatele a uložená ID s aktivním autojoinem na serveru.

Autojoin nikdy neuděluje přístup Bot zpracuje pouze aktivní veřejná vlákna, news vlákna a příspěvky fóra, u kterých uživatel už má oprávnění vidět rodičovský kanál i samotné vlákno. Soukromá, nepřístupná, archivovaná, zamčená nebo neúplně načtená vlákna vždy vynechá.

Funkce reaguje jen na vytvoření nového vlákna: nezpracovává starší vlákna ani vlákna vytvořená během výpadku bota. Nastavení oznámení zůstává pod kontrolou každého uživatele v Discordu.

/ping Bezpečné označení role pro běžné členy serveru

Spusťte /ping, vyberte roli a napište zprávu. Zakázaná nebo systémová role se odmítne hned po výběru. Poté bot soukromě ukáže vybranou roli, cílový kanál a náhled textu. Ping se odešle až tlačítkem Odeslat do #kanál; tlačítko Zrušit akci ukončí a potvrzení po třech minutách vyprší.

Text nesmí obsahovat @everyone, @here ani další uživatelské či rolové zmínky. Běžný člen musí být na serveru alespoň 24 hodin a může úspěšně použít /ping jednou za hodinu. GM a správci mají výjimku z těchto dvou omezení, nikoli z kontroly role a zprávy.

🗑️ Smazání vlastní odpovědi bota Na běžnou veřejnou odpověď bota ze svého slash příkazu můžete přidat reakci 🗑️ a bot ji smaže. Bot reakci nepřidává automaticky. Funkce neplatí pro soukromé odpovědi, stálé panely ani zprávy s tlačítky nebo jinými ovládacími prvky; cizí uživatel odpověď smazat nemůže.

/pinghistory Zobrazí poslední pokusy o /ping a jejich výsledek (admin)

Vypíše auditní historii guarded /ping pokusů na serveru, včetně povolených i zamítnutých pokusů. Zpráva je viditelná pouze vám a nepingá zmíněné role ani uživatele.

Parametr	Typ	Popis
limit	číslo volitelný	Počet záznamů k zobrazení (výchozí: 20, nejvýše 50).

/graphs Vygeneruje obrázek se statistikami serveru (admin)

Pošle soukromě obrázek statistiky.png se serverovými metrikami za vybrané období.

Parametr	Typ	Popis
period	▾ výběr ze seznamu volitelný	Období grafu: týden, měsíc nebo rok. Týden znamená poslední uzavřený reportovací týden.
year	číslo volitelný	Rok pro měsíční nebo roční výstup.
month	číslo volitelný	Měsíc pro měsíční výstup. Pokud zadáte měsíc bez `period`, použije se měsíční období.

/summary Vygeneruje obrázkové shrnutí aktivity serveru (admin)

Pošle soukromě obrázek shrnutí.png se souhrnem aktivity. Používá stejné období jako /graphs.

Parametr	Typ	Popis
period	▾ výběr ze seznamu volitelný	Období shrnutí: týden, měsíc nebo rok.
year	číslo volitelný	Rok pro měsíční nebo roční výstup.
month	číslo volitelný	Měsíc pro měsíční výstup.

/makegm Přidá uživateli roli GMing (admin)

Ruční nástroj pro přidání serverové role GMing. Bot zkontroluje, že role existuje, že ji uživatel ještě nemá a že ji bot může spravovat.

Parametr	Typ	Popis
user	uživatel	Člen serveru, kterému se má role přidat.

/createchannel Vytvoří textový kanál ve vybrané kategorii (admin)

Vytvoří textový kanál, normalizuje mezery v názvu na pomlčky a odmítne duplicitu ve stejné kategorii.

Parametr	Typ	Popis
name	text	Název nového kanálu.
description	text volitelný	Popis/téma kanálu.
category	text volitelný 🔍 návrhy	Kategorie, ve které se kanál vytvoří. Výchozí: Probíhající hry.

Po vytvoření bot připomene, že kategorii lze seřadit přes /sortchannels.

/renamevoice Přejmenuje hlasový kanál (admin)

Parametr	Typ	Popis
channel	hlasový kanál	Kanál, který se má přejmenovat.
name	text	Nový název kanálu. Nesmí být prázdný a musí mít nejvýše 100 znaků.

/runmaintenance Ručně spustí údržbu databáze pro aktuální týden (admin)

Spustí stejnou údržbu, kterou bot běžně dělá automaticky: doplnění zpráv a reakcí pro reporty, doplnění odchodů/banů, uzavření přerušených hlasových sezení a cleanup starých gamealias dat. Výsledek se zobrazí soukromě a technický report se pošle do vlákna Rookova samomluva v #moderátoři, pokud ho bot dokáže najít nebo vytvořit.

/log Zobrazí posledních N řádků logu bota přímo v Discordu (admin)

Zobrazí výstup ze systémového logu bota — zpráva viditelná pouze vám. Užitečné pro diagnostiku bez přístupu k SSH.

Parametr	Typ	Popis
lines	číslo volitelný	Počet řádků (výchozí: 30, max: 100)

/status Zobrazí stav bota — smyčky, nastavení reportu, databáze, latence (admin)

Rychlý přehled zdravotního stavu bota bez přístupu k SSH. Zpráva viditelná pouze vám. Zobrazuje:

Stav každé smyčky na pozadí (připomínky, přezdívky, report, ikona, údržba)
Nastavení týdenního reportu — zapnutý/vypnutý, kanál, den a čas odeslání
Naplánované gamealerty čekající na odeslání (odesílatel, text, datum)
Cestu k databázi a její velikost
Počet serverů a aktuální latenci

Průvodce: Zakládání nové hry

Příkaz /gming vytvoří persistentní panel v aktuálním kanálu. Z tohoto panelu GM provede všechny kroky potřebné pro zahájení nové hry — vytvoření kanálu, role a přidání hráčů.

Kdy použít Při zakládání úplně nové hry na serveru. Pro každou hru se typicky vytvoří vlastní textový kanál a volitelně vlastní role pro hráče.

Spuštění panelu

Zadejte /gming v libovolném kanálu

Bot odešle interaktivní panel s tlačítky. Panel zůstane ve zprávě — lze se k němu kdykoli vrátit.

Panel /gming s tlačítky pro správu hry

Vytvoření herního kanálu

Klikněte na Vytvořit kanál

Otevře se dialog pro zadání názvu nového kanálu.

Zadejte název kanálu — zkrácený formát bez mezer, např. dračí-hlídka

Potvrďte vytvoření

Bot zobrazí potvrzovací zprávu s volbou, zda zkopírovat úvodní příspěvek z vybrané nabídky hry. Vyberte nabídku ze seznamu, nebo nechte pole prázdné, a klikněte na Vytvořit kanál.

Potvrzovací zpráva — volitelně vyberte šablonu úvodního příspěvku

Kanál je vytvořen

Bot vytvoří textový kanál v herní kategorii a přesměruje vás tam s potvrzovací zprávou. Kanál je ihned přístupný všem členům serveru (nebo podle nastavení oprávnění).

Tip: Seřadit kanály Po vytvoření kanálu klikněte na Seřadit kanály v panelu — bot abecedně seřadí herní kanály v kategorii.

Vytvoření role hráčů

Klikněte na Vytvořit roli

Otevře se dialog pro název nové role. Název typicky odpovídá jménu hry nebo skupiny.

Dialog vytvoření role — zadejte název a volitelně přidejte hráče

Přidejte hráče do role

Klikněte na Přidat hráče do role. Zobrazí se dialog s výběrem uživatelů ze serveru. Lze přidat více hráčů najednou.

Archivace hry

Až hra skončí, panel nabízí dvě možnosti archivace:

Tlačítko	Co udělá
Archivovat kanál	Přesune kanál do kategorie Archiv. Zprávy zůstanou zachovány.
Archivovat a vymazat nabídku	Přesune kanál do Archivu a smaže původní nabídkovou zprávu (pokud existuje).

Pozor Archivace je nevratná — kanál se přesune, ale nesmaže. Pokud chcete kanál zcela odstranit, je potřeba ho smazat ručně přes nastavení serveru.

Automatický úklid po archivaci Po přesunu kanálu do archivu bot automaticky smaže HP záznamy a herní přezdívky (game aliases) pro daný kanál. Výsledek úklidu se zobrazí v potvrzovací zprávě. Denní údržba navíc pravidelně odstraňuje osiřelé záznamy pro kanály, které již neexistují.

Průvodce: Herní kanál (/gameroom)

Příkaz /gameroom vytvoří v herním kanálu trvalý panel, který slouží jako centrum pro správu hry — termíny, upozornění, postavy hráčů a případně karta party. Panel se aktualizuje na místě, takže vždy zobrazuje aktuální stav. Pokud se pokusíte vytvořit nový panel v kanálu, který už panel má, bot vás na to upozorní a přesměruje vás na panel stávající. Ten můžete v případě potřeby vymazat a založit si nový, nebo vesele používat ten původní.

Kde zadat Příkaz /gameroom zadejte přímo v herním kanálu dané hry, nikoli v obecném kanálu.

Kompletní panel /gameroom s termínem, postavami a ovládacími tlačítky

Nastavení termínu

Klikněte na Nastavit termín

Otevře se dialog s políčky pro datum, čas a volitelné nastavení opakování.

Dialog pro nastavení termínu — vyplňte datum a čas, opakování je volitelné

Vyplňte datum a čas

Datum zadejte ve formátu 26.6. nebo 26.6.2026. Čas jako 19:00. Pro opakující se hry zadejte den v týdnu (např. čtvrtek) a periodičnost opakování (jestli každý týden, jednou za dva týdne a podobně). Bot bude termín automaticky posouvat po každé hře. Opakovaná hra automaticky bere nejbližší zadaný den v týdnu jako první opakování. Pokud tedy vytváříte opakovanou hru v pondělí a zadáte úterý jako den hry, první hra bude nastavená na zítra. Pokud chcete nastavit opakovanou hru až od určitého data, musíte zadat i datum prvního opakování.

Panel se aktualizuje

Bot aktualizuje panel s novým termínem. Od teď bude bot automaticky odesílat upozornění s potvrzením účasti před hrou (pokud je nastaveno).

Další možnosti správy termínu

Tlačítko	Co udělá
Přeskočit	Přeskočí aktuální termín a posune ho na příští opakování (jen u opakovaných her).
Přesunout	Jednorázově přesune nejbližší termín na zadaný datum a čas.
Smazat termín	Odstraní termín úplně.

Upozornění před hrou

Kliknutím na Nastavit upozornění nastavíte, kolik hodin předem bot odešle do kanálu zprávu s potvrzením účasti. Výchozí hodnota je 24 hodin.

Správa postav — tlačítka panelu

Panel obsahuje dvě skupiny tlačítek: GM tlačítka pro správu postav ostatních a hráčská tlačítka, která může použít kdokoli pro svou vlastní postavu.

Tlačítka pro GM

Nastavit postavu hráči

Zobrazí výběr hráče ze serveru a poté dialog pro zadání jména postavy, zkratky a poznámek. Vhodné pro rychlé nastavení postav na začátku kampaně.

Přidat obrázek postavy (GM verze)

Z bezpečnostních důvodů odkáže na /gamealias setportrait, který přijme portrét jako Discord přílohu pro vybraného hráče.

Dialog pro nastavení portrétu — vložte přímý odkaz na obrázek (https://)

Odebrat postavu hráči

Odebere postavu vybranému hráči z tohoto kanálu.

Tlačítka pro hráče (bez omezení oprávnění)

Moje postava

Každý hráč si může nastavit nebo změnit svou vlastní postavu pro tento kanál — jméno, zkratku v závorce a volitelnou poznámku. Ekvivalent příkazu /mycharacter set.

Zapnout si přezdívku / Vypnout si přezdívku

Hráč zapne nebo vypne svou herní přezdívku. Bot tím dočasně změní jeho Discord přezdívku v serveru na jméno postavy. GM může přezdívky zapínat a vypínat pro jednotlivé hráče přes /gamealias enable a /gamealias disable.

Přidat si obrázek postavy

Hráč si může přidat portrét vlastní postavy přes /mycharacter setportrait s Discord přílohou. Načítání z URL není podporováno.

Odebrat si postavu

Hráč odebere svou postavu z tohoto kanálu.

Tlačítko Aktualizovat Pokud se panel desynchronizuje (např. po restartu bota), klikněte na Aktualizovat — bot překreslí panel s aktuálními daty z databáze.

Průvodce: Připomínka hry a potvrzení účasti

Bot automaticky odesílá upozornění na hru nastavený počet hodin před termínem. Hráči mohou reagovat přímo ve zprávě a ve stejné zprávě je vidět aktualizovaný přehled všech, kteří svou účast nastavili.

Automatické upozornění s potvrzením účasti s tlačítky pro odpovědi a přehledem účastníků

Jak to funguje

Bot odešle upozornění automaticky

Nastavený počet hodin před hrou (výchozí 24 h) bot odešle do herního kanálu zprávu s termínem hry a tlačítky pro potvrzení účasti.

Hráči odpoví tlačítkem

K dispozici jsou čtyři statusy:

Tlačítko	Význam
✅ Dorazím	Hráč potvrdí účast
❌ Nedorazím	Hráč se omluví
⏰ Zpoždění	Hráč přijde, ale se zpožděním
👁️ Divák	Hráč bude přítomný jako divák

Tlačítko ↩️ Odebrat odpověď odpověď smaže.

Přehled se aktualizuje v reálném čase

Pod tlačítky se zobrazuje aktuální počet a jméno každého hráče v každé kategorii. GM vidí okamžitě, kdo potvrdil účast.

Historie účastí Odpovědi hráčů jsou automaticky archivovány pro každé odehrané sezení. Historie je uložena v databázi pro případnou budoucí statistiku kampaně.

Průvodce: Přezdívky postav

Systém přezdívek umožňuje hráčům používat během hry jméno postavy jako Discord přezdívku. Hráč píše jako obvykle; bot pouze zapíná, obnovuje a po skončení hry vrací serverovou přezdívku podle uložené postavy.

Technická poznámka Přezdívky používají změnu serverové přezdívky člena. Bot potřebuje oprávnění Manage Nicknames a jeho role musí být v hierarchii výš než role hráče. Pokud se přezdívka nezmění, zkontrolujte oprávnění a pořadí rolí.

Nastavení přezdívek

GM nastaví postavu každému hráči

Použijte /gamealias set nebo tlačítko Nastavit postavu hráči v gameroom panelu. Zadejte jméno a volitelně zkratku (zobrazí se v závorce za celým jménem).

Hráč si zapne přezdívku

Hráč klikne na Zapnout si přezdívku v gameroom panelu, nebo použije /mycharacter. Přezdívku lze kdykoli vypnout tlačítkem Vypnout si přezdívku.

Hráč má přezdívku postavy

Od teď se hráč na serveru zobrazuje pod jménem postavy. Ruční zapnutí příkazem /mycharacter on se denně uklízí kolem 4:00; /mycharacter alwayson zůstává zapnuté, dokud ho hráč nevypne.

Správa přezdívek

Výstup /gamealias list — přehled všech postav a stavů přezdívek

Pro přehled všech postav v kanálu použijte /gamealias list. Sloupec zapnuto/vypnuto ukazuje, zda je alias aktivní pro daného hráče.

Oprávnění

Příkazy jsou rozděleny podle úrovně oprávnění:

Úroveň	Kdo	Příkazy
Admin	Uživatelé s oprávněním Spravovat server	/gamealias (vše kromě mine), /rttable, /wish addfor \| removefor \| clearfor, /autojoinlist, /inactive, /inactivethreads, /playing, /reactionrole, /settempicon, /makegm, /weeklyreport
GM	Uživatelé s rolí GMing nebo správci serveru	/gming, /gameroom, většina /nextgame správy, /gamealert, /gmchannel, /partycard, /sortchannels, /archive, /gmrole, /gmrole-add, /gmrole-remove, /gmrole-list, správa /armory, /secret, konfigurace /goals
Hráč	Všichni členové serveru	/roll, /r, /rt, /rt2, /rt3, /rollcustom, /clocks, /mycharacter (vše), /hp, hráčské /armory, povolené /goals, odhalení viditelného /secret panelu, /wish add \| remove \| mine \| clear \| random \| ping, /autojoin, /help

/help

Nápověda přímo v Discordu — zpráva viditelná pouze vám.

/help Zobrazí nápovědu k příkazům bota

Parametr	Typ	Popis
topic	výběr volitelný	Téma nápovědy: `roll`, `mycharacter`, `hp`, `wish`, `armory`, `secret`, `goals`, `ping`, `autojoin`, `gm`, `nextgame`, `gamealias`, `admin`. Témata zbrojnice, tajemství, cílů, pingu a autojoinu odkazují přímo na odpovídající sekci online dokumentace.