İçeriğe geç
VORQUL
Dokümantasyon / Kurulum

Kendi sunucunuzda çalışan Discord botu VorqulBOT'u kurun

İki kurulum yolu, tek yapılandırma. Discord tarafı her iki yolda da aynıdır ve en çok hata yapılan kısım burasıdır, bu yüzden en başta anlatılıyor.

VorqulBOT kurulumu yaklaşık 10 ila 15 dakika sürer. Discord Developer Portal'da bir uygulama oluşturun, presence, server members ve message content intent'lerini açın, token'ı ve uygulama kimliğini kopyalayın. Sonra iki yoldan birini seçin. Temiz bir Debian veya Ubuntu sunucusuna Node.js 22 LTS kurun, .env.example dosyasını .env olarak kopyalayın, npm install ve npm start komutlarını çalıştırın ve systemd ile sürekli açık tutun. Ya da hazır egg'i Pterodactyl'e aktarın, dosyaları yükleyin ve Startup değişkenlerini doldurun. Depolama varsayılan olarak JSON dosyalarıdır, isterseniz .env içindeki tek bir satırla MySQL/MariaDB seçebilirsiniz.

Süre
Yaklaşık 10 ila 15 dakika
Çalışma ortamı
Node.js 18+, 22 LTS önerilir
Yollar
Debian veya Ubuntu sunucu, Pterodactyl
Depolama
JSON dosyaları veya MySQL/MariaDB

Gereksinimler

Kurulumdan önce asgari gereksinimler
RAM En az 512 MB, 1 GB önerilir, panel (dashboard) çalıştırırsanız 2 GB
CPU En az 1 çekirdek, 2 önerilir
Disk En az 500 MB, 1 GB önerilir
Node.js En az 18, 22 LTS önerilir (18 ve 20 artık resmi destek süresini doldurdu)
npm Node.js ile birlikte gelir, ayrıca kurmanız gerekmez
Veritabanı İsteğe bağlı, JSON dosyaları için hiçbir şey kurmanız gerekmez
Requirements for VorqulBOT Kurulumu: RAM En az 512 MB, 1 GB önerilir, panel (dashboard) çalıştırırsanız 2 GB, CPU En az 1 çekirdek, 2 önerilir, Disk En az 500 MB, 1 GB önerilir, Node.js En az 18, 22 LTS önerilir (18 ve 20 artık resmi destek süresini doldurdu), npm Node.js ile birlikte gelir, ayrıca kurmanız gerekmez, Veritabanı İsteğe bağlı, JSON dosyaları için hiçbir şey kurmanız gerekmez.

Bu yarısı tüm kurulum yollarında aynıdır. Intent'leri atlamak, yeni kurulan bir botun hiçbir şey yapmamasının en yaygın nedenidir.

  1. Step 01

    Discord Developer Portal'da yeni bir uygulama oluşturun, ona bir bot ekleyin ve token'ı görmek için sıfırlayın.

    Token yalnızca bir kez gösterilir. Güvenli bir yere kopyalayın. Asla commit etmeyin, destek kanalına yapıştırmayın ve ekran görüntüsüne koymayın. Sızarsa sıfırlayın. Discord eskisini hemen geçersiz kılar.

    General Information bölümünden Application ID değerini de kopyalayın. Bot, slash komutlarını kaydetmek için bunu DISCORD_CLIENT_ID olarak kullanır. Paneli hiç açmasanız bile bu zorunludur.

  2. Step 02

    Bot sekmesinde, Privileged Gateway Intents altında Presence Intent, Server Members Intent ve Message Content Intent seçeneklerini açın.

    Message Content olmadan bot mesaj metnini göremez. Bu yüzden AutoMod, seviye sistemi, önek komutları ve yapışkan mesajlar sessizce çalışmaz. Server Members olmadan katılımlara tepki veremez. Bu da karşılama kartlarını, katılım rollerini, davet takibini ve anti-raid korumasını devre dışı bırakır.

    Bot bağlanıyor ama her şeyi görmezden geliyorsa önce bu adıma dönün.

  3. Step 03

    OAuth2 altında URL Generator bölümünde bot ve applications.commands kapsamlarını seçin, izinleri belirleyin, oluşan URL'yi açın ve sunucunuzda yetkilendirin.

    83 slash komutunun görünmesini applications.commands kapsamı sağlar. Bunu atlarsanız bot sunucuya katılır ama tek bir komutu olmaz.

  4. Step 04

    OAuth2 altında General bölümünde Client Secret değerini sıfırlayıp kopyalayın, ardından callback URL'nizi Redirects listesine ekleyin.

    Yalnızca web panelini istiyorsanız gerekir. Botun kendisi secret olmadan ve yönlendirme olmadan çalışır.

    Yönlendirme URL'leri
    http://localhost:3000/api/auth/callback/discord
    https://your-domain.tld/api/auth/callback/discord

