Dokumentace

Octera funguje se slash příkazy (/command) i s textovými příkazy pomocí prefixu tvého serveru (výchozí .). Skoro všechno navíc nastavíš i z webového dashboardu.

Tip: napiš .help <command> (např. .help ban, .help eco), ať víš, co příkaz dělá, včetně skutečných příkladů — nebo .help <category> pro celou kategorii. <command> help pořád funguje taky.

Premium servery: stránka Premium v dashboardu (postranní panel → Nastavení) ukazuje předplatné serveru na první pohled — tarif, datum obnovení i to, kdo platí — a hned tam najdeš tlačítka pro upgrade i správu.

Prefix & nápověda

/help [query]
Menu příkazů podle kategorií — nebo zadej příkaz pro jeho použití + příklady, případně kategorii pro její výpis.
Příklad: .help timeout
/prefix [set]
Zobraz nebo změň prefix textových příkazů (Spravovat server).
Příklad: /prefix set: ?
/enable & /disable <targets>
Zapni nebo vypni moduly a/nebo příkazy — i několik naráz.
Příklad: /disable economy music warn

Moderace

/warn @user [reason]
Varuj člena; přidá eskalační body a zapíše případ.
/timeout @user <duration> [reason]
Dočasně umlč člena.
Příklad: /timeout @user 10m spamming
/kick · /ban · /unban
Standardní moderace, všechno se zaznamenává do případů.
/case [id|@user]
Zobraz konkrétní případ nebo úplnou historii člena.
/modlog
Nastav kanál moderátorského logu.
/unbanall run
Hromadně odbanuj všechny kromě chráněného blacklistu.
/unbanall blacklist add|remove|list
Spravuj chráněný seznam — uživatele, kterých se hromadný unban nikdy nedotkne.
/purge <all | number | time span> [@user]
Hromadně smaž zprávy. all vyčistí kanál (a pokud je velký, zamkne ho po dobu mazání), číslo smaže daný počet nedávných zpráv a časový rozsah (např. 7d, 2mo) smaže dané období. Přidej uživatele, pokud chceš smazat jen jeho zprávy. Pozor: Discord botům neumožňuje hromadně mazat zprávy starší 14 dnů.
Příklad: .purge 50 · .purge 2mo · .purge all

Zabezpečení

/security
Anti-nuke, karanténní role a informace o ochraně.
/quarantine @user · /release @user
Seber členovi role a izoluj ho, nebo mu je vrať.
/security panic on|off
Nouzové uzamčení — zamkni kanály a/nebo dej nově příchozí do karantény.
/security let-in @user · let-in-remove @user · let-in-list
Pusť někoho rovnou přes filtry při vstupu, vyhození kvůli raidu při vstupu i ověření, třeba kamaráda se zbrusu novým účtem. Stejný seznam najdeš na stránce Příchody na server, a když kontroly při vstupu někoho odstraní, jeho záznam ve tvých logách má tlačítko, které ho pustí dovnitř.
Příklad: /security let-in @friend
/lockdown all|channel|end
Zamkni všechny kanály (nebo jen jeden), aby členové nemohli psát — /lockdown end zámek zruší a všechno vrátí.
Příklad: /lockdown all

Sledování heatu, filtry proti raidům & na vstupu, ověření i captcha se nastavují na dashboardu.

Levelování

/rank [@user]
Zobraz level & XP na rank kartě.
/leaderboard
Nejlepší členové podle XP.
/xp · /level
Admin: přidat/odebrat/nastavit členovi XP nebo level.
/leveling
Nastav kanál pro oznámení o postupu na vyšší level a importuj levely z jiných botů.

Ekonomika

