Przejdź do treści
VORQUL
Dokumentacja / Instalacja

Zainstaluj VorqulBOT, bota na Discorda hostowanego na własnym serwerze

Dwie ścieżki wdrożenia, jedna konfiguracja. Strona Discorda jest taka sama w obu przypadkach i to właśnie tu ludzie najczęściej się mylą, więc zaczynamy od niej.

Instalacja VorqulBOT zajmuje około 10 do 15 minut. Utwórz aplikację w Discord Developer Portal, włącz intenty presence, server members i message content, a następnie skopiuj token i ID aplikacji. Potem albo zainstaluj Node.js 22 LTS na czystym serwerze Debian lub Ubuntu, skopiuj .env.example do .env, uruchom npm install i npm start i utrzymuj bota przy życiu przez systemd, albo zaimportuj dołączony egg do Pterodactyl, wgraj pliki i uzupełnij zmienne Startup. Dane domyślnie trafiają do plików JSON albo do MySQL/MariaDB, co wybierasz jedną linijką w .env.

Czas
Około 10 do 15 minut
Środowisko
Node.js 18+, zalecane 22 LTS
Ścieżki
Serwer Debian lub Ubuntu, Pterodactyl
Dane
Pliki JSON lub MySQL/MariaDB

Wymagania

Minimalne wymagania przed instalacją
RAM Minimum 512 MB, zalecany 1 GB, 2 GB jeśli uruchamiasz panel (dashboard)
CPU Minimum 1 rdzeń, zalecane 2
Dysk Minimum 500 MB, zalecany 1 GB
Node.js Minimum 18, zalecane 22 LTS (18 i 20 są już po końcu wsparcia upstream)
npm Dostarczany z Node.js, nie trzeba nic instalować osobno
Baza danych Opcjonalna, pliki JSON nie wymagają niczego do zainstalowania
Requirements for Instalacja VorqulBOT: RAM Minimum 512 MB, zalecany 1 GB, 2 GB jeśli uruchamiasz panel (dashboard), CPU Minimum 1 rdzeń, zalecane 2, Dysk Minimum 500 MB, zalecany 1 GB, Node.js Minimum 18, zalecane 22 LTS (18 i 20 są już po końcu wsparcia upstream), npm Dostarczany z Node.js, nie trzeba nic instalować osobno, Baza danych Opcjonalna, pliki JSON nie wymagają niczego do zainstalowania.

Ta część jest identyczna dla każdej ścieżki wdrożenia. Pominięcie intentów to najczęstszy powód, dla którego świeżo zainstalowany bot nic nie robi.

  1. Step 01

    W Discord Developer Portal utwórz nową aplikację, dodaj do niej bota i zresetuj token, żeby go zobaczyć.

    Token jest pokazywany tylko raz. Skopiuj go w bezpieczne miejsce i nigdy go nie commituj, nie wklejaj na kanał pomocy ani nie umieszczaj na zrzucie ekranu. Jeśli wycieknie, zresetuj go. Discord od razu unieważnia stary.

    Skopiuj też Application ID z zakładki General Information. Bot potrzebuje go jako DISCORD_CLIENT_ID do rejestracji komend slash, więc jest wymagane, nawet jeśli nigdy nie otworzysz panelu.

  2. Step 02

    W sekcji Bot, w Privileged Gateway Intents, włącz Presence Intent, Server Members Intent i Message Content Intent.

    Bez Message Content bot nie widzi treści wiadomości, więc AutoMod, poziomy, komendy z prefiksem i przypięte wiadomości po cichu nie działają. Bez Server Members nie może reagować na dołączenia, co wyłącza karty powitalne, role startowe, śledzenie zaproszeń i anti-raid.

    Jeśli bot się łączy, ale ignoruje wszystko, wróć najpierw do tego kroku.

  3. Step 03

    W sekcji OAuth2, w URL Generator, wybierz zakresy bot i applications.commands, zaznacz uprawnienia, a potem otwórz wygenerowany adres URL i autoryzuj bota na swoim serwerze.

    Zakres applications.commands sprawia, że pojawia się 83 komend slash. Jeśli go pominiesz, bot dołączy do serwera bez ani jednej komendy.

  4. Step 04

    W sekcji OAuth2, w General, zresetuj i skopiuj Client Secret, a potem dodaj swój callback URL do Redirects.

    Potrzebne tylko, jeśli chcesz używać panelu webowego. Sam bot działa bez sekretu i bez żadnego przekierowania.

    Adresy przekierowań
    http://localhost:3000/api/auth/callback/discord
    https://your-domain.tld/api/auth/callback/discord