İki gerçek altyapı var, .env içinde tek satır ve ayrı bir sürüm yok. Sunucunun büyüklüğüne göre seçin, isimlerin kulağa nasıl geldiğine aldırmayın.

  1. Step 05

    data/json altında her tablo için bir dosya bulunur. Bu varsayılandır, hizmet ya da kurulum gerektirmez ve kendi sunucusunda çalışan çoğu kurulum bunu kullanır.

    .env
    DATABASE_TYPE=json
    DATA_PATH=./data

    Bot DATA_PATH değerine kendisi /json ekler. Yani DATA_PATH=./data yazarsanız dosyalar ./data/json içine gider. Buraya ./data/json yazmayın, yoksa dosyalar bir seviye fazla derine iner.

  2. Step 06

    Sunucuyu kurun, utf8mb4 ile bir veritabanı ve kullanıcı oluşturun, sonra botu ona yönlendirin. Sunucu büyüdüğünde ya da verileri diğer hizmetlerle birlikte tutmak istediğinizde buna değer.

    Ardından .env içinde DATABASE_TYPE=mysql değerini DB_HOST, DB_PORT, DB_USER, DB_PASSWORD ve DB_NAME ile birlikte ayarlayın.

    DATABASE_TYPE=sqlite üçüncü bir seçenek değildir. Bu sürümde SQLite sürücüsü yok, bu yüzden bu değer bir uyarı kaydeder ve sessizce JSON dosyalarını kullanır. Verileriniz yine kaydedilir ama yapılandırma gerçekte olanı söylesin diye json yazın.

    Debian üzerinde MariaDB
    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 isteğe bağlı değildir. Daha azı, saklanan mesajlardaki emoji ve aksanlı harfleri bozar.

