Preskočiť na obsah
VORQUL
Dokumentácia / Inštalácia

Nainštaluj VorqulBOT, self-hosted Discord bota

Dve cesty nasadenia, jedna konfigurácia. Časť na strane Discordu je v oboch prípadoch rovnaká a práve tu ľudia robia najviac chýb, preto je na začiatku.

Inštalácia VorqulBOT trvá asi 10 až 15 minút. Vytvor aplikáciu v Discord Developer Portal, zapni intenty pre prítomnosť, členov servera a obsah správ a skopíruj si token a ID aplikácie. Potom buď nainštaluj Node.js 22 LTS na čistý server s Debianom alebo Ubuntu, skopíruj .env.example do .env, spusti npm install a npm start a udrž bota nažive cez systemd, alebo importuj priložený egg do Pterodactyla, nahraj súbory a vyplň Startup premenné. Úložisko sú predvolene JSON súbory alebo MySQL/MariaDB, vyberáš ho jedným riadkom v .env.

Čas
Asi 10 až 15 minút
Runtime
Node.js 18+, odporúčame 22 LTS
Cesty
Server s Debianom alebo Ubuntu, Pterodactyl
Úložisko
JSON súbory alebo MySQL/MariaDB

Požiadavky

Minimálne požiadavky pred inštaláciou
RAM Minimum 512 MB, odporúčame 1 GB, 2 GB ak spúšťaš dashboard
CPU Minimum 1 jadro, odporúčame 2
Disk Minimum 500 MB, odporúčame 1 GB
Node.js Minimum 18, odporúčame 22 LTS (verzie 18 a 20 sú po konci podpory od upstreamu)
npm Je súčasťou Node.js, nič ďalšie netreba inštalovať
Databáza Voliteľná, JSON súbory nepotrebujú nič nainštalované
Requirements for Inštalácia VorqulBOT: RAM Minimum 512 MB, odporúčame 1 GB, 2 GB ak spúšťaš dashboard, CPU Minimum 1 jadro, odporúčame 2, Disk Minimum 500 MB, odporúčame 1 GB, Node.js Minimum 18, odporúčame 22 LTS (verzie 18 a 20 sú po konci podpory od upstreamu), npm Je súčasťou Node.js, nič ďalšie netreba inštalovať, Databáza Voliteľná, JSON súbory nepotrebujú nič nainštalované.

Táto polovica je rovnaká pre každú cestu nasadenia. Vynechanie intentov je najčastejší dôvod, prečo čerstvo nainštalovaný bot nerobí nič.

  1. Step 01

    V Discord Developer Portal vytvor novú aplikáciu, pridaj do nej bota a resetuj token, aby sa zobrazil.

    Token sa zobrazí iba raz. Ulož si ho na bezpečné miesto a nikdy ho necommituj, nevkladaj do support kanála ani na screenshot. Ak unikne, resetuj ho. Discord starý token okamžite zneplatní.

    Skopíruj si aj Application ID z General Information. Bot ho potrebuje ako DISCORD_CLIENT_ID na registráciu slash príkazov, takže je povinné, aj keď dashboard nikdy neotvoríš.

  2. Step 02

    V sekcii Bot, v Privileged Gateway Intents, zapni Presence Intent, Server Members Intent a Message Content Intent.

    Bez Message Content bot nevidí text správ, takže AutoMod, levelovanie, prefixové príkazy a sticky správy potichu nerobia nič. Bez Server Members nevie reagovať na pripojenia členov, čo vyradí uvítacie karty, role pri pripojení, sledovanie pozvánok a anti-raid.

    Ak sa bot pripojí, ale všetko ignoruje, vráť sa najprv k tomuto kroku.

  3. Step 03

    V sekcii OAuth2, v URL Generator, vyber scopes bot a applications.commands, zvoľ oprávnenia, potom otvor vygenerovanú URL a autorizuj bota na svojom serveri.

    Scope applications.commands je to, vďaka čomu sa zobrazí 83 slash príkazov. Ak ho vynecháš, bot sa pripojí na server bez jediného príkazu.

  4. Step 04

    V sekcii OAuth2, v General, resetuj a skopíruj Client Secret, potom pridaj svoju callback URL do Redirects.

    Treba iba vtedy, ak chceš webový dashboard. Samotný bot beží bez secretu aj bez akéhokoľvek redirectu.

    Redirect URL
    http://localhost:3000/api/auth/callback/discord
    https://your-domain.tld/api/auth/callback/discord