Dwa prawdziwe backendy, jedna linijka w .env, żadnej osobnej edycji. Wybierz według wielkości serwera i nie sugeruj się nazwami.

  1. Step 05

    Jeden plik na tabelę w data/json. To ustawienie domyślne, nie wymaga żadnej usługi ani konfiguracji i na tym działa większość instancji hostowanych samodzielnie.

    .env
    DATABASE_TYPE=json
    DATA_PATH=./data

    Bot sam dopisuje /json do DATA_PATH, więc DATA_PATH=./data kończy w ./data/json. Nie wpisuj tu ./data/json, bo pliki wylądują o jeden poziom za głęboko.

  2. Step 06

    Zainstaluj serwer, utwórz bazę i użytkownika z utf8mb4, a potem wskaż je botowi. Warto, gdy serwer jest duży albo chcesz mieć dane obok innych usług.

    Następnie ustaw w .env DATABASE_TYPE=mysql razem z DB_HOST, DB_PORT, DB_USER, DB_PASSWORD i DB_NAME.

    DATABASE_TYPE=sqlite nie jest trzecią opcją. Ta wersja nie ma sterownika SQLite, więc taka wartość zapisuje ostrzeżenie w logu i po cichu używa plików JSON. Twoje dane nadal się zapisują, ale wpisz json, żeby konfiguracja mówiła, co naprawdę się dzieje.

    MariaDB na Debianie
    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 jest opcjonalne. Cokolwiek innego psuje emoji i znaki diakrytyczne w zapisanych wiadomościach.