Kendi makineniz varsa izlenecek yol budur. Aşağıdaki her şey sudo yetkisi olan sıradan bir kullanıcıyla çalışır, botun kendisi ise kendi sudo yetkisi olmayan ayrı bir kullanıcıyla çalışır.

  1. Step 07

    Sistemi güncelleyin, temel paketleri kurun, Node 22 için NodeSource deposunu ekleyin ve kurun. npm onunla birlikte gelir.

    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 komutu v22.x yazdırmalıdır. v18 ve üzeri botu çalıştırır, ancak 18 ve 20 artık resmi güvenlik düzeltmesi almıyor.

  2. Step 08

    Ayrı bir kullanıcı, token'ı ve verileri makinedeki diğer her şeyden uzak tutar.

    İkinci komut o kullanıcı olarak bir kabuk açar. Sonraki adımlardaki her komut, systemd adımına kadar orada çalışır.

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

    Depoyu kendi dizinine klonlayın ya da bir sürüm arşivini oraya açın. package.json doğrudan çalışma dizininde durmalıdır.

    Sürüm arşivini mi tercih ediyorsunuz? Yükleyin, unzip çalıştırın ve içeriği yukarı taşıyın ki package.json bir seviye aşağıda kalmasın.

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

    Token'ı, uygulama kimliğini ve depolama türünü doldurmak için .env.example dosyasını .env olarak kopyalayın. Dosya gizli bilgiler içerir, bu yüzden kimlerin okuyabileceğini kısıtlayın.

    • DISCORD_TOKEN: zorunlu, Developer Portal'dan alınır
    • DISCORD_CLIENT_ID: zorunlu, Application ID değeridir, bu olmadan hiçbir slash komutu kaydedilmez
    • DATABASE_TYPE: json veya mysql (bkz. Bölüm 2)
    • BOT_OWNER_ID: Discord kullanıcı kimliğiniz, yalnızca sahibe özel komutların kilidini açar
    • DASHBOARD_ENABLED: paneli istemiyorsanız false bırakın (aşağıya bakın)
    bash
    cp .env.example .env
    chmod 600 .env
    nano .env
  5. Step 11

    npm install bağımlılıkları indirir. npm start token'ı kontrol eder, TypeScript'i derler ve botu ön planda çalıştırır, böylece ilk açılışı izleyebilirsiniz.

    Depo, legacy-peer-deps içeren bir .npmrc ile gelir. Bu dosya, geliştirme araçlarındaki peer dependency çakışmaları yüzünden npm'in kurulumu reddetmesini engeller. Silmeyin.

    İlk başlatma kodu derler ve bir iki dakika sürer. Sonraki başlatmalar, kaynak değişene kadar derlemeyi atlar. Botun çevrimiçi olduğunu ve slash komutlarının kaydedildiğini gördüğünüzde Ctrl+C ile durdurun.

    bash
    npm install
    npm start

    Bu ilk çalıştırmayı izleyin. Token, uygulama kimliği veya intent'lerle ilgili hatalar yalnızca burada görünür. --omit=dev veya NODE_ENV=production ile kurmayın: derleyici bir geliştirme bağımlılığıdır ve derleme başarısız olur.

  6. Step 12

    Bir servis, süreç ölünce onu yeniden başlatır ve yeniden başlatmadan sonra geri getirir. İnsanların atlayıp sonra botun neden gece boyunca çevrimdışı kaldığını merak ettiği adım budur.

    Unit dosyasına Environment=NODE_ENV=production eklemeyin. Başlatıcı npm install komutunu kendisi çalıştırır ve derlemek için ihtiyaç duyduğu geliştirme bağımlılıklarını atlar. Panel için üretim modunu kendisi ayarlar.

    Başlatıcı ayrıca, journal'ın yanında, bot dizinindeki logs/current.log dosyasına kendi döndürülen günlüğünü yazar.

    PM2'yi mi tercih ediyorsunuz? sudo npm install -g pm2, ardından pm2 start start.js --name vorqul, pm2 startup ve pm2 save aynı işi yapar.

    bash (vorqul değil, normal kullanıcınız olarak)
    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, kurulacak ikinci bir şey değildir. .env içinde açın, aynı başlatıcı onu derler ve 3000 numaralı portta ikinci bir süreç olarak başlatır.

    Servisi yeniden başlatın ve ilk açılışa birkaç dakika fazladan süre tanıyın, çünkü panel o sırada derlenir. Bu derleme yaklaşık 2 GB RAM ister.

    3000 numaralı portu doğrudan dışarı açmayın. Önüne sertifikalı bir nginx koyun. NEXTAUTH_URL değerini boş bırakırsanız adres otomatik algılanır. NEXTAUTH_SECRET boşsa başlatıcı bir tane üretir ve data/secrets içinde saklar, böylece yeniden başlatmalarda korunur.

    ALLOWED_EMAILS değerini Discord hesabınızın e-postasına ayarlayın, aksi halde Discord ile giriş yapabilen herkes panele erişebilir.

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

