Vlastní boti | Dokumentace Noxyr

Co je vlastní bot

Vlastní bot je Noxyr běžící pod tokenem bota, který vlastníš. Členové vidí tvoje jméno a tvůj avatar, ale kód, nastavení i databáze jsou Noxyrovy. Změna provedená na dashboardu se použije pro oba boty a nic se nedublikuje.

Noxyr ho za tebe hostuje na jednom ze svých uzlů. Každý server patří přesně jednomu botovi: tam, kde je přítomen tvůj vlastní bot, Noxyr ustoupí a přestane odpovídat; tam, kde není, Noxyr pokračuje jako dřív. Jeden účet Discordu dostane jednoho vlastního bota a stejného bota můžeš používat na libovolném počtu serverů, které spravuješ.

Co potřebuješ

Hlas na Top.gg: Hlasování pro Noxyr odemkne formulář nastavení na 12 hodin. To je celá cena. Žádný placený plán neexistuje.
Vlastní aplikace: Vytvoř ji v Discord Developer Portal. Noxyrův vlastní token je odmítnut, stejně jako uživatelský token.
Dva privilegované intenty: Server Members Intent a Message Content Intent musí být zapnuté v Bot → Privileged Gateway Intents. Dashboard to před přijetím tokenu zkontroluje.
Noxyr na serveru: Tvůj vlastní bot běží s Noxyrovým nastavením a databází, takže Noxyr musí zůstat na každém serveru, který obsluhuje.
Administrátor: Vlastního bota pro server může nastavit jen ten, kdo může server na dashboardu otevřít.

Nastavení

Hlasuj pro Noxyr na Top.gg a pak na dashboardu serveru otevři Custom Bot.
V Developer Portal stiskni New Application a pojmenuj ji tak, jak se má bot jmenovat. Na záložce Bot nastav avatar a zapni oba privilegované intenty.
Stiskni Reset Token, zkopíruj ho jednou a vlož na stránku Custom Bot. Je uložen šifrovaně; čte ho jen web a uzel, který tvého bota provozuje.
Vyber hostitele (Automatic vybere nejrychlejší uzel s volnou kapacitou) a stiskni Start my bot.
Použij pozvánku, kterou stránka nabídne. Bot je online asi za dvacet sekund a registruje příkazy Noxyru pod svým jménem.

Token může později nahradit jen člověk, který ho vložil. Ostatní administrátoři serveru bota vidí, ale nemohou pod tvým jménem vložit jiný token.

Časové okno hlasování, lhůta a připomínky

Jeden hlas drží vlastního bota odemčeného 12 hodin, což je zároveň tak často, jak Top.gg umožňuje hlasovat. Když toto okno skončí, začne 74hodinová lhůta: bot běží dál, ale stránka Custom Bot se zamkne, dokud znovu nehlasuješ.

Připomínka přijde jako DM 24 hodin po posledním hlasu, tedy 12 hodin do lhůty, a ukáže odpočet do uzávěrky. Pokud vyprší i lhůta, bot přejde offline a jeho příkazy se ze serveru odeberou. Nic se nemaže: token, nastavení i každý tiket, produkt a faktura zůstávají na svém místě a jeden hlas vše znovu zapne.

Časové okno hlasování: 12 hodin od hlasu. Oba časovače se živě odpočítávají na stránce Custom Bot.
Lhůta: 74 hodin po uzavření okna. Bot zapnutý, dashboard zamčený.
Připomínka DM: Odesílá se jednou za okno, 24 hodin po hlasu.
Vypnuto: Po skončení lhůty. Zahlasuj znovu a bot se sám restartuje.

Více času bez hlasování

Hlasy nejsou jediný způsob, jak vlastního bota udržet v chodu. Každá možnost níže přidá hodiny k tomu, co ti zbývá, takže nic nepropadne. Stránka Get more time (Custom Bot → Get more time) ukazuje tvůj odpočet, stav u každé možnosti a každou hodinu, která ti byla připsána.

Noxyr Rush: Minihra v prohlížeči na webu. Dosáhni 3 000 bodů v jednom běhu a získej 12 hodin. Můžeš mít najednou 12 herních hodin; jakmile je vyčerpáš, můžeš je získat znovu. Čas získávají jen účty, které provozují vlastního bota, a server každý běh kontroluje.
Pozvi kamaráda: Sdílej svůj odkaz na doporučení ze stránky Get more time. Až kamarád nastaví svého prvního vlastního bota, dostanete oba 12 hodin. Počítá se jednou za kamaráda, jeho účet Discordu musí být starší 30 dní a můžeš takto získat čas od nejvýše 10 kamarádů každých 30 dní.
Hlášení chyb a návrhy: Pošli je přes Support Center. Když je tým Noxyr schválí, dostaneš 12 hodin, jednou za hlášení.
Od týmu: Tým Noxyr může čas přidat přímo, například po výpadku.

Když je Noxyr ze serveru odebrán

Protože vlastní bot závisí na přítomnosti Noxyru, vyhození Noxyru zastaví vlastního bota na tom serveru zhruba do minuty. Bot pošle DM tomu, kdo Noxyr odebral, a pokud to byla jiná osoba, také vlastníkovi bota, a to s pozvánkou.

Pozvi Noxyr zpět a vlastní bot se sám znovu spustí. Dokud je z tohoto důvodu zastavený, tvoje časové okno hlasování je pozastavené, nikoli spotřebované, pokud neběží žádný jiný tvůj bot.

Předání časového okna někomu jinému

Ten, kdo hlasuje, a ten, komu bot patří, nemusí být stejný účet. Na stránce Custom Bot můžeš svůj zbývající čas předat jinému uživateli Discordu podle jeho ID, buď celý, nebo určitý počet hodin.

Čas se připočte k tomu, co už příjemce má, takže převod mu nikdy neuškodí. Ty si ponecháš lhůtu, takže tvůj vlastní bot se neukončí uprostřed věty. Oba dostanete DM s informací, co se přesunulo.

Převést lze jen aktivní okno. Jakmile jsi v lhůtě, nemáš co předat. Převody kratší než pět minut jsou odmítnuty.

Řešení problémů

„Discord rejected this token“ (gateway kód 4004): Token byl v Developer Portal resetován, takže starý je neplatný. Bot je vypnutý, dokud znovu nestiskneš Reset Token a na stránku Custom Bot nevložíš nový.
„Discord refused the connection“ (gateway kód 4013 / 4014): Privilegovaný intent byl po nastavení vypnut. Znovu zapni Server Members Intent a Message Content Intent a pak bota z dashboardu znovu zapni.
„Vote on Top.gg first“: Tvoje časové okno hlasování vypršelo. Zahlasuj a zkus to znovu. Stránka se odemkne okamžitě.
„That bot is already the custom bot for someone else's server“: Jedna aplikace může patřit jednomu vlastníkovi. Vytvoř si novou aplikaci pro sebe.
„You already run …“: Jeden účet, jeden vlastní bot. Použij na tomto serveru i stávajícího bota (stránka ho nabídne), nebo ho nejdřív smaž.
Tlačítko Change Node je šedé (neaktivní): Každý přesun vyžaduje nové přihlášení na Discord, takže mezi jednotlivými přesuny je pětiminutová prodleva.
Stav ukazuje „suspended“: Buď vypršelo hlasování i lhůta, nebo byl Noxyr ze serveru odebrán. Stavová zpráva na stránce napoví, které z toho platí.