Dva skutočné backendy, jeden riadok v .env, žiadna samostatná edícia. Vyber podľa veľkosti servera a nenechaj sa mýliť názvami.

  1. Step 05

    Jeden súbor na tabuľku v data/json. Toto je predvolená voľba, nepotrebuje žiadnu službu ani nastavenie a beží na nej väčšina self-hosted inštancií.

    .env
    DATABASE_TYPE=json
    DATA_PATH=./data

    Bot si sám pridá /json k DATA_PATH, takže DATA_PATH=./data skončí v ./data/json. Nepíš sem ./data/json, inak sa súbory uložia o úroveň hlbšie.

  2. Step 06

    Nainštaluj server, vytvor databázu a používateľa s utf8mb4 a potom na ňu nasmeruj bota. Oplatí sa, keď je server veľký alebo chceš mať dáta pri iných službách.

    Potom nastav DATABASE_TYPE=mysql spolu s DB_HOST, DB_PORT, DB_USER, DB_PASSWORD a DB_NAME v .env.

    DATABASE_TYPE=sqlite nie je tretia možnosť. Táto verzia nemá SQLite ovládač, takže hodnota zapíše varovanie a potichu použije JSON súbory. Dáta sa stále ukladajú, ale napíš json, aby konfigurácia hovorila to, čo sa naozaj deje.

    MariaDB na Debiane
    sudo apt install -y mariadb-server
    sudo mysql
    
    CREATE DATABASE vorqul CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
    CREATE USER 'vorqul'@'localhost' IDENTIFIED BY 'your_password';
    GRANT ALL PRIVILEGES ON vorqul.* TO 'vorqul'@'localhost';
    FLUSH PRIVILEGES;

    utf8mb4 nie je voliteľné. Čokoľvek menšie pokazí emoji a diakritiku v uložených správach.