Zaten bir oyun sunucusu paneli kullanıyorsanız izlenecek yol budur. Hiçbir aşamada kabuk gerekmez.

  1. Step 14

    Yönetici alanında Nests bölümünü açın, Import Egg'i seçin ve projedeki egg-vorqul-d-s-bot.json dosyasını yükleyin.

    Egg, başlatma komutunu npm start olarak ayarlar ve Startup değişkenlerini sizin için oluşturur. Zorunlu olan ikisi de bunların arasındadır: DISCORD_TOKEN ve DISCORD_CLIENT_ID. Node.js 20 ve Node.js 18 imajlarını sunar. İkisi de çalışır ama ikisinin de resmi destek süresi doldu. Panelinizde ghcr.io/pterodactyl/yolks:nodejs_22 varsa, egg'in Docker Images bölümüne ekleyin ve sunucu için seçin.

  2. Step 15

    Bu egg üzerinde 1 GB RAM (paneli çalıştıracaksanız 2 GB), 1 GB disk ve özel bir CPU sınırı olmadan yeni bir sunucu oluşturun.

    Ağ ayırması (allocation) yalnızca panel için önemlidir. Botun kendisi Discord'a dışarıdan bağlanır ve hiçbir yerde dinlemez.

  3. Step 16

    Sürüm arşivini File Manager ile ya da SFTP üzerinden yükleyin, açın ve içeriği package.json konteynerin kök dizininde olacak şekilde taşıyın.

    Beklenen yapı
    /home/container/
      bot.py
      start.js
      package.json
      package-lock.json
      .npmrc
      tsconfig.bot.json
      src/
      plugins/

    package.json bir alt klasörün içinde kaldıysa başlatıcı kaynağı bulamaz. Her şeyi bir seviye yukarı taşıyın.

  4. Step 17

    Token ve depolama türü, .env dosyası yerine ortam değişkeni olarak girilir.

    • DISCORD_TOKEN: bot token'ınız
    • DISCORD_CLIENT_ID: Application ID, zorunlu
    • DATABASE_TYPE: json (varsayılan) veya mysql
    • BOT_OWNER_ID: Discord kullanıcı kimliğiniz, önerilir
    • DASHBOARD_ENABLED, DASHBOARD_PORT, DISCORD_CLIENT_SECRET, NEXTAUTH_URL ve NEXTAUTH_SECRET yalnızca panel için gerekir

    Pterodactyl veritabanı sunucusunu kullanırken: DB_HOST değerini panelin Databases sekmesinde gösterdiği sunucuya ayarlayın ve panelin oluşturduğu ön ekli kullanıcı ve veritabanı adlarını kullanın. Panel için DASHBOARD_PORT değerini boş bırakıp ayrılan portu kullanın ve NEXTAUTH_URL değerini http veya https olarak gerçekte erişildiği şekilde yazın.

  5. Step 18

    Node.js egg'inde npm start. Alternatif başlatıcı olarak python3 bot.py de var, ancak yalnızca Node.js ve npm de kurulu olan bir konteynerde çalışır. Düz bir Python imajında bu yoktur.

    Python başlatıcısı yalnızca botu başlatır, paneli başlatmaz. Bir nedeniniz yoksa Node.js egg'ini kullanın.

    Başlatma komutu
    npm start
  6. Step 19

    Bunlar botun içinde değil, Pterodactyl'i barındıran makinede SSH üzerinden çalışır. Panel garip davranıyorsa önce pteroq ve nginx'i yeniden başlatın. Sunucular başlamıyorsa wings'i yeniden başlatın.

    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

    İlk açılış bağımlılıkları kurar ve kodu kendisi derler, bu bir ila üç dakika sürer. Bundan sonra bot çevrimiçi olur.

    Hemen kapanırsa konsol çıktısını okuyun. Eksik token veya uygulama kimliği burada net bir mesajla hata verir. Derleme daha yavaş olan tsx çalışma ortamına geçtiyse bunu da konsol gösterir.

Bot çevrimiçi. Üç ayar, botun işe yarar mı yoksa can sıkıcı mı olacağını belirler.

  1. Step 21

    44 modülün dokuzu hazır halde açıktır: moderasyon, seviye sistemi, afk, anketler, ekonomi, oyunlar, çekilişler, hatırlatıcılar ve önek komutları. Geri kalan her şey bilerek kapalı başlar.

    AutoMod'u yapılandırmadan canlı bir sunucuda açmak, insanları dün sorun olmayan davranışlar için cezalandırmanın yoludur. Filtreleri tek tek açın.

  2. Step 22

    Her şeyden önce bunu yapın. Log kanalı olmadan moderasyon işlemleri görünür bir kayıt bırakmadan gerçekleşir ve ilk anlaşmazlığa cevap verilemez.

    Her otomatik ve manuel işlem yine de numaralı bir vaka yazar, ancak log kanalı onu olurken görünür kılar.

  3. Step 23

    /info ping ve /help komutlarını çalıştırın. Bot yanıt veriyor ve komutlar listeleniyorsa token, intent'ler ve komut kaydı çalışıyor demektir.

    Eksik slash komutları, davette applications.commands kapsamının atlandığı ya da DISCORD_CLIENT_ID değerinin boş veya yanlış olduğu anlamına gelir. Discord yeni kaydedilen komutları göstermek için birkaç dakika alabilir.