Ścieżka dla tych, którzy mają własną maszynę. Wszystko poniżej działa jako zwykły użytkownik z sudo, a sam bot działa jako osobny użytkownik bez własnego sudo.

  1. Step 07

    Zaktualizuj system, zainstaluj podstawowe pakiety, dodaj repozytorium NodeSource dla Node 22 i zainstaluj go. npm jest w zestawie.

    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 powinno wypisać v22.x. Wszystko od v18 w górę uruchomi bota, ale 18 i 20 nie dostają już poprawek bezpieczeństwa od upstream.

  2. Step 08

    Osobny użytkownik chroni token i dane przed resztą rzeczy na maszynie.

    Druga komenda otwiera powłokę jako ten użytkownik. Każda komenda w kolejnych krokach działa tam, aż do kroku z systemd.

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

    Sklonuj repozytorium do osobnego katalogu albo rozpakuj tam archiwum wydania. package.json musi leżeć bezpośrednio w katalogu roboczym.

    Wolisz archiwum wydania? Wgraj je, uruchom unzip i przenieś zawartość wyżej, tak żeby package.json nie był piętro niżej.

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

    Skopiuj .env.example do .env i uzupełnij token, ID aplikacji oraz typ przechowywania danych. Plik zawiera sekrety, więc ogranicz, kto może go czytać.

    • DISCORD_TOKEN: wymagany, z Developer Portal
    • DISCORD_CLIENT_ID: wymagany, to Application ID, a bez niego nie zarejestruje się żadna komenda slash
    • DATABASE_TYPE: json lub mysql (zobacz Część 2)
    • BOT_OWNER_ID: twoje ID użytkownika Discorda, odblokowuje komendy tylko dla właściciela
    • DASHBOARD_ENABLED: zostaw false, chyba że chcesz panel (zobacz niżej)
    bash
    cp .env.example .env
    chmod 600 .env
    nano .env
  5. Step 11

    npm install pobiera zależności, a npm start sprawdza token, kompiluje TypeScript i uruchamia bota na pierwszym planie, żebyś mógł obserwować pierwszy start.

    Repozytorium zawiera plik .npmrc z legacy-peer-deps, który powstrzymuje npm przed odmową instalacji z powodu konfliktów peer dependency w narzędziach deweloperskich. Nie usuwaj go.

    Pierwszy start kompiluje kod i trwa minutę lub dwie. Kolejne starty pomijają kompilację, dopóki kod źródłowy się nie zmieni. Zatrzymaj go przez Ctrl+C, gdy zobaczysz, że jest online i komendy slash się zarejestrowały.

    bash
    npm install
    npm start

    Obserwuj ten pierwszy start. Błędy dotyczące tokena, ID aplikacji czy intentów pojawiają się tutaj i nigdzie indziej. Nie instaluj z --omit=dev ani NODE_ENV=production: kompilator jest zależnością deweloperską i build się nie uda.

  6. Step 12

    Usługa restartuje proces, gdy ten padnie, i przywraca go po restarcie maszyny. To krok, który ludzie pomijają, a potem dziwią się, czemu bot padł w nocy.

    Nie dodawaj Environment=NODE_ENV=production do pliku unit. Launcher sam uruchamia npm install i pominąłby wtedy zależności deweloperskie potrzebne do kompilacji. Tryb produkcyjny dla panelu ustawia sam.

    Launcher zapisuje też własny rotowany log w logs/current.log w katalogu bota, obok dziennika journala.

    Wolisz PM2? sudo npm install -g pm2, a potem pm2 start start.js --name vorqul, pm2 startup i pm2 save robią to samo.

    bash (jako twój zwykły użytkownik, 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

    Panel to nie osobna rzecz do instalowania. Włącz go w .env, a ten sam launcher zbuduje go i uruchomi jako drugi proces na porcie 3000.

    Zrestartuj usługę i daj pierwszemu startowi kilka minut więcej, bo wtedy buduje się panel. Ten build potrzebuje około 2 GB RAM.

    Nie wystawiaj portu 3000 bezpośrednio. Postaw przed nim nginx z certyfikatem. Zostaw NEXTAUTH_URL puste, a adres zostanie wykryty automatycznie. Jeśli NEXTAUTH_SECRET jest puste, launcher wygeneruje go i zapisze w data/secrets, więc przetrwa restarty.

    Ustaw ALLOWED_EMAILS na e-mail swojego konta Discord, inaczej każdy, kto może zalogować się przez Discorda, dostanie się do panelu.

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

Ścieżka dla tych, którzy już prowadzą panel hostingu gier. W żadnym momencie nie potrzeba powłoki.

  1. Step 14

    W panelu administratora otwórz Nests, wybierz Import Egg i wgraj egg-vorqul-d-s-bot.json z projektu.

    Egg ustawia komendę startową na npm start i tworzy za ciebie zmienne Startup, w tym dwie wymagane: DISCORD_TOKEN i DISCORD_CLIENT_ID. Oferuje obrazy Node.js 20 i Node.js 18. Oba działają, ale oba są po końcu wsparcia upstream, więc jeśli twój panel udostępnia ghcr.io/pterodactyl/yolks:nodejs_22, dodaj go w Docker Images eggu i wybierz dla serwera.

  2. Step 15

    Utwórz nowy serwer na tym eggu z 1 GB RAM (2 GB, jeśli będziesz uruchamiać panel), 1 GB dysku i bez specjalnego limitu CPU.

    Alokacja sieciowa ma znaczenie tylko dla panelu. Sam bot łączy się na zewnątrz z Discordem i na niczym nie nasłuchuje.

  3. Step 16

    Wgraj archiwum wydania przez File Manager albo SFTP, rozpakuj je i przenieś zawartość tak, żeby package.json leżał w głównym katalogu kontenera.

    Oczekiwany układ
    /home/container/
      bot.py
      start.js
      package.json
      package-lock.json
      .npmrc
      tsconfig.bot.json
      src/
      plugins/

    Jeśli package.json wylądował w podfolderze, launcher nie znajdzie kodu źródłowego. Przenieś wszystko o jeden poziom wyżej.

  4. Step 17

    Token i typ przechowywania danych podajesz jako zmienne środowiskowe, a nie w pliku .env.

    • DISCORD_TOKEN: token twojego bota
    • DISCORD_CLIENT_ID: Application ID, wymagane
    • DATABASE_TYPE: json (domyślnie) lub mysql
    • BOT_OWNER_ID: twoje ID użytkownika Discorda, zalecane
    • DASHBOARD_ENABLED, DASHBOARD_PORT, DISCORD_CLIENT_SECRET, NEXTAUTH_URL i NEXTAUTH_SECRET są potrzebne tylko dla panelu

    Korzystanie z hosta bazy danych Pterodactyl: ustaw DB_HOST na host pokazany w zakładce Databases w panelu i użyj nazw użytkownika i bazy z prefiksem, które wygenerował. Dla panelu zostaw DASHBOARD_PORT puste, żeby użyć przydzielonego portu, i ustaw NEXTAUTH_URL jako http lub https dokładnie tak, jak jest naprawdę osiągalny.

  5. Step 18

    npm start na eggu Node.js. python3 bot.py istnieje jako alternatywny launcher, ale działa tylko w kontenerze, który ma też zainstalowane Node.js i npm, czego zwykły obraz Pythona nie ma.

    Launcher Pythona uruchamia tylko bota, bez panelu. Używaj eggu Node.js, chyba że masz powód, żeby nie.

    Komenda startowa
    npm start
  6. Step 19

    Te komendy uruchamiasz przez SSH na maszynie, która hostuje Pterodactyl, nie wewnątrz bota. Jeśli panel dziwnie się zachowuje, najpierw zrestartuj pteroq i nginx. Jeśli serwery się nie uruchamiają, zrestartuj 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

    Pierwszy start sam instaluje zależności i kompiluje kod, co trwa od jednej do trzech minut. Potem bot wchodzi online.

    Jeśli kończy się od razu, przeczytaj wyjście konsoli. Brakujący token lub ID aplikacji kończy się tu jasnym komunikatem. Konsola pokaże też, czy kompilacja przeszła na wolniejsze środowisko tsx.

Bot jest online. Trzy ustawienia decydują, czy będzie przydatny, czy irytujący.

  1. Step 21

    Dziewięć z 44 modułów jest włączonych od razu: moderacja, poziomy, afk, ankiety, ekonomia, gry, konkursy, przypomnienia i komendy z prefiksem. Wszystko inne jest domyślnie wyłączone, celowo.

    Włączenie AutoMod na działającym serwerze, zanim go skonfigurujesz, to prosty sposób, żeby karać ludzi za zachowanie, które wczoraj było w porządku. Włączaj filtry po jednym.

  2. Step 22

    Zrób to przed wszystkim innym. Bez kanału logów akcje moderacji dzieją się bez widocznego śladu, a pierwszy spór będzie nie do rozstrzygnięcia.

    Każda akcja, automatyczna i ręczna, i tak zapisuje numerowany case, ale to kanał logów sprawia, że widać ją na bieżąco.

  3. Step 23

    Uruchom /info ping i /help. Jeśli bot odpowiada i komendy są wylistowane, token, intenty i rejestracja komend działają.

    Brak komend slash oznacza, że w zaproszeniu pominięto zakres applications.commands albo DISCORD_CLIENT_ID jest puste lub błędne. Discord może potrzebować kilku minut, żeby pokazać nowo zarejestrowane komendy.

Pięć minut tutaj decyduje o tym, czy obcy mogą używać twojego bota.

  1. Step 24

    W Developer Portal otwórz swoją aplikację, przejdź do Bot i wyłącz PUBLIC BOT.

    Gdy jest włączony, każdy, kto zna twoje client ID, może dodać bota na swój serwer. Ten przełącznik to jedyna prawdziwa ochrona przed tym.

  2. Step 25

    Ustaw ALLOWED_EMAILS lub ALLOWED_IDS w .env. Zalogować się mogą tylko te konta oraz osoby, które zarządzają serwerem, na którym bot już jest. Pozostali nie widzą przycisku Add bot.

    DASHBOARD_PASSWORD dodaje jeszcze jedną bramkę przed logowaniem. Wygeneruj NEXTAUTH_SECRET raz przez openssl rand -hex 32 i zachowaj go, bo jego zmiana wylogowuje wszystkich.

    Ustaw BOT_OWNER_ID na swoje ID na Discordzie. Komendy właściciela i zarządzanie pluginami należą tylko do tego ID, a kilka ID oddziela się przecinkami.

  3. Step 26

    Nigdy nikomu go nie wysyłaj i nigdy nie wgrywaj .env na GitHuba (jest w .gitignore). Jeśli wycieknie, naciśnij Reset Token w Developer Portal i wklej nowy.

Każda zmienna, co robi i czy jej potrzebujesz.

  1. Step 27

    Pierwsze dwie są wymagane. Cała reszta ma rozsądne wartości domyślne.

    • DISCORD_TOKEN (wymagane): token bota, Developer Portal, Bot, Reset Token
    • DISCORD_CLIENT_ID (wymagane): Application ID, OAuth2, General
    • DISCORD_CLIENT_SECRET (tylko panel): OAuth2, Reset Secret
    • BOT_OWNER_ID (zalecane): twoje ID na Discordzie
    • DATABASE_TYPE (wymagane): json, który nie wymaga niczego do zainstalowania, albo mysql
    • DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME (tylko mysql): dane połączenia z MySQL
    • DATA_PATH: folder z danymi, zostaw ./data
    • DASHBOARD_ENABLED: true włącza panel
    • DASHBOARD_PORT: port panelu, w Pterodactyl zostaw puste
    • NEXTAUTH_URL: zostaw puste, adres jest wykrywany automatycznie
    • NEXTAUTH_SECRET (panel): losowy ciąg, który podpisuje logowanie
    • DASHBOARD_PASSWORD: dodatkowe hasło przed panelem
    • ALLOWED_EMAILS, ALLOWED_IDS (zalecane): kto może się zalogować, oddzielone przecinkami
    • BOT_PREFIX: prefiks komend tekstowych, domyślnie !
    • BOT_LANGUAGE: en, sk, cs, de, pl, ru, es, ja lub tr
    • TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET: do powiadomień z Twitcha
    • DISABLED_COMMANDS: komendy do ukrycia w menu /, bo Discord pozwala na 100
    • LOG_TO_FILE: true zapisuje logi w data/logs

    DATABASE_TYPE obejmuje tylko dane takie jak ekonomia, ostrzeżenia i tickety. Ustawienia serwera (moduły, AutoMod, powitania) zawsze leżą w data/json/guild_settings.json. Przejście z json na mysql nie przenosi starych danych samo z siebie.

Sześć kroków, a w trzecim większość ludzi utyka.

  1. Step 28

    DASHBOARD_ENABLED=true, DISCORD_CLIENT_ID, DISCORD_CLIENT_SECRET i NEXTAUTH_SECRET.

  2. Step 29

    W Developer Portal, OAuth2, General, Redirects, dodaj każdy adres, z którego się logujesz, zarówno domenę, jak i IP:port.

    Adresy przekierowań
    http://YOUR-IP:PORT/api/auth/callback/discord
    https://your-domain.tld/api/auth/callback/discord
  3. Step 30

    Zrestartuj bota, otwórz http://YOUR-IP:PORT (port to DASHBOARD_PORT albo port przydzielony serwerowi w Pterodactyl), naciśnij Sign in with Discord, zatwierdź dostęp i wybierz swój serwer.

    Jeśli widzisz błąd przetwarzania uwierzytelnienia, sprawdź DISCORD_CLIENT_ID i DISCORD_CLIENT_SECRET albo wyczyść ciasteczka dla tej strony.

Krótka wycieczka, żebyś wiedział, czego szukać.

  1. Step 31

    Wszystko poniżej działa osobno dla każdego serwera, z jednego logowania.

    • Przegląd serwera, Server Health Score i statystyki wiadomości, dołączeń i wyjść
    • 44 moduły do włączania i wyłączania: moderacja, AutoMod, anti-nuke, anti-raid, poziomy, ekonomia, tickety, powitania, role z reakcji, konkursy i więcej
    • Ustawienia w zakładkach, plus ograniczanie modułów do wybranych kanałów
    • Kreator embedów i biblioteka zapisanych wiadomości
    • Kopia zapasowa i przywracanie w trzech trybach: pełny, tylko serwer, tylko ustawienia bota
    • Pluginy: instalacja z ZIP, włączanie, wyłączanie i konfiguracja
    • Role Manager: wybrana rola może zarządzać serwerem w panelu, ale nie pluginami
    • Wersja bota z powiadomieniem, gdy wyjdzie nowsza
    • 9 języków oraz przyciski odświeżania i czyszczenia cache w każdej zakładce
  2. Step 32

    Pięć ekranów, w kolejności, w jakiej je spotkasz.

    • Gate: opcjonalny ekran z hasłem, włączany przez DASHBOARD_PASSWORD
    • Login: zaloguj się przez Discorda
    • Wybór serwera: lista serwerów, którymi zarządzasz i na których jest bot
    • Strona główna serwera: status bota ze stanem online, pingiem, czasem działania, pamięcią i CPU, statystyki serwera oraz powiadomienie o dostępnej aktualizacji
    • Ustawienia: jedna strona z zakładkami, wymienionymi w następnym kroku
  3. Step 33

    Każda zakładka grupuje powiązane moduły, więc funkcja jest zawsze o jedno kliknięcie od swojego przełącznika.

    • General: język, prefiks i rola zarządcy
    • Channels i Channel scopes: ogranicz, gdzie bot działa
    • Modules: włączaj i wyłączaj każdą funkcję
    • Moderation and security: AutoMod, Warnings, Appeals, Verification i Logging
    • Members: Welcome i Goodbye, Reaction roles i Birthday
    • Engagement: Leveling, Starboard, Suggestions, Reputation, Counting, Confessions i Giveaways
    • Economy and games: Economy i Games
    • Content: Tickets, Applications, Autoresponse, Sticky messages, Tags, Feeds (RSS, YouTube, Twitch, Reddit), Socials i Reminders
    • Tools: Temp channels, Crypto, Backup i Restore, Webhooks, Embed builder, Links i Help
    • Admin: Analytics, Audit log, API keys, Plugins (wgrywanie ZIP, tylko właściciel) i Premium
  4. Step 34

    Komendy slash oraz te same komendy z prefiksem !, pogrupowane według obszarów.

    • Moderacja: ban, tempban, softban, unban, kick, mute, unmute, timeout, voicemute, warn, notes, case, jail, shadowmute, clear, cleanup, lock, lockdown, slowmode, nick, role, timedrole, filter, altcheck i permcheck
    • Bezpieczeństwo: AutoMod, anti-nuke, blokada anti-raid, weryfikacja, odwołania, logi wiadomości i serwera, migawki ról oraz Persist, który przywraca role i pseudonim, gdy członek wraca
    • Członkowie: wiadomości powitalne i pożegnalne, role startowe, role z reakcji, menu ról, śledzenie zaproszeń, historia nazw i polecenia
    • Zaangażowanie: XP i poziomy z rolami za poziomy, rank i rankingi wiadomości i głosu, starboard, sugestie, reputacja, kanał liczenia, urodziny, wyznania, AFK, ankiety, serie, zadania i konkursy
    • Ekonomia: balance, daily, work, pay, bank, shop, market, lootbox, spin i heist
    • Gry: 8ball, coinflip, dice, rock-paper-scissors, tictactoe, connect4, trivia, matchmaking i statystyki gier
    • Narzędzia treści: tickety, podania, autoodpowiedzi, przypięte wiadomości, tagi, feedy i socials, przypomnienia, digest oraz komendy, które odpowiadają na pytania co mnie ominęło i dlaczego dostałem bana
    • Użytkowe: tymczasowe kanały głosowe, ceny krypto, status Minecrafta, info, help, linki, backup, zdarzenia webhook, klucze API z tylko do odczytu API statystyk v1 oraz Premium
    • Pluginy: wtyczki typu drop-in, takie jak sample_plugin, minecraft_status i fear_greed, każda z ustawieniami dla poszczególnych serwerów

Launcher zauważa, co się zmieniło, więc aktualizacja jest krótka.

  1. Step 35

    Pobierz nowe pliki, zachowując .env i katalog data, a potem zrestartuj. Launcher przeinstaluje zależności, gdy zmieni się package.json, i skompiluje ponownie, gdy zmieni się kod źródłowy.

    W Pterodactyl wgraj nowe pliki na stare, nie usuwając .env, data ani plugins, a potem zrestartuj serwer. Ustawienia przechodzą dalej dzięki migracjom schematu.

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

Rozwiązywanie problemów

The failures that actually happen, and what causes them.

Pytania o instalację

Podsumowanie

Instalacja VorqulBOT zajmuje około 10 do 15 minut. Utwórz aplikację w Discord Developer Portal, włącz intenty presence, server members i message content, a następnie skopiuj token i ID aplikacji. Potem albo zainstaluj Node.js 22 LTS na czystym serwerze Debian lub Ubuntu, skopiuj .env.example do .env, uruchom npm install i npm start i utrzymuj bota przy życiu przez systemd, albo zaimportuj dołączony egg do Pterodactyl, wgraj pliki i uzupełnij zmienne Startup. Dane domyślnie trafiają do plików JSON albo do MySQL/MariaDB, co wybierasz jedną linijką w .env.

  • Czas: Około 10 do 15 minut
  • Środowisko: Node.js 18+, zalecane 22 LTS
  • Ścieżki: Serwer Debian lub Ubuntu, Pterodactyl
  • Dane: Pliki JSON lub MySQL/MariaDB
Pojęcia na tej stronie

Egg Pterodactyl Hostowane samodzielnie Uprzywilejowane intenty Komenda slash Logowanie do panelu przez OAuth2 Rejestr modułów Most prefiksu

Powiązane

Reviewed