/balance · /bank
Peněženka, banka a úroky.
/deposit · /withdraw · /pay
Přesuň nebo pošli mince.
/work · /crime · /rob · /daily
Vydělávej mince. Štěstí (z předmětů & cetek) zlepšuje šance u /crime, /rob, sběru a lootboxů.
/farm
Starej se o farmu z interaktivního panelu — sázej plodiny, sklízej je, prodávej úrodu a kupuj další políčka.
/fish · /hunt · /dig · /search
Sběratelské minihry, každá s vlastním cooldownem — najdi mince a zboží na prodej.
/pet
Adoptuj si mazlíčka, krm ho a každou hodinu z něj vybírej mince.
/trade @user
Nabídni obchod — mince a/nebo zboží — který druhý člen přijme, nebo odmítne.
/coinflip · /slots · /blackjack · /roulette · /highlow · /rps · /guess · /dice
Vsaď své mince — osm kasinových her.
/economy-info guide|games
Rychlý průvodce tím, jak celá ekonomika funguje, a všechny kasinové hry i s jejich výplatami. (.games stále funguje jako zkratka.)
/shop · /buy · /sell · /use · /open
Prohlížej obchod (tlačítka pro nákup), kupuj a prodávej předměty, používej spotřební zboží, otevírej lootboxy.
Příklad: .buy lucky coin 3
/inventory · /collect · /multipliers · /rich
Předměty, příjmové role, aktivní boosty & debuffy a žebříček boháčů.
/eco
Admin: dát/vzít mince nebo předměty z obchodu, udělit časované boosty, spustit úroky.
/lootbox
Správce: překvapivé lootboxy, o jejichž otevření členové závodí — shoď jeden hned teď, zapni nebo vypni automatické shozy, nastav, jak často padají a co vyplácejí (mince nebo XP).

Role & členové

/role <add|remove> <roles> (user or everyone) [duration]
Přidej nebo odeber jednu či více rolí členovi nebo všem. Zadáním doby se z role stane časovaná role — po vypršení se automaticky odebere.
Příklad: /role add roles:@VIP @Booster user:@someone duration:7d
/serverinfo
Statistiky serveru — vlastník, datum vzniku, členové, role, kanály, boosty.
/info [@user]
Stáří účtu člena, datum připojení, role a barva.
/av [@user]
Zobraz avatar uživatele v plné velikosti.
/roles
Vypiš každou roli i s jejím ID.
/dump [role]
Exportuj do souboru členy dané role (nebo celého serveru).
/oldest · /youngest
Člen s nejstarším / nejnovějším účtem na Discordu.
/clonecategory · /stylechannels · /cleanroles · /counters
Zkopíruj kategorii i s oprávněními, přidej kanálům emoji prefixy, odstraň ozdoby z názvů rolí, nastav živé statistické kanály.

Automatizace

/tag
Vlastní prefixové příkazy psané v TagScriptu — viz návod níže.
/reactionrole sync|list|convert
Odešli nebo obnov svá menu rolí, případně je všechna převeď mezi tlačítky / rozbalovacím seznamem / reakčními emoji.
/embed post|list|copy|color|edit|source
Všechny nástroje pro embedy v jednom příkazu — odešli nebo vypiš uložené embedy, kopíruj odeslané embedy mezi kanály či kategoriemi, přebarvi všechny embedy, které bot odeslal, uprav některý ze surového JSON nebo si stáhni embedy + obsah zprávy jako JSON.
/log list
Vypiš, kam se která událost loguje — samotné logování nastavíš na dashboardu.
/stealemoji <emoji> [name]
Přidej na tento server vlastní emoji z jiného serveru. Stránka Emojis na dashboardu spravuje celou tvoji sadu — nahrávání, přejmenování, mazání, převzetí i přehled o využitých slotech.

Automatizace (dashboard → Utilities → Automations) jsou pravidla typu „když se stane tohle, udělej tamto“: vyber spouštěč (odeslání zprávy, přidání reakce, příchod člena, přidání nebo odebrání role), přidej volitelné podmínky (kanál, role, klíčová slova, stáří účtu) a pak spusť až 10 akcí za sebou — poslat zprávu, embed nebo DM, přidat či odebrat roli, zareagovat, smazat zprávu nebo založit vlákno. Začni od hotových šablon jako Welcomer, Keyword auto-reply nebo Auto-thread — až 50 na server, zdarma.

Auto Send (dashboard → Utilities → Auto Send) posílá opakovanou zprávu v zadaném intervalu nebo denně v nastavený čas UTC — vyber dny v týdnu, kdy má běžet, přidej volitelné časové okno, zapni ochranu proti zahlcení (přeskočí odeslání, dokud je poslední zpráva bota stále nejnovější), nebo ji pošli jako embed.

Narozeniny