Cesta pre teba, ak máš vlastný stroj. Všetko nižšie beží pod bežným používateľom so sudo a samotný bot beží pod vyhradeným používateľom bez vlastného sudo.

  1. Step 07

    Aktualizuj systém, nainštaluj základné veci, pridaj repozitár NodeSource pre Node 22 a nainštaluj ho. npm je jeho súčasťou.

    bash
    sudo apt update && sudo apt upgrade -y
    sudo apt install -y curl ca-certificates git unzip
    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
    sudo apt install -y nodejs
    node --version
    npm --version

    node --version má vypísať v22.x. Bota spustí hocijaká verzia od v18 vyššie, ale 18 a 20 už nedostávajú bezpečnostné opravy od upstreamu.

  2. Step 08

    Samostatný používateľ drží token a dáta mimo dosahu všetkého ostatného na stroji.

    Druhý príkaz otvorí shell pod týmto používateľom. Všetky príkazy v ďalších krokoch bežia tam, až do kroku so systemd.

    bash
    sudo adduser --disabled-password --gecos "" --home /opt/vorqul vorqul
    sudo -iu vorqul
  3. Step 09

    Naklonuj repozitár do vlastného adresára alebo tam rozbaľ archív s vydaním. package.json musí ležať priamo v pracovnom adresári.

    Radšej archív s vydaním? Nahraj ho, spusti unzip a presuň obsah vyššie, aby package.json nebol o úroveň nižšie.

    bash
    git clone https://github.com/Yamiru/Vorqul-DS-BOT.git app
    cd app
  4. Step 10

    Skopíruj .env.example do .env a vyplň token, ID aplikácie a typ úložiska. Súbor obsahuje tajné údaje, takže obmedz, kto ho môže čítať.

    • DISCORD_TOKEN: povinné, z Developer Portal
    • DISCORD_CLIENT_ID: povinné, Application ID, a bez neho sa nezaregistruje žiadny slash príkaz
    • DATABASE_TYPE: json alebo mysql (pozri časť 2)
    • BOT_OWNER_ID: tvoje Discord ID, odomkne príkazy len pre vlastníka
    • DASHBOARD_ENABLED: nechaj false, ak dashboard nechceš (pozri nižšie)
    bash
    cp .env.example .env
    chmod 600 .env
    nano .env
  5. Step 11

    npm install stiahne závislosti, npm start skontroluje token, skompiluje TypeScript a spustí bota v popredí, takže môžeš sledovať prvý štart.

    Repozitár obsahuje .npmrc s legacy-peer-deps, ktorý zabráni npm odmietnuť inštaláciu kvôli konfliktom peer závislostí vo vývojárskych nástrojoch. Nemaž ho.

    Prvý štart kompiluje kód a trvá minútu alebo dve. Ďalšie štarty preskočia kompiláciu, kým sa nezmení zdroj. Keď uvidíš, že je online a slash príkazy sú zaregistrované, zastav ho cez Ctrl+C.

    bash
    npm install
    npm start

    Sleduj tento prvý beh. Chyby s tokenom, ID aplikácie alebo intentmi sa ukážu tu a nikde inde. Neinštaluj s --omit=dev ani NODE_ENV=production: kompilátor je vývojárska závislosť a build by zlyhal.

  6. Step 12

    Služba reštartuje proces, keď spadne, a po reštarte stroja ho vráti naspäť. Tento krok ľudia preskakujú a potom sa čudujú, prečo bot cez noc vypadol.

    Nepridávaj do unit súboru Environment=NODE_ENV=production. Launcher si sám spúšťa npm install a potom by preskočil vývojárske závislosti, ktoré potrebuje na kompiláciu. Produkčný režim pre dashboard nastaví sám.

    Launcher zapisuje aj vlastný rotovaný log do logs/current.log v adresári bota, vedľa žurnálu.

    Radšej PM2? sudo npm install -g pm2, potom pm2 start start.js --name vorqul, pm2 startup a pm2 save spravia to isté.

    bash (ako tvoj bežný používateľ, nie vorqul)
    sudo tee /etc/systemd/system/vorqul.service >/dev/null <<'EOF'
    [Unit]
    Description=Vorqul DS BOT
    After=network-online.target
    Wants=network-online.target
    
    [Service]
    Type=simple
    User=vorqul
    WorkingDirectory=/opt/vorqul/app
    ExecStart=/usr/bin/node start.js
    Restart=on-failure
    RestartSec=10
    
    [Install]
    WantedBy=multi-user.target
    EOF
    
    sudo systemctl daemon-reload
    sudo systemctl enable --now vorqul
    sudo systemctl status vorqul
    journalctl -u vorqul -f
  7. Step 13

    Dashboard nie je ďalšia vec na inštaláciu. Zapni ho v .env a ten istý launcher ho zostaví a spustí ako druhý proces na porte 3000.

    Reštartuj službu a daj prvému štartu pár minút navyše, lebo vtedy sa dashboard buildí. Ten build chce okolo 2 GB RAM.

    Nevystavuj port 3000 priamo. Daj pred neho nginx s certifikátom. Nechaj NEXTAUTH_URL prázdne a adresa sa zistí automaticky. Ak je NEXTAUTH_SECRET prázdny, launcher ho vygeneruje a uloží do data/secrets, takže prežije reštarty.

    Nastav ALLOWED_EMAILS na e-mail svojho Discord účtu, inak sa k dashboardu dostane každý, kto sa vie prihlásiť cez Discord.

    .env
    DASHBOARD_ENABLED=true
    DASHBOARD_PORT=3000
    DISCORD_CLIENT_SECRET=your_client_secret
    NEXTAUTH_SECRET=output_of_openssl_rand_-hex_32
    DASHBOARD_PASSWORD=