Buradaki beş dakika, yabancıların botunuzu kullanıp kullanamayacağını belirler.

  1. Step 24

    Developer Portal'da uygulamanızı açın, Bot sekmesine gidin ve PUBLIC BOT seçeneğini kapatın.

    Açıkken, client kimliğinizi bilen herkes botu kendi sunucusuna ekleyebilir. Buna karşı tek gerçek koruma bu anahtardır.

  2. Step 25

    Ayrıca .env içinde ALLOWED_EMAILS veya ALLOWED_IDS ayarlayın. Yalnızca bu hesaplar ve botun zaten bulunduğu bir sunucuyu yöneten kişiler giriş yapabilir. Diğer herkes Add bot düğmesini görmez.

    DASHBOARD_PASSWORD, girişin önüne bir kapı daha ekler. NEXTAUTH_SECRET değerini openssl rand -hex 32 ile bir kez üretin ve saklayın, çünkü değiştirirseniz herkesin oturumu kapanır.

    BOT_OWNER_ID değerini kendi Discord kimliğinize ayarlayın. Sahip komutları ve eklenti yönetimi yalnızca bu kimliğe aittir, birden fazla kimlik virgülle ayrılır.

  3. Step 26

    Kimseye göndermeyin ve .env dosyasını asla GitHub'a yüklemeyin (.gitignore içindedir). Sızarsa Developer Portal'da Reset Token'a basın ve yenisini yapıştırın.

Her değişken, ne yaptığı ve ihtiyacınız olup olmadığı.

  1. Step 27

    İlk ikisi zorunludur. Diğer her şeyin makul bir varsayılanı vardır.

    • DISCORD_TOKEN (zorunlu): bot token'ı, Developer Portal, Bot, Reset Token
    • DISCORD_CLIENT_ID (zorunlu): Application ID, OAuth2, General
    • DISCORD_CLIENT_SECRET (yalnızca panel): OAuth2, Reset Secret
    • BOT_OWNER_ID (önerilir): Discord kimliğiniz
    • DATABASE_TYPE (zorunlu): hiçbir şey kurmayı gerektirmeyen json veya mysql
    • DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME (yalnızca mysql): MySQL bağlantı bilgileri
    • DATA_PATH: veri klasörü, ./data olarak bırakın
    • DASHBOARD_ENABLED: true paneli açar
    • DASHBOARD_PORT: panel portu, Pterodactyl'de boş bırakın
    • NEXTAUTH_URL: boş bırakın, adres otomatik algılanır
    • NEXTAUTH_SECRET (panel): girişi imzalayan rastgele dize
    • DASHBOARD_PASSWORD: panelin önündeki ek parola
    • ALLOWED_EMAILS, ALLOWED_IDS (önerilir): kimlerin giriş yapabileceği, virgülle ayrılır
    • BOT_PREFIX: metin komutları için önek, varsayılan olarak !
    • BOT_LANGUAGE: en, sk, cs, de, pl, ru, es, ja veya tr
    • TWITCH_CLIENT_ID, TWITCH_CLIENT_SECRET: Twitch bildirimleri için
    • DISABLED_COMMANDS: / menüsünden gizlenecek komutlar, çünkü Discord 100'e izin verir
    • LOG_TO_FILE: true günlükleri data/logs içine yazar

    DATABASE_TYPE yalnızca ekonomi, uyarılar ve ticket'lar gibi verileri kapsar. Sunucu ayarları (modüller, AutoMod, karşılama) her zaman data/json/guild_settings.json içinde durur. json'dan mysql'e geçmek eski verileri kendiliğinden taşımaz.