/birthday set <date> [year]
Ulož si narozeniny — MM-DD nebo YYYY-MM-DD. Přidej rok, pokud chceš slavit i věk.
Příklad: /birthday set 10-12 · /birthday set 1993-12-16
/birthday view [@user] · /birthday next
Zobraz narozeniny člena, nebo 10 nejbližších na serveru.
/birthday remove
Odstraň své uložené narozeniny.
/birthday set-user @user <date>
Admin: nastavit členovi narozeniny (Spravovat server).

Zapni oznámení v dashboardu (Nástroje → Narozeniny): vyber kanál, uprav zprávu a případně na ten den rozdej narozeninovou roli.

Úspěchy

/achievements [@user]
Tvůj (nebo cizí) postup v úspěších — každý odemčený stupeň a další cíl, s odkazem na veřejnou stránku úspěchů serveru.

Nastav je v dashboardu (Úspěchy): zapni funkci a dostaneš hotovou startovní sadu, pak přidej vlastní — jednorázové nebo stupňovité cíle Bronz → Diamant napříč zprávami, reakcemi, časem v hlasovém kanálu, vlákny, boosty, účastmi v giveaway, nákupy v obchodě a narozeninami, každý s volitelnými odměnami v podobě rolí a oznámením o odemčení.

Pozvánky

/invites me · /invites user @member
Kolik pozvánek máš ty (nebo jiný člen) — s rozpisem příchodů, odchodů a falešných.
Příklad: /invites user member: @friend
/invites leaderboard
Nejlepší zvoucí na serveru, seřazení.
/invites who-invited [@member]
Zjisti, kdo člena pozval. Každý příchod se připíše automaticky — funguje jakýkoli běžný odkaz s pozvánkou, žádný speciální sledovaný odkaz není potřeba.

Dolaď to v dashboardu (Pozvánky): ignoruj úplně nové účty jako falešné a automaticky rozdávej odměnové role při milnících v počtu pozvánek.

Giveaway

/giveaway start <duration> <prize> [winners]
Spusť giveaway s tlačítkem 🎉 Zúčastnit se, živým odpočtem a automatickým losováním výherců — nebo použij /giveaway create pro průvodce krok za krokem.
Příklad: /giveaway start duration: 1d prize: Nitro winners: 2
/giveaway end|reroll|cancel|delete|list
Ukonči ho dřív, vyber nové výherce, zruš ho nebo smaž, případně vypiš nedávné giveaway.

Editor Giveaway v dashboardu jde ještě dál — naplánuj nebo opakuj giveaway, nastav podmínky účasti a bonusové vstupy, rozdávej role výhercům, uprav embed a ukládej si přednastavení.

Tickety

Vytvoř ticket panely na dashboardu (modul Tickets). Členové otevřou ticket tlačítkem na panelu; tým ho převezme a zavře. Při zavření se uloží a odešle přepis s odkazem View Online Transcript, kterým si ho přečteš v prohlížeči.

/close [reason]
Zavři aktuální ticket a ulož jeho přepis.
/ticket add|remove|blacklist|unblacklist
Tým: přidej nebo odeber někoho z aktuálního ticketu, případně zablokuj otevírání ticketů někomu, kdo je opakovaně zneužívá.

Nástroje

/ping
Odezva bota.
/poll create|end
Vytvoř nativní anketu Discordu, ve které členové hlasují přímo ve zprávě, nebo ji ukonči dřív. Ankety umí založit i stránka Ankety v dashboardu — až s 10 odpověďmi, vlastní délkou trvání a výběrem více možností.
/voice rename|limit|lock|unlock|claim
Spravuj svůj dočasný hlasový kanál — přejmenuj ho, nastav limit uživatelů, zamkni nebo odemkni ho, případně si ho zaber, když majitel odešel.
Příklad: /voice rename name: Gaming · /voice lock

Dočasné hlasové kanály (dashboard → Utilities → Voice) fungují na principu připoj se a vytvoř: vyber jeden nebo víc hlavních hlasových kanálů a členové, kteří se do nich připojí, dostanou vedle nich svůj vlastní kanál — ten se automaticky smaže, jakmile se vyprázdní.

Jen pro operátora: /nuke channels, /nuke category a /restart jsou údržbové příkazy natvrdo uzamčené v kódu na operátora bota — tým serveru je spustit nemůže.

