コンテンツへスキップ
VORQUL
ドキュメント / インストール

セルフホスト型Discordボット、VorqulBOTのインストール

デプロイ方法は2通りですが、設定は共通です。Discord側の手順はどちらも同じで、間違えやすい部分なので最初に説明します。

VorqulBOTのインストールにかかる時間は10〜15分ほどです。Discord Developer Portalでアプリケーションを作成し、presence、server members、message contentの各インテントを有効にして、トークンとアプリケーションIDをコピーします。その後、クリーンなDebianまたはUbuntuサーバーにNode.js 22 LTSをインストールし、.env.exampleを.envにコピーして、npm installとnpm startを実行し、systemdで常時稼働させます。または、付属のeggをPterodactylにインポートし、ファイルをアップロードして、Startup変数を入力します。保存先は標準ではJSONファイルで、.envの1行でMySQL/MariaDBに切り替えられます。

所要時間
約10〜15分
ランタイム
Node.js 18以上、22 LTS推奨
デプロイ方法
DebianまたはUbuntuサーバー、Pterodactyl
ストレージ
JSONファイルまたはMySQL/MariaDB

必要条件

インストール前の最小要件
RAM 最小512 MB、推奨1 GB、ダッシュボードを使う場合は2 GB
CPU 最小1コア、推奨2コア
ディスク 最小500 MB、推奨1 GB
Node.js 最小18、推奨22 LTS(18と20は上流のサポートが終了しています)
npm Node.jsに付属しているため、別途インストールは不要です
データベース 任意です。JSONファイルなら何もインストールしなくて済みます
Requirements for VorqulBOTのインストール: RAM 最小512 MB、推奨1 GB、ダッシュボードを使う場合は2 GB, CPU 最小1コア、推奨2コア, ディスク 最小500 MB、推奨1 GB, Node.js 最小18、推奨22 LTS(18と20は上流のサポートが終了しています), npm Node.jsに付属しているため、別途インストールは不要です, データベース 任意です。JSONファイルなら何もインストールしなくて済みます.

この手順はどのデプロイ方法でも共通です。インテントの設定を飛ばすと、インストールしたばかりのボットが何も反応しない原因になりやすいので注意してください。

  1. Step 01

    Discord Developer Portalで新しいアプリケーションを作成し、ボットを追加してから、トークンをリセットして表示します。

    トークンは一度しか表示されません。安全な場所にコピーして保管し、コミットしたり、サポートチャンネルに貼ったり、スクリーンショットに写したりしないでください。漏れた場合はリセットしてください。Discordは古いトークンをすぐに無効にします。

    General InformationにあるApplication IDもコピーしてください。ボットがスラッシュコマンドを登録するためにDISCORD_CLIENT_IDとして必要になります。ダッシュボードを使わない場合でも省略できません。

  2. Step 02

    Botの Privileged Gateway Intents で、Presence Intent、Server Members Intent、Message Content Intentをオンにします。

    Message Contentがないと、ボットはメッセージの本文を読めません。そのため、AutoMod、レベリング、プレフィックスコマンド、固定メッセージはすべて何も起きなくなります。Server Membersがないと、参加に反応できなくなるため、ウェルカムカード、参加ロール、招待トラッキング、アンチレイドが使えません。

    ボットは接続されているのに何にも反応しない場合は、まずこの手順に戻ってください。

  3. Step 03

    OAuth2の URL Generator で、botとapplications.commandsのスコープを選び、権限を選択してから、生成されたURLを開いて自分のサーバーで承認します。

    applications.commandsスコープがあるおかげで、83個のスラッシュコマンドが表示されます。これを外すと、ボットはサーバーに参加してもコマンドが1つも使えません。

  4. Step 04

    OAuth2の General でClient Secretをリセットしてコピーし、RedirectsにコールバックURLを追加します。

    Webダッシュボードを使う場合のみ必要です。ボット本体はシークレットもリダイレクトもなしで動作します。

    リダイレクトURL
    http://localhost:3000/api/auth/callback/discord
    https://your-domain.tld/api/auth/callback/discord