Cesta pre teba, ak už prevádzkuješ panel na hosting hier. Nikde nepotrebuješ shell.

  1. Step 14

    V admin sekcii otvor Nests, zvoľ Import Egg a nahraj egg-vorqul-d-s-bot.json z projektu.

    Egg nastaví štartovací príkaz na npm start a vytvorí ti Startup premenné vrátane dvoch povinných: DISCORD_TOKEN a DISCORD_CLIENT_ID. Ponúka obrazy Node.js 20 a Node.js 18. Oba fungujú, ale oba sú po konci podpory od upstreamu, takže ak tvoj panel ponúka ghcr.io/pterodactyl/yolks:nodejs_22, pridaj ho v egg v Docker Images a vyber ho pre server.

  2. Step 15

    Vytvor nový server na tomto egg s 1 GB RAM (2 GB, ak budeš spúšťať dashboard), 1 GB disku a bez zvláštneho limitu CPU.

    Sieťová alokácia je dôležitá len pre dashboard. Samotný bot sa pripája von k Discordu a nič nepočúva.

  3. Step 16

    Nahraj archív s vydaním cez File Manager alebo SFTP, rozbaľ ho a presuň obsah tak, aby package.json ležal v koreni kontajnera.

    Očakávaná štruktúra
    /home/container/
      bot.py
      start.js
      package.json
      package-lock.json
      .npmrc
      tsconfig.bot.json
      src/
      plugins/

    Ak package.json skončil v podpriečinku, launcher nenájde zdroj. Presuň všetko o úroveň vyššie.

  4. Step 17

    Token a typ úložiska sa zadávajú ako premenné prostredia, nie v súbore .env.

    • DISCORD_TOKEN: token tvojho bota
    • DISCORD_CLIENT_ID: Application ID, povinné
    • DATABASE_TYPE: json (predvolené) alebo mysql
    • BOT_OWNER_ID: tvoje Discord ID, odporúčané
    • DASHBOARD_ENABLED, DASHBOARD_PORT, DISCORD_CLIENT_SECRET, NEXTAUTH_URL a NEXTAUTH_SECRET treba iba pre dashboard

    Ak používaš databázový hostiteľ Pterodactyla: nastav DB_HOST na hostiteľa, ktorého panel ukazuje na karte Databases, a použi mená používateľa a databázy s prefixom, ktoré vygeneroval. Pre dashboard nechaj DASHBOARD_PORT prázdny, aby sa použil pridelený port, a nastav NEXTAUTH_URL na http alebo https presne tak, ako je naozaj dostupný.

  5. Step 18

    npm start na Node.js egg. python3 bot.py existuje ako alternatívny launcher, ale funguje len v kontajneri, ktorý má nainštalované aj Node.js a npm, čo obyčajný Python obraz nemá.

    Python launcher spúšťa iba bota, bez dashboardu. Používaj Node.js egg, pokiaľ nemáš dôvod robiť inak.

    Štartovací príkaz
    npm start
  6. Step 19

    Tieto príkazy bežia cez SSH na stroji, ktorý hostí Pterodactyl, nie v bote. Ak sa panel správa divne, reštartuj najprv pteroq a nginx. Ak sa servery nespúšťajú, reštartuj wings.

    bash
    sudo systemctl restart pteroq
    sudo systemctl restart nginx
    sudo systemctl restart wings
    sudo systemctl restart mariadb
    sudo systemctl restart redis-server
    sudo systemctl status wings
    sudo journalctl -u wings -f
  7. Step 20

    Prvý štart nainštaluje závislosti a skompiluje kód sám, čo trvá jednu až tri minúty. Potom sa bot objaví online.

    Ak sa hneď ukončí, pozri si výstup konzoly. Chýbajúci token alebo ID aplikácie tu zlyhá s jasnou hláškou. Konzola ukáže aj to, ak sa kompilácia vrátila k pomalšiemu runtime tsx.