Upozornění

Dostávej upozornění, když tvůrce něco zveřejní. Na dashboardu (Socials) přidej odběry pro YouTube, Twitch, Kick, TikTok, Reddit (nové příspěvky ze subredditu), Podcast (nové epizody z RSS kanálu pořadu) nebo jakoukoli Custom RSS adresu — Octera pošle nová videa, příspěvky, epizody i začátky vysílání do kanálu, který si vybereš, s vlastní zprávou.

Hudba

Pouštěj hudbu v hlasovém kanálu s přehlednou frontou — bez dalšího bota navíc. (Premium.)

Vyhledej skladbu podle názvu, nebo vlož odkaz — SoundCloud, Bandcamp, podcast, internetové rádio nebo přímou URL adresu audia. Octera přečte většinu audio webů a řekne ti, odkud skladba pochází.

YouTube není k dispozici. YouTube blokuje požadavky na přehrávání přicházející od hostingových poskytovatelů, a právě tam běží každý Discord bot — odkazy na YouTube se proto odmítnou místo přehrání. Vyhledávání podle názvu funguje dál a přehrává z výše uvedených zdrojů. Odkazy na Spotify a Apple Music nedokáže přehrát žádný bot, protože jejich zvuk je šifrovaný; pošli místo toho název skladby.

/play <song or link>
Přehraj skladbu nebo ji přidej do fronty. Přijímá vyhledávání i odkaz z jakéhokoli webu, který Octera opravdu umí přehrát.
/skip · /stop
Přeskoč aktuální skladbu, nebo přehrávání zastav a opusť hlasový kanál.
/music join|controls|queue|nowplaying|loop|pause|resume
Všechno ostatní v jednom příkazu — připoj bota do hlasového kanálu, otevři ovládací panel s tlačítky, zobraz frontu i právě hrající skladbu, zapni smyčku pro skladbu nebo frontu, pozastav nebo pokračuj. (Staré zvyky s prefixem jako .queue a .pause fungují dál.)

Překlad

Členové, kteří nemluví stejným jazykem, si můžou povídat ve stejném kanálu. Nikdo přitom nemusí dělat nic jinak: kdo si chce zprávu přečíst, přidá k ní reakci s vlajkou svého jazyka a Octera ji pod ní vypíše v daném jazyce.

/translate text <text> <to> [from]
Přelož něco jednou. Začni psát jazyk a bot ti nabídne ty, které zná.
Příklad: /translate text text: where is the meeting to: Spanish
/translate live <from> <to>
Průběžně překládej všechno, co v tomto kanálu řekneš, dokud to nezastavíš nebo tři hodiny nic nenapíšeš.
Příklad: /translate live from: Chinese to: English
/translate off
Přestaň překládat, co v tomto kanálu píšeš.

Reakce vlajkou. Zareaguj na jakoukoli zprávu vlajkou, kterou Octera zná, a ona odpoví překladem. I když stejnou vlajkou zareaguje víc lidí, odpověď přijde stejně jen jedna, a reakce čímkoli jiným neudělá nic.

Celé kanály. Na dashboardu si můžeš vybrat kanál a jazyky, kterými se v něm mluví, až pět. Octera si sama určí, kterým směrem má každá zpráva jít, takže španělsky a anglicky mluvící člověk si spolu prostě popovídají. Zpráva, která už je v jednom z uvedených jazyků, se nikdy neopakuje ve svém vlastním jazyce. To se hodí pro kanál trvale rozdělený mezi jazyky; na příležitostné použití jsou reakce vlajkou mnohem levnější.

Živý překlad. Pro jednoho člověka, který se zapojí do konverzace v jazyce, kterým nemluví. Jednou spustí /translate live a všechno, co napíše, se zároveň odešle i v druhém jazyce — dokud nespustí /translate off nebo se neodmlčí. Vlastník serveru to může na dashboardu vypnout.

Překlad běží na externí překladatelské službě, takže ji vlastník serveru jednou nastaví na stránce Překlad v dashboardu. Dokud služba není připojená, stránka to rovnou napíše a nic se nepřekládá. Opakované překlady stejné zprávy jdou z cache a nic nestojí, a pro celý server můžeš nastavit měsíční limit znaků.