Altı adım var ve çoğu insan üçüncüde takılıyor.

  1. Step 28

    DASHBOARD_ENABLED=true, DISCORD_CLIENT_ID, DISCORD_CLIENT_SECRET ve NEXTAUTH_SECRET.

  2. Step 29

    Developer Portal'da OAuth2, General, Redirects bölümüne giriş yaptığınız her adresi ekleyin, alan adı ve IP:port fark etmeksizin.

    Yönlendirme URL'leri
    http://YOUR-IP:PORT/api/auth/callback/discord
    https://your-domain.tld/api/auth/callback/discord
  3. Step 30

    Botu yeniden başlatın, http://YOUR-IP:PORT adresini açın (port DASHBOARD_PORT değeridir, Pterodactyl'de ise sunucuya ayrılan porttur), Sign in with Discord'a basın, erişimi onaylayın ve sunucunuzu seçin.

    Bir kimlik doğrulama işleme hatası görürseniz DISCORD_CLIENT_ID ve DISCORD_CLIENT_SECRET değerlerini kontrol edin ya da site için çerezleri temizleyin.

Neye bakacağınızı bilmeniz için kısa bir tur.

  1. Step 31

    Aşağıdakilerin hepsi tek bir girişle, sunucu bazında çalışır.

    • Sunucu genel bakışı, Server Health Score ve mesajlar, katılımlar ve ayrılmalar için analizler
    • Açıp kapatabileceğiniz 44 modül: moderasyon, AutoMod, anti-nuke, anti-raid, seviyeler, ekonomi, ticket'lar, karşılama, tepki rolleri, çekilişler ve daha fazlası
    • Sekmeler halinde ayarlar ve modülleri seçilen kanallarla sınırlama
    • Embed oluşturucu ve kayıtlı mesajlardan oluşan bir kütüphane
    • Üç modda yedekleme ve geri yükleme: tam, yalnızca sunucu, yalnızca bot ayarları
    • Eklentiler: ZIP'ten kurun, etkinleştirin, devre dışı bırakın ve yapılandırın
    • Role Manager: seçilen bir rol panelde sunucuyu yönetebilir ama eklentileri yönetemez
    • Daha yeni bir sürüm çıktığında bildirim veren bot sürümü
    • 9 dil ve her sekmede yenileme ve önbelleği temizleme düğmeleri
  2. Step 32

    Karşılaştığınız sırayla beş ekran.

    • Gate: DASHBOARD_PASSWORD ile açılan isteğe bağlı bir parola ekranı
    • Login: Discord ile giriş yapın
    • Server picker: yönettiğiniz ve botun bulunduğu sunucuları listeler
    • Server home: çevrimiçi durumu, ping, çalışma süresi, bellek ve CPU ile bot durumu, sunucu istatistikleri ve güncelleme çıktığında bir bildirim
    • Settings: sekmeli tek bir sayfa, bir sonraki adımda listelenir
  3. Step 33

    Her sekme ilgili modülleri gruplar, böylece bir özellik, düğmesinden hiçbir zaman bir tıklamadan uzakta olmaz.

    • General: dil, önek ve yönetici rolü
    • Channels ve Channel scopes: botun nerede çalışacağını kısıtlayın
    • Modules: her özelliği açın veya kapatın
    • Moderation ve security: AutoMod, Warnings, Appeals, Verification ve Logging
    • Members: Welcome ve Goodbye, Reaction roles ve Birthday
    • Engagement: Leveling, Starboard, Suggestions, Reputation, Counting, Confessions ve Giveaways
    • Economy ve games: Economy ve Games
    • Content: Tickets, Applications, Autoresponse, Sticky messages, Tags, Feeds (RSS, YouTube, Twitch, Reddit), Socials ve Reminders
    • Tools: Temp channels, Crypto, Backup ve Restore, Webhooks, Embed builder, Links ve Help
    • Admin: Analytics, Audit log, API keys, Plugins (ZIP yükleme, yalnızca sahip) ve Premium
  4. Step 34

    Slash komutları ve aynı komutların ! önekiyle olanları, alanlara göre gruplanmış.

    • Moderasyon: ban, tempban, softban, unban, kick, mute, unmute, timeout, voicemute, warn, notes, case, jail, shadowmute, clear, cleanup, lock, lockdown, slowmode, nick, role, timedrole, filter, altcheck ve permcheck
    • Güvenlik: AutoMod, anti-nuke, anti-raid lockdown, doğrulama, itirazlar, mesaj ve sunucu günlükleri, rol anlık görüntüleri ve bir üye yeniden katıldığında rollerini ve takma adını geri yükleyen Persist
    • Üyeler: karşılama ve veda mesajları, katılım rolleri, tepki rolleri, rol menüleri, davet takibi, ad geçmişi ve referanslar
    • Etkileşim: seviye rolleriyle XP ve seviyeler, mesajlar ve ses için rank ve lider tabloları, starboard, öneriler, itibar, sayma kanalı, doğum günleri, itiraflar, AFK, anketler, seriler, görevler ve çekilişler
    • Ekonomi: balance, daily, work, pay, bank, shop, market, lootbox, spin ve heist
    • Oyunlar: 8ball, coinflip, dice, rock-paper-scissors, tictactoe, connect4, trivia, matchmaking ve oyun istatistikleri
    • İçerik araçları: ticket'lar, başvurular, otomatik yanıtlar, yapışkan mesajlar, etiketler, akışlar ve sosyal hesaplar, hatırlatıcılar, bir özet ve ben neleri kaçırdım ve neden banlandım sorularını yanıtlayan komutlar
    • Yardımcı araçlar: geçici ses kanalları, kripto fiyatları, Minecraft durumu, info, help, bağlantılar, yedekleme, webhook olayları, salt okunur v1 istatistik API'sine sahip API anahtarları ve Premium
    • Eklentiler: sample_plugin, minecraft_status ve fear_greed gibi takılıp çalışan eklentiler, her birinin sunucu başına ayarları vardır