実際に使えるバックエンドは2つで、.envの1行で切り替えます。別のエディションはありません。名前の印象ではなく、サーバーの規模で選んでください。

  1. Step 05

    テーブルごとに1ファイルずつ、data/jsonの下に保存されます。これが標準設定で、サービスも設定も要らないため、セルフホストの多くがこの方式で動いています。

    .env
    DATABASE_TYPE=json
    DATA_PATH=./data

    ボットはDATA_PATHの後ろに自動で/jsonを付け足します。そのため、DATA_PATH=./dataならファイルは./data/jsonに保存されます。ここに./data/jsonと書くと、ファイルが1階層深い場所に作られてしまいます。

  2. Step 06

    サーバーをインストールし、utf8mb4でデータベースとユーザーを作成してから、ボットを接続します。サーバーが大きい場合や、他のサービスと同じ場所にデータを置きたい場合に向いています。

    次に、.envでDATABASE_TYPE=mysqlを設定し、DB_HOST、DB_PORT、DB_USER、DB_PASSWORD、DB_NAMEも設定します。

    DATABASE_TYPE=sqliteは3つ目の選択肢ではありません。このバージョンにはSQLiteドライバーがないため、この値を指定すると警告が出て、静かにJSONファイルが使われます。データは保存されますが、設定が実際の動作と一致するようにjsonと書いてください。

    Debianでの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は必須です。それ以外だと、保存されたメッセージの絵文字や発音記号付きの文字が文字化けします。