Bot je online. Tri nastavenia rozhodnú, či bude užitočný alebo otravný.

  1. Step 21

    Deväť zo 44 modulov je zapnutých hneď po inštalácii: moderation, leveling, afk, polls, economy, games, giveaways, reminders a prefix commands. Všetko ostatné je zámerne vypnuté.

    Zapnúť AutoMod na živom serveri skôr, než ho nastavíš, znamená potrestať ľudí za správanie, ktoré bolo včera v poriadku. Filtre zapínaj po jednom.

  2. Step 22

    Urob to pred čímkoľvek iným. Bez log kanála sa moderátorské akcie dejú bez viditeľného záznamu a na prvý spor nebude odpoveď.

    Každá automatická aj manuálna akcia zapíše číslovaný prípad tak či tak, ale log kanál ju robí viditeľnou počas toho, ako sa deje.

  3. Step 23

    Spusti /info ping a /help. Ak bot odpovie a príkazy sa zobrazia, token, intenty aj registrácia príkazov fungujú.

    Chýbajúce slash príkazy znamenajú, že pri pozvánke chýbal scope applications.commands, alebo je DISCORD_CLIENT_ID prázdne či nesprávne. Discordu môže trvať pár minút, kým novo zaregistrované príkazy zobrazí.

Päť minút tu rozhodne o tom, či tvojho bota budú môcť používať cudzí ľudia.

  1. Step 24

    V Developer Portal otvor svoju aplikáciu, choď do Bot a vypni PUBLIC BOT.

    Keď je zapnutý, hocikto, kto pozná tvoje client ID, môže bota pridať na svoj server. Tento prepínač je jediná skutočná ochrana proti tomu.

  2. Step 25

    Nastav ALLOWED_EMAILS alebo ALLOWED_IDS v .env. Prihlásiť sa môžu len tieto účty a ľudia, ktorí spravujú server, na ktorom bot už je. Ostatní tlačidlo Add bot nevidia.

    DASHBOARD_PASSWORD pridá ďalšiu bránu pred prihlásenie. NEXTAUTH_SECRET vygeneruj raz cez openssl rand -hex 32 a uschovaj ho, lebo jeho zmena odhlási všetkých.

    Nastav BOT_OWNER_ID na svoje vlastné Discord ID. Príkazy vlastníka a správa pluginov patria len tomuto ID a viac ID sa oddeľuje čiarkami.

  3. Step 26

    Nikomu ho neposielaj a nikdy nenahrávaj .env na GitHub (je v .gitignore). Ak unikne, stlač Reset Token v Developer Portal a vlož nový.

Každá premenná, čo robí a či ju potrebuješ.

  1. Step 27

    Prvé dve sú povinné. Všetko ostatné má rozumnú predvolenú hodnotu.

    • DISCORD_TOKEN (povinné): token bota, Developer Portal, Bot, Reset Token
    • DISCORD_CLIENT_ID (povinné): Application ID, OAuth2, General
    • DISCORD_CLIENT_SECRET (len dashboard): OAuth2, Reset Secret
    • BOT_OWNER_ID (odporúčané): tvoje Discord ID
    • DATABASE_TYPE (povinné): json, ktorý nepotrebuje nič nainštalované, alebo mysql
    • DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME (len mysql): údaje na pripojenie k MySQL
    • DATA_PATH: priečinok s dátami, nechaj ./data
    • DASHBOARD_ENABLED: true zapne dashboard
    • DASHBOARD_PORT: port dashboardu, v Pterodactyle nechaj prázdny
    • NEXTAUTH_URL: nechaj prázdne, adresa sa zistí automaticky
    • NEXTAUTH_SECRET (dashboard): náhodný reťazec, ktorým sa podpisuje prihlásenie
    • DASHBOARD_PASSWORD: extra heslo pred dashboardom
    • ALLOWED_EMAILS, ALLOWED_IDS (odporúčané): kto sa môže prihlásiť, oddelené čiarkami
    • BOT_PREFIX: prefix pre textové príkazy, predvolene !
    • BOT_LANGUAGE: en, sk, cs, de, pl, ru, es, ja alebo tr
    • TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET: pre Twitch upozornenia
    • DISABLED_COMMANDS: príkazy, ktoré sa majú skryť z / menu, lebo Discord povoľuje 100
    • LOG_TO_FILE: true zapisuje logy do data/logs

    DATABASE_TYPE pokrýva len dáta ako ekonomika, varovania a tikety. Nastavenia servera (moduly, AutoMod, welcome) sú vždy v data/json/guild_settings.json. Prepnutie z json na mysql staré dáta samo nepresunie.