Başlatıcı neyin değiştiğini fark eder, bu yüzden güncelleme kısadır.

  1. Step 35

    Yeni dosyaları alın ama .env dosyasını ve data dizinini koruyun, sonra yeniden başlatın. Başlatıcı package.json değiştiğinde bağımlılıkları yeniden kurar, kaynak değiştiğinde yeniden derler.

    Pterodactyl'de yeni dosyaları eskilerin üzerine yükleyin, .env, data ve plugins klasörlerini silmeyin, sonra sunucuyu yeniden başlatın. Ayarlar şema geçişleriyle korunur.

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

Sorun giderme

The failures that actually happen, and what causes them.

Kurulum hakkında sorular

Özet

VorqulBOT kurulumu yaklaşık 10 ila 15 dakika sürer. Discord Developer Portal'da bir uygulama oluşturun, presence, server members ve message content intent'lerini açın, token'ı ve uygulama kimliğini kopyalayın. Sonra iki yoldan birini seçin. Temiz bir Debian veya Ubuntu sunucusuna Node.js 22 LTS kurun, .env.example dosyasını .env olarak kopyalayın, npm install ve npm start komutlarını çalıştırın ve systemd ile sürekli açık tutun. Ya da hazır egg'i Pterodactyl'e aktarın, dosyaları yükleyin ve Startup değişkenlerini doldurun. Depolama varsayılan olarak JSON dosyalarıdır, isterseniz .env içindeki tek bir satırla MySQL/MariaDB seçebilirsiniz.

  • Süre: Yaklaşık 10 ila 15 dakika
  • Çalışma ortamı: Node.js 18+, 22 LTS önerilir
  • Yollar: Debian veya Ubuntu sunucu, Pterodactyl
  • Depolama: JSON dosyaları veya MySQL/MariaDB
Bu sayfadaki terimler

Pterodactyl egg Kendi sunucunuzda çalışır Ayrıcalıklı intent'ler Slash komutu OAuth2 ile panel girişi Modül kaydı Önek köprüsü

İlgili

Reviewed