自分のマシンがある場合はこの方法です。以下はすべて、sudoを使える通常のユーザーで実行します。ボット自体はsudo権限のない専用ユーザーで動かします。

  1. Step 07

    システムを更新して基本のパッケージを入れ、Node 22用のNodeSourceリポジトリを追加してインストールします。npmも一緒に入ります。

    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でv22.xと表示されるはずです。v18以上であればボットは動きますが、18と20は上流のセキュリティ修正を受けられなくなっています。

  2. Step 08

    専用のユーザーを使うと、トークンやデータをマシン上の他のものから隔離できます。

    2番目のコマンドは、そのユーザーとしてシェルを開きます。systemdの手順までは、以降のコマンドはすべてそのシェルで実行します。

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

    専用のディレクトリにリポジトリをクローンするか、リリースアーカイブを展開します。package.jsonは作業ディレクトリの直下に置く必要があります。

    リリースアーカイブを使う場合は、アップロードしてunzipを実行し、package.jsonが1階層下にならないように中身を上へ移動してください。

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

    .env.exampleを.envにコピーし、トークン、アプリケーションID、ストレージの種類を入力します。このファイルには機密情報が含まれるため、読み取り権限を制限してください。

    • DISCORD_TOKEN:必須。Developer Portalから取得します
    • DISCORD_CLIENT_ID:必須。Application IDのことで、これがないとスラッシュコマンドは登録されません
    • DATABASE_TYPE:jsonまたはmysql(パート2を参照)
    • BOT_OWNER_ID:自分のDiscordユーザーID。オーナー専用コマンドが使えるようになります
    • DASHBOARD_ENABLED:ダッシュボードが不要ならfalseのままにします(詳しくは後述)
    bash
    cp .env.example .env
    chmod 600 .env
    nano .env
  5. Step 11

    npm installで依存パッケージを取得し、npm startでトークンを確認してTypeScriptをコンパイルし、ボットをフォアグラウンドで実行します。初回の起動を見ながら確認できます。

    リポジトリにはlegacy-peer-depsを指定した.npmrcが入っています。これは、開発ツールのピア依存関係の競合でnpmがインストールを拒否するのを防ぎます。削除しないでください。

    初回の起動ではコードをコンパイルするため、1〜2分かかります。2回目以降は、ソースが変わるまでコンパイルを省略します。オンラインになってスラッシュコマンドが登録されたのを確認したら、Ctrl+Cで止めてください。

    bash
    npm install
    npm start

    この初回の実行は必ず見ておいてください。トークン、アプリケーションID、インテントに関するエラーは、ここにしか表示されません。--omit=devやNODE_ENV=productionを付けてインストールしないでください。コンパイラは開発用の依存パッケージなので、ビルドに失敗します。

  6. Step 12

    サービスにしておくと、プロセスが落ちたときに再起動され、サーバーの再起動後にも自動で立ち上がります。この手順を飛ばして、一晩でボットがオフラインになって困る人が多いです。

    ユニットにEnvironment=NODE_ENV=productionを追加しないでください。ランチャー自身がnpm installを実行するため、コンパイルに必要な開発用の依存パッケージが省かれてしまいます。ダッシュボードのproductionモードは、ランチャーが自分で設定します。

    ランチャーは、ジャーナルとは別に、ボットのディレクトリ内のlogs/current.logにもローテーション付きのログを書き出します。

    PM2を使いたい場合は、sudo npm install -g pm2を実行し、pm2 start start.js --name vorqul、pm2 startup、pm2 saveを順に実行すれば同じ結果になります。

    bash(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

    ダッシュボードは別にインストールするものではありません。.envで有効にすると、同じランチャーがビルドして、ポート3000で2つ目のプロセスとして起動します。

    サービスを再起動し、初回の起動ではダッシュボードをビルドするため、数分余分に待ってください。このビルドには約2 GBのRAMが必要です。

    ポート3000を直接公開しないでください。証明書を設定したnginxを前段に置きます。NEXTAUTH_URLを空にしておくと、アドレスは自動で検出されます。NEXTAUTH_SECRETが空の場合は、ランチャーが生成してdata/secretsに保存するため、再起動しても保持されます。

    ALLOWED_EMAILSには自分のDiscordアカウントのメールアドレスを設定してください。設定しないと、Discordでサインインできる人なら誰でもダッシュボードに入れてしまいます。

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

すでにゲームホスティングパネルを使っている場合はこの方法です。どの手順でもシェルは必要ありません。

  1. Step 14

    管理画面でNestsを開き、Import Eggを選んで、プロジェクトのegg-vorqul-d-s-bot.jsonをアップロードします。

    eggは起動コマンドをnpm startに設定し、Startup変数も作成してくれます。必須の2つ、DISCORD_TOKENとDISCORD_CLIENT_IDも含まれます。Node.js 20とNode.js 18のイメージが用意されていますが、どちらも上流のサポートが終了しています。パネルでghcr.io/pterodactyl/yolks:nodejs_22が使える場合は、eggのDocker Imagesに追加して、サーバーでそれを選んでください。

  2. Step 15

    そのeggで新しいサーバーを作成します。RAMは1 GB(ダッシュボードを使う場合は2 GB)、ディスクは1 GBにして、CPU制限は特に設定しません。

    ネットワークの割り当ては、ダッシュボードを使う場合にだけ関係します。ボット自体はDiscordへ外向きに接続するだけで、待ち受けるポートはありません。

  3. Step 16

    File ManagerまたはSFTPでリリースアーカイブをアップロードして展開し、package.jsonがコンテナのルートに来るように中身を移動します。

    期待されるレイアウト
    /home/container/
      bot.py
      start.js
      package.json
      package-lock.json
      .npmrc
      tsconfig.bot.json
      src/
      plugins/

    package.jsonがサブフォルダの中にあると、ランチャーはソースを見つけられません。すべてを1階層上に移動してください。

  4. Step 17

    トークンとストレージの種類は、.envファイルではなく、環境変数として設定します。

    • DISCORD_TOKEN:ボットのトークン
    • DISCORD_CLIENT_ID:Application ID(必須)
    • DATABASE_TYPE:json(標準)またはmysql
    • BOT_OWNER_ID:自分のDiscordユーザーID(推奨)
    • DASHBOARD_ENABLED、DASHBOARD_PORT、DISCORD_CLIENT_SECRET、NEXTAUTH_URL、NEXTAUTH_SECRETは、ダッシュボードを使う場合にのみ必要です

    Pterodactylのデータベースホストを使う場合:DB_HOSTにはパネルのDatabasesタブに表示されるホストを設定し、生成されたプレフィックス付きのユーザー名とデータベース名を使ってください。ダッシュボードでは、DASHBOARD_PORTを空にすると割り当て済みのポートが使われます。NEXTAUTH_URLは、実際にアクセスできる形のとおりにhttpまたはhttpsを指定してください。

  5. Step 18

    Node.js eggではnpm startです。代わりにpython3 bot.pyというランチャーもありますが、Node.jsとnpmも入っているコンテナでしか動きません。通常のPythonイメージでは動きません。

    Pythonランチャーはボットだけを起動し、ダッシュボードは起動しません。特別な理由がなければ、Node.js eggを使ってください。

    起動コマンド
    npm start
  6. Step 19

    これらは、ボットの中ではなく、Pterodactylを動かしているマシンにSSHで接続して実行します。パネルの動作がおかしいときは、まずpteroqとnginxを再起動してください。サーバーが起動しないときは、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

    初回の起動では、依存パッケージのインストールとコードのコンパイルが自動で行われ、1〜3分かかります。その後、ボットがオンラインになります。

    すぐに終了した場合は、コンソールの出力を確認してください。トークンやアプリケーションIDが足りない場合は、ここで分かりやすいメッセージとともに失敗します。コンパイルが遅いtsxランタイムに切り替わったかどうかも、コンソールで確認できます。

ボットはオンラインになりました。役に立つか、邪魔になるかは、3つの設定で決まります。

  1. Step 21

    44個のモジュールのうち、最初からオンになっているのは9個です。モデレーション、レベリング、AFK、投票、経済、ゲーム、プレゼント企画、リマインダー、プレフィックスコマンドです。それ以外は、意図的にオフで始まります。

    設定する前に運用中のサーバーでAutoModを有効にすると、昨日まで問題なかった行動を罰してしまうことになります。フィルターは1つずつオンにしてください。

  2. Step 22

    他のどの設定よりも先に行ってください。ログチャンネルがないと、モデレーションの操作に目に見える記録が残らず、最初のトラブルに答えられなくなります。

    自動でも手動でも、すべての操作は連番のケースとして記録されますが、ログチャンネルがあることで、その場で見えるようになります。

  3. Step 23

    /info pingと/helpを実行してください。ボットが応答してコマンドの一覧が表示されれば、トークン、インテント、コマンド登録はすべて正常に動いています。

    スラッシュコマンドが表示されない場合は、招待時にapplications.commandsスコープを外したか、DISCORD_CLIENT_IDが空または間違っています。Discordが新しく登録したコマンドを表示するまでに、数分かかることがあります。

ここでの5分間が、第三者にボットを使われるかどうかを分けます。

  1. Step 24

    Developer Portalで自分のアプリケーションを開き、BotでPUBLIC BOTをオフにします。

    オンのままだと、クライアントIDを知っている人なら誰でも、ボットを自分のサーバーに追加できます。これを防ぐ本当の方法は、このスイッチだけです。

  2. Step 25

    .envでALLOWED_EMAILSまたはALLOWED_IDSを設定します。サインインできるのは、そのアカウントと、ボットがすでに参加しているサーバーを管理している人だけです。それ以外の人には、Add botボタンは表示されません。

    DASHBOARD_PASSWORDを設定すると、サインインの前にもう1段階の認証を追加できます。NEXTAUTH_SECRETはopenssl rand -hex 32で一度だけ生成して保管してください。変更すると全員がサインアウトされます。

    BOT_OWNER_IDには自分のDiscord IDを設定してください。オーナーコマンドとプラグイン管理は、そのIDだけに許可されます。複数のIDはカンマで区切ります。

  3. Step 26

    誰にも送らず、.envをGitHubにアップロードしないでください(.gitignoreに含まれています)。漏れた場合は、Developer PortalでReset Tokenを押し、新しいトークンを貼り付けてください。

すべての変数について、役割と必要かどうかを説明します。

  1. Step 27

    最初の2つは必須です。それ以外には、適切な初期値があります。

    • DISCORD_TOKEN(必須):ボットのトークン。Developer Portal、Bot、Reset Tokenの順に操作します
    • DISCORD_CLIENT_ID(必須):Application ID。OAuth2、Generalにあります
    • DISCORD_CLIENT_SECRET(ダッシュボードのみ):OAuth2、Reset Secretで取得します
    • BOT_OWNER_ID(推奨):自分のDiscord ID
    • DATABASE_TYPE(必須):何もインストール不要のjson、またはmysql
    • DB_HOST、DB_PORT、DB_USER、DB_PASSWORD、DB_NAME(mysqlのみ):MySQLの接続情報
    • DATA_PATH:データフォルダ。./dataのままにします
    • DASHBOARD_ENABLED:trueにするとダッシュボードが有効になります
    • DASHBOARD_PORT:ダッシュボードのポート。Pterodactylでは空のままにします
    • NEXTAUTH_URL:空のままにします。アドレスは自動で検出されます
    • NEXTAUTH_SECRET(ダッシュボード):ログインの署名に使うランダムな文字列
    • DASHBOARD_PASSWORD:ダッシュボードの前に置く追加のパスワード
    • ALLOWED_EMAILS、ALLOWED_IDS(推奨):サインインを許可する人。カンマ区切りで指定します
    • BOT_PREFIX:テキストコマンドのプレフィックス。標準は!です
    • BOT_LANGUAGE:en、sk、cs、de、pl、ru、es、ja、tr のいずれか
    • TWITCH_CLIENT_ID、TWITCH_CLIENT_SECRET:Twitch通知用
    • DISABLED_COMMANDS:/メニューから隠すコマンド。Discordでは100個までしか使えないためです
    • LOG_TO_FILE:trueにするとログがdata/logsに書き込まれます

    DATABASE_TYPEが対象にするのは、経済、警告、チケットなどのデータだけです。サーバー設定(モジュール、AutoMod、ウェルカム)は、常にdata/json/guild_settings.jsonに保存されます。jsonからmysqlに切り替えても、古いデータは自動では移動しません。

6つの手順があり、3つ目でつまずく人が多いです。

  1. Step 28

    DASHBOARD_ENABLED=true、DISCORD_CLIENT_ID、DISCORD_CLIENT_SECRET、NEXTAUTH_SECRETを設定します。

  2. Step 29

    Developer PortalのOAuth2、General、Redirectsに、サインインに使うすべてのアドレスを追加します。ドメインもIP:ポートも両方です。

    リダイレクトURL
    http://YOUR-IP:PORT/api/auth/callback/discord
    https://your-domain.tld/api/auth/callback/discord
  3. Step 30

    ボットを再起動し、http://YOUR-IP:PORTを開きます(ポートはDASHBOARD_PORTです。Pterodactylではサーバーに割り当てられたポートです)。Sign in with Discordを押してアクセスを承認し、サーバーを選びます。

    認証処理のエラーが出た場合は、DISCORD_CLIENT_IDとDISCORD_CLIENT_SECRETを確認するか、そのサイトのクッキーを削除してください。

何を探せばよいか分かるように、簡単にご案内します。

  1. Step 31

    以下はすべて、1回のログインでサーバーごとに使えます。

    • サーバー概要、Server Health Score、メッセージ・参加・退出の分析
    • オン・オフを切り替えられる44個のモジュール:モデレーション、AutoMod、アンチヌーク、アンチレイド、レベル、経済、チケット、ウェルカム、リアクションロール、プレゼント企画など
    • タブ形式の設定と、モジュールを選んだチャンネルだけに限定する機能
    • 埋め込みビルダーと、保存したメッセージのライブラリ
    • 3つのモードでのバックアップと復元:完全、サーバーのみ、ボット設定のみ
    • プラグイン:ZIPからのインストール、有効化、無効化、設定
    • Role Manager:選んだロールにダッシュボードでのサーバー管理を許可できます。ただしプラグインは管理できません
    • ボットのバージョン表示と、新しいバージョンが出たときの通知
    • 9言語に対応し、すべてのタブに更新ボタンとキャッシュ削除ボタンがあります
  2. Step 32

    表示される順に、5つの画面があります。

    • Gate:任意のパスワード画面。DASHBOARD_PASSWORDで有効になります
    • Login:Discordでサインインします
    • Server picker:あなたが管理していて、ボットが参加しているサーバーが一覧で表示されます
    • Server home:オンライン状態、ping、稼働時間、メモリ、CPUを含むボットの状態、サーバーの統計、更新があるときの通知
    • Settings:タブ付きの1ページ。タブは次の項目で紹介します
  3. Step 33

    各タブには関連するモジュールがまとまっているので、どの機能もスイッチまで1クリックで届きます。

    • General:言語、プレフィックス、管理者ロール
    • ChannelsとChannel scopes:ボットが動作する場所を制限します
    • Modules:各機能のオン・オフを切り替えます
    • Moderation and security:AutoMod、Warnings、Appeals、Verification、Logging
    • Members:WelcomeとGoodbye、Reaction roles、Birthday
    • Engagement:Leveling、Starboard、Suggestions、Reputation、Counting、Confessions、Giveaways
    • Economy and games:EconomyとGames
    • Content:Tickets、Applications、Autoresponse、Sticky messages、Tags、Feeds(RSS、YouTube、Twitch、Reddit)、Socials、Reminders
    • Tools:Temp channels、Crypto、Backup and Restore、Webhooks、Embed builder、Links、Help
    • Admin:Analytics、Audit log、API keys、Plugins(ZIPのアップロード、オーナーのみ)、Premium
  4. Step 34

    スラッシュコマンドと、!プレフィックスで使える同じコマンドを、分野ごとにまとめています。

    • モデレーション:ban、tempban、softban、unban、kick、mute、unmute、timeout、voicemute、warn、notes、case、jail、shadowmute、clear、cleanup、lock、lockdown、slowmode、nick、role、timedrole、filter、altcheck、permcheck
    • セキュリティ:AutoMod、アンチヌーク、アンチレイドのロックダウン、認証、異議申し立て、メッセージログとサーバーログ、ロールのスナップショット、メンバーが再参加したときにロールとニックネームを復元するPersist
    • メンバー:ウェルカムとお別れのメッセージ、参加ロール、リアクションロール、ロールメニュー、招待トラッキング、名前の履歴、紹介
    • エンゲージメント:レベルロール付きのXPとレベル、メッセージとボイスのランクとリーダーボード、スターボード、提案、評価、カウントチャンネル、誕生日、告白、AFK、投票、ストリーク、クエスト、プレゼント企画
    • 経済:balance、daily、work、pay、bank、shop、market、lootbox、spin、heist
    • ゲーム:8ball、coinflip、dice、じゃんけん、tictactoe、connect4、トリビア、マッチメイキング、ゲーム統計
    • コンテンツツール:チケット、申請、自動応答、固定メッセージ、タグ、フィードとソーシャル、リマインダー、ダイジェスト、そして「見逃したこと」や「BANされた理由」に答えるコマンド
    • ユーティリティ:一時ボイスチャンネル、暗号資産の価格、Minecraftのステータス、情報、ヘルプ、リンク、バックアップ、Webhookイベント、読み取り専用のv1統計APIを使えるAPIキー、Premium
    • プラグイン:sample_plugin、minecraft_status、fear_greedなど、追加するだけで使えるプラグイン。それぞれサーバーごとに設定できます

ランチャーが変更を検出するので、アップデートは短時間で済みます。

  1. Step 35

    .envとdataディレクトリを残したまま新しいファイルを取得してから、再起動します。package.jsonが変わると、ランチャーが依存パッケージを再インストールし、ソースが変わると再コンパイルします。

    Pterodactylでは、.env、data、pluginsを削除せずに新しいファイルを古いファイルの上にアップロードしてから、サーバーを再起動します。設定はスキーマのマイグレーションで引き継がれます。

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

トラブルシューティング

The failures that actually happen, and what causes them.

インストールに関する質問

まとめ

VorqulBOTのインストールにかかる時間は10〜15分ほどです。Discord Developer Portalでアプリケーションを作成し、presence、server members、message contentの各インテントを有効にして、トークンとアプリケーションIDをコピーします。その後、クリーンなDebianまたはUbuntuサーバーにNode.js 22 LTSをインストールし、.env.exampleを.envにコピーして、npm installとnpm startを実行し、systemdで常時稼働させます。または、付属のeggをPterodactylにインポートし、ファイルをアップロードして、Startup変数を入力します。保存先は標準ではJSONファイルで、.envの1行でMySQL/MariaDBに切り替えられます。

  • 所要時間: 約10〜15分
  • ランタイム: Node.js 18以上、22 LTS推奨
  • デプロイ方法: DebianまたはUbuntuサーバー、Pterodactyl
  • ストレージ: JSONファイルまたはMySQL/MariaDB
このページの用語

Pterodactyl egg セルフホスト 特権インテント スラッシュコマンド OAuth2によるダッシュボードのサインイン モジュールレジストリ プレフィックスブリッジ

関連

Reviewed