Zálohy

Ulož si z dashboardu snímek struktury svého serveru — rolí, kanálů, oprávnění a nastavení. Obnova znovu vytvoří vše, co chybí, aniž by smazala to, co už tam je. Zálohy nikdy neobsahují zprávy ani historii chatu.

Návod: proměnné ve zprávách

Kdekoli Octera píše zprávu, můžeš vložit proměnnou — krátký zástupný symbol {name}, který se při skutečném odeslání zprávy sám doplní. Fungují v uvítacích i rozlučkových zprávách, embedech, autoresponderech, tazích, auto-send, panelech reakčních rolí, ticket panelech a dalších — všude pod stejnými názvy.

Welcome {user.mention} to **{server}** — you're member #{server.members}!

Piš je s tečkou nebo se závorkami; je to totéž: {user.name} = {user(name)}.

Člen

ProměnnáDoplní se jako
{user}Jejich jméno
{user.mention}Skutečný @ping
{user.name}Jejich uživatelské jméno
{user.nick}Jejich přezdívka na tomto serveru (uživatelské jméno, pokud žádnou nemají)
{user.id}Jejich Discord ID
{avatar}Jejich profilový obrázek — vlož ho do pole pro obrázek nebo náhled
{user.color}Barva jejich jména, např. #a93bf0
{user.top_role}Název jejich nejvyšší role
{user.joinstamp}Kdy se připojili, jako číslo časového razítka
{user.timestamp}Kdy byl jejich účet vytvořen, jako číslo časového razítka

{target} funguje stejně pro prvního člověka @zmíněného v příkazu (jinak se použije ten, kdo příkaz spustil) — hodí se v tagách: {target.mention}, {target.avatar}.

Server & kanál

ProměnnáDoplní se jako
{server}Název serveru
{server.members}Počet členů
{server.ordinal}Počet členů jako pořadí — „42.“
{server.icon}Ikona serveru — použitelná v poli pro obrázek nebo náhled
{server.id}ID serveru
{server.description}Popis serveru
{channel}Název kanálu
{channel.mention}Klikatelný odkaz na #kanál

Obrázky z proměnných

Do slotů pro obrázek, náhled, ikonu autora i ikonu patičky můžeš místo odkazu vložit proměnnou — uvítací embed tak může ukázat avatar samotného nového člena:

Vlož {avatar} do pole thumbnail uvítacího embedu a každý nově příchozí uvidí v rohu svůj vlastní obrázek. {server.icon} funguje úplně stejně.

Do každého z těchto polí můžeš zadat i běžný odkaz https:// nebo použít Upload… přímo z počítače — Octera obrázek uloží a použije trvalý odkaz, takže bude fungovat navždy.

Dobré vědět

Správa serveru: zvláštnosti Discordu, které stojí za to znát

Pár věcí se na Discordu chová způsobem, který vypadá jako chyba, ale není — dřív nebo později na ně narazí skoro každý majitel serveru. Žádnou z nich nezpůsobuje Octera; řešení jsou vždy v nastavení samotného Discordu.

Uživatelské jméno se zobrazuje ve špatné barvě

Discord barví jméno podle nejvyšší role, která má barvu. Role nastavená na Default (bez barvy) se má přeskočit, takže bezbarvá role, kterou držíš nahoře — obvykle proto, aby ses v seznamu členů zobrazoval zvlášť — má barvu přenechat nižší roli.

Někdy ne. Discord si u role drží stará data o barvě i poté, co se role tváří jako bezbarvá, takže jméno zůstane viset na špatné barvě.

Donuť Discord načíst roli znovu:

  1. Otevři Nastavení serveru → Role, vyber dotčenou roli a přejdi na Zobrazení.
  2. Nastav ji na Jednobarevná, vyber jakoukoli viditelnou barvu a ulož.
  3. Otevři tutéž roli znovu, nastav ji zpět na Výchozí (bez barvy) a znovu ulož.
  4. Stiskni Ctrl + R a Discord se načte znovu.

Role se teď počítá jako opravdu bezbarvá: zůstane nahoře a dál zobrazuje členy zvlášť, a barvu jména převezme první role pod ní, která barvu má.