Šesť krokov a pri treťom sa väčšina ľudí zasekne.

  1. Step 28

    DASHBOARD_ENABLED=true, DISCORD_CLIENT_ID, DISCORD_CLIENT_SECRET a NEXTAUTH_SECRET.

  2. Step 29

    V Developer Portal, OAuth2, General, Redirects pridaj každú adresu, z ktorej sa prihlasuješ, doménu aj IP:port.

    Redirect URL
    http://YOUR-IP:PORT/api/auth/callback/discord
    https://your-domain.tld/api/auth/callback/discord
  3. Step 30

    Reštartuj bota, otvor http://YOUR-IP:PORT (port je DASHBOARD_PORT, alebo port pridelený serveru v Pterodactyle), stlač Sign in with Discord, schváľ prístup a vyber svoj server.

    Ak vidíš chybu spracovania autentifikácie, skontroluj DISCORD_CLIENT_ID a DISCORD_CLIENT_SECRET alebo vymaž cookies pre stránku.

Krátka prehliadka, aby si vedel, čo hľadať.

  1. Step 31

    Všetko nižšie funguje pre každý server z jedného prihlásenia.

    • Prehľad servera, Server Health Score a analytika správ, pripojení a odchodov
    • 44 modulov na zapínanie a vypínanie: moderation, AutoMod, anti-nuke, anti-raid, levely, ekonomika, tikety, welcome, reaction roles, giveaways a ďalšie
    • Nastavenia v záložkách a obmedzenie modulov na vybrané kanály
    • Embed builder a knižnica uložených správ
    • Záloha a obnova v troch režimoch: úplná, iba server, iba nastavenia bota
    • Pluginy: inštalácia zo ZIP, zapnutie, vypnutie a konfigurácia
    • Role Manager: vybraná rola môže spravovať server v dashboarde, ale nie pluginy
    • Verzia bota s upozornením, keď vyjde novšia
    • 9 jazykov a tlačidlá na obnovenie a vymazanie cache v každej záložke
  2. Step 32

    Päť obrazoviek v poradí, v akom sa s nimi stretneš.

    • Gate: voliteľná obrazovka s heslom, zapína sa cez DASHBOARD_PASSWORD
    • Login: prihlásenie cez Discord
    • Výber servera: zoznam serverov, ktoré spravuješ a kde je bot prítomný
    • Domov servera: stav bota s online stavom, pingom, uptime, pamäťou a CPU, štatistiky servera a upozornenie na dostupnú aktualizáciu
    • Settings: jedna stránka so záložkami, uvedenými v ďalšom kroku
  3. Step 33

    Každá záložka zoskupuje súvisiace moduly, takže funkcia je vždy na jedno kliknutie od svojho prepínača.

    • General: jazyk, prefix a rola správcu
    • Channels a Channel scopes: obmedz, kde bot funguje
    • Modules: zapni alebo vypni každú funkciu
    • Moderation a security: AutoMod, Warnings, Appeals, Verification a Logging
    • Members: Welcome a Goodbye, Reaction roles a Birthday
    • Engagement: Leveling, Starboard, Suggestions, Reputation, Counting, Confessions a Giveaways
    • Economy a games: Economy a Games
    • Content: Tickets, Applications, Autoresponse, Sticky messages, Tags, Feeds (RSS, YouTube, Twitch, Reddit), Socials a Reminders
    • Tools: Temp channels, Crypto, Backup a Restore, Webhooks, Embed builder, Links a Help
    • Admin: Analytics, Audit log, API keys, Plugins (nahratie ZIP, len vlastník) a Premium
  4. Step 34

    Slash príkazy a tie isté príkazy s prefixom !, zoskupené podľa oblasti.

    • Moderation: ban, tempban, softban, unban, kick, mute, unmute, timeout, voicemute, warn, notes, case, jail, shadowmute, clear, cleanup, lock, lockdown, slowmode, nick, role, timedrole, filter, altcheck a permcheck
    • Security: AutoMod, anti-nuke, anti-raid lockdown, verifikácia, odvolania, logy správ a servera, snapshoty rolí a Persist, ktorý obnoví roly a prezývku, keď sa člen vráti
    • Members: uvítacie a rozlúčkové správy, role pri pripojení, reaction roles, menu rolí, sledovanie pozvánok, história mien a referrals
    • Engagement: XP a levely s rolami za level, rank a rebríčky pre správy a voice, starboard, suggestions, reputácia, counting kanál, narodeniny, confessions, AFK, ankety, streaky, questy a giveaways
    • Economy: balance, daily, work, pay, bank, shop, market, lootbox, spin a heist
    • Games: 8ball, coinflip, dice, rock-paper-scissors, tictactoe, connect4, trivia, matchmaking a štatistiky hier
    • Nástroje na obsah: tikety, žiadosti, autoodpovede, sticky správy, tagy, feedy a socials, reminders, digest a príkazy, ktoré odpovedajú na to, čo som zmeškal a prečo som dostal ban
    • Utility: dočasné voice kanály, ceny kryptomien, stav Minecraftu, info, help, linky, záloha, webhook udalosti, API kľúče s read-only v1 stats API a Premium
    • Pluginy: pluginy typu drop-in ako sample_plugin, minecraft_status a fear_greed, každý s nastaveniami pre jednotlivé servery