Vedle tvého jména zmizela korunka vlastníka

Korunka zmizí, když má některá z tvých rolí zapnuté obojí najednou:

Jak si udržet vlastní roli nahoře a získat zpět korunku:

  1. Otevři Nastavení serveru → Role a vyber svou osobní roli zobrazovanou odděleně.
  2. Vypni pro tu roli Administrator — Display role members separately nech zapnuté.
  3. Stiskni Ctrl + R a Discord se načte znovu.
Nic tím neztratíš: vlastník serveru už stejně má všechna oprávnění, takže osobní role Administrator nikdy nepotřebuje. Pro tým vytvoř zvlášť roli Admin se zapnutým Administratorem a vypnutým Display role members separately.

Návod: tvorba tag příkazů

Tagy jsou vlastní prefixové příkazy, které si napíšeš sám, poháněné TagScriptem — drobným šablonovacím jazykem s proměnnými, logikou, matematikou, náhodou a řídicími bloky (smazat spouštěcí zprávu, poslat odpověď do DM, zareagovat, omezit podle role, přiložit embed a další). Funguje tu i každá proměnná zprávy.

Vytvořit tag

Použij /tag (nebo dashboard → Nástroje → Tagy). Dej mu jméno a obsah. Členové ho spouštějí tvým prefixem, např. .rules.

/tag name: hello content: Hey {user(mention)}, welcome to {server(name)}! 👋

Spuštění .hello → Ahoj @You, vítej v Octeře! 👋

Proměnné

V tagu funguje každá proměnná zprávy — {user.mention}, {server}, {avatar} i všechny ostatní. Tagy přidávají několik vlastních:

ProměnnáVrátí ti
{args}Všechno, co napíšeš za příkazem. {args(1)} = první slovo, {args(2)} = druhé…
{target(mention)}První @zmínka ve zprávě (jinak ten, kdo příkaz spustil) — stejné atributy jako {user}
{uses}Kolikrát se tag spustil
{unix}Aktuální unixové časové razítko

Logika, matematika & náhoda

BlokovatCo dělá
{if(a==b):yes|no}Podmínka. Operátory: == != > < >= <=
{any(a==b|c==d):yes|no}any/or a all/and napříč několika podmínkami
{math:2*(3+4)}Aritmetika (+ - * / % ^)
{random:a~b~c}Vyber jednu náhodně (odděl pomocí ~ nebo ,)
{range:1-100}Náhodné celé číslo v rozsahu
{=(name):value}Nastav proměnnou; později ji přečteš pomocí {name}
{lower} {upper} {replace(a,b):text} {length:text}Pomůcky pro text

Řídicí bloky (vedlejší efekty)

BlokovatEfekt
{delete}Smazat zprávu, která tag spustila
{dm}Odešli odpověď místo toho do DM tomu, kdo příkaz spustil
{react:✅,🎉}Zareaguj na odpověď · {reactu:✅} reaguje na spouštěcí zprávu
{redirect:#channel}Odešli odpověď do jiného kanálu
{require(@Role)} / {blacklist(@Role)}Povol tag jen těmto rolím či kanálům / nebo jim ho naopak zakaž
{embed(title):Hi}{embed(description):...}Sestav bohatý embed (nadpis, popis, barva, obrázek, náhled, zápatí, pole)
{silent}Spusť vedlejší efekty tagu, aniž bys odeslal text

Ukázkové příklady

Schránka na návrhy — smaže příkaz a odešle do kanálu čistý embed:

{delete}{redirect:#suggestions}{embed(title):💡 Suggestion from {user(name)}}{embed(description):{args}}{embed(color):#a855f7}

Hod mincí s reakcemi:

{user(mention)} flips… **{random:Heads~Tails}**! {react:🪙}

Oznámení jen pro tým — omezené rolí, nikomu neposílá DM, publikuje do kanálu:

{require(@Staff):You can't use this.}{redirect:#announcements}📢 {args}

Personalizované uvítání pomocí zmíněného cíle:

{=(msg):Welcome {target(mention)} — you're member #{server(member_count)}!}{if({args}==):Mention someone to welcome them.|{msg}}
Cokoli zvládneš v tagu, můžeš postavit i vizuálně pomocí Message Templates a Autoresponders na dashboardu.