Launcher si všimne, čo sa zmenilo, takže aktualizácia je krátka.

  1. Step 35

    Stiahni nové súbory a zachovaj .env a adresár data, potom reštartuj. Launcher preinštaluje závislosti, keď sa zmení package.json, a prekompiluje, keď sa zmení zdroj.

    V Pterodactyle nahraj nové súbory cez staré bez mazania .env, data a plugins a potom reštartuj server. Nastavenia sa prenesú cez migrácie schémy.

    bash
    sudo -iu vorqul
    cd app
    git pull
    exit
    sudo systemctl restart vorqul

Riešenie problémov

The failures that actually happen, and what causes them.

Otázky k inštalácii

Zhrnutie

Inštalácia VorqulBOT trvá asi 10 až 15 minút. Vytvor aplikáciu v Discord Developer Portal, zapni intenty pre prítomnosť, členov servera a obsah správ a skopíruj si token a ID aplikácie. Potom buď nainštaluj Node.js 22 LTS na čistý server s Debianom alebo Ubuntu, skopíruj .env.example do .env, spusti npm install a npm start a udrž bota nažive cez systemd, alebo importuj priložený egg do Pterodactyla, nahraj súbory a vyplň Startup premenné. Úložisko sú predvolene JSON súbory alebo MySQL/MariaDB, vyberáš ho jedným riadkom v .env.

  • Čas: Asi 10 až 15 minút
  • Runtime: Node.js 18+, odporúčame 22 LTS
  • Cesty: Server s Debianom alebo Ubuntu, Pterodactyl
  • Úložisko: JSON súbory alebo MySQL/MariaDB
Pojmy na tejto stránke

Pterodactyl egg Self-hosted Privilegované intenty Slash príkaz Prihlásenie do dashboardu cez OAuth2 Register modulov Prefixový most

Súvisiace

Reviewed