セルフホスト型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ファイルなら何もインストールしなくて済みます |
パート1:Discord側の設定#
この手順はどのデプロイ方法でも共通です。インテントの設定を飛ばすと、インストールしたばかりのボットが何も反応しない原因になりやすいので注意してください。
-
Step 01
アプリケーションを作成する#
Discord Developer Portalで新しいアプリケーションを作成し、ボットを追加してから、トークンをリセットして表示します。
トークンは一度しか表示されません。安全な場所にコピーして保管し、コミットしたり、サポートチャンネルに貼ったり、スクリーンショットに写したりしないでください。漏れた場合はリセットしてください。Discordは古いトークンをすぐに無効にします。
General InformationにあるApplication IDもコピーしてください。ボットがスラッシュコマンドを登録するためにDISCORD_CLIENT_IDとして必要になります。ダッシュボードを使わない場合でも省略できません。
-
Step 02
3つの特権インテントを有効にする#
Botの Privileged Gateway Intents で、Presence Intent、Server Members Intent、Message Content Intentをオンにします。
Message Contentがないと、ボットはメッセージの本文を読めません。そのため、AutoMod、レベリング、プレフィックスコマンド、固定メッセージはすべて何も起きなくなります。Server Membersがないと、参加に反応できなくなるため、ウェルカムカード、参加ロール、招待トラッキング、アンチレイドが使えません。
ボットは接続されているのに何にも反応しない場合は、まずこの手順に戻ってください。
-
Step 03
ボットをサーバーに招待する#
OAuth2の URL Generator で、botとapplications.commandsのスコープを選び、権限を選択してから、生成されたURLを開いて自分のサーバーで承認します。
applications.commandsスコープがあるおかげで、83個のスラッシュコマンドが表示されます。これを外すと、ボットはサーバーに参加してもコマンドが1つも使えません。
-
Step 04
ダッシュボード用のOAuth認証情報を取得する#
OAuth2の General でClient Secretをリセットしてコピーし、RedirectsにコールバックURLを追加します。
Webダッシュボードを使う場合のみ必要です。ボット本体はシークレットもリダイレクトもなしで動作します。
リダイレクトURL http://localhost:3000/api/auth/callback/discord https://your-domain.tld/api/auth/callback/discord
パート2:ストレージを選ぶ#
実際に使えるバックエンドは2つで、.envの1行で切り替えます。別のエディションはありません。名前の印象ではなく、サーバーの規模で選んでください。
-
Step 05
JSONファイル:インストール不要#
テーブルごとに1ファイルずつ、data/jsonの下に保存されます。これが標準設定で、サービスも設定も要らないため、セルフホストの多くがこの方式で動いています。
.env DATABASE_TYPE=json DATA_PATH=./dataボットはDATA_PATHの後ろに自動で/jsonを付け足します。そのため、DATA_PATH=./dataならファイルは./data/jsonに保存されます。ここに./data/jsonと書くと、ファイルが1階層深い場所に作られてしまいます。
-
Step 06
MySQLまたはMariaDB:大規模サーバー向け#
サーバーをインストールし、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は必須です。それ以外だと、保存されたメッセージの絵文字や発音記号付きの文字が文字化けします。
パート3a:クリーンなDebianまたはUbuntuサーバーにデプロイする#
自分のマシンがある場合はこの方法です。以下はすべて、sudoを使える通常のユーザーで実行します。ボット自体はsudo権限のない専用ユーザーで動かします。
-
Step 07
Node.js 22とgitをインストールする#
システムを更新して基本のパッケージを入れ、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 --versionnode --versionでv22.xと表示されるはずです。v18以上であればボットは動きますが、18と20は上流のセキュリティ修正を受けられなくなっています。
-
Step 08
ボット用のユーザーを作成する#
専用のユーザーを使うと、トークンやデータをマシン上の他のものから隔離できます。
2番目のコマンドは、そのユーザーとしてシェルを開きます。systemdの手順までは、以降のコマンドはすべてそのシェルで実行します。
bash sudo adduser --disabled-password --gecos "" --home /opt/vorqul vorqul sudo -iu vorqul -
Step 09
ファイルを配置する#
専用のディレクトリにリポジトリをクローンするか、リリースアーカイブを展開します。package.jsonは作業ディレクトリの直下に置く必要があります。
リリースアーカイブを使う場合は、アップロードしてunzipを実行し、package.jsonが1階層下にならないように中身を上へ移動してください。
bash git clone https://github.com/Yamiru/Vorqul-DS-BOT.git app cd app -
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 -
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を付けてインストールしないでください。コンパイラは開発用の依存パッケージなので、ビルドに失敗します。
-
Step 12
systemdで常時稼働させる#
サービスにしておくと、プロセスが落ちたときに再起動され、サーバーの再起動後にも自動で立ち上がります。この手順を飛ばして、一晩でボットがオフラインになって困る人が多いです。
ユニットに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 -
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=
パート3b:Pterodactylにデプロイする#
すでにゲームホスティングパネルを使っている場合はこの方法です。どの手順でもシェルは必要ありません。
-
Step 14
eggをインポートする#
管理画面で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に追加して、サーバーでそれを選んでください。
-
Step 15
サーバーを作成する#
そのeggで新しいサーバーを作成します。RAMは1 GB(ダッシュボードを使う場合は2 GB)、ディスクは1 GBにして、CPU制限は特に設定しません。
ネットワークの割り当ては、ダッシュボードを使う場合にだけ関係します。ボット自体はDiscordへ外向きに接続するだけで、待ち受けるポートはありません。
-
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階層上に移動してください。
-
Step 17
Startup変数を入力する#
トークンとストレージの種類は、.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を指定してください。
-
Step 18
起動コマンドを確認する#
Node.js eggではnpm startです。代わりにpython3 bot.pyというランチャーもありますが、Node.jsとnpmも入っているコンテナでしか動きません。通常のPythonイメージでは動きません。
Pythonランチャーはボットだけを起動し、ダッシュボードは起動しません。特別な理由がなければ、Node.js eggを使ってください。
起動コマンド npm start -
Step 19
Pterodactylのパネル自体がおかしいとき#
これらは、ボットの中ではなく、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 -
Step 20
Startを押す#
初回の起動では、依存パッケージのインストールとコードのコンパイルが自動で行われ、1〜3分かかります。その後、ボットがオンラインになります。
すぐに終了した場合は、コンソールの出力を確認してください。トークンやアプリケーションIDが足りない場合は、ここで分かりやすいメッセージとともに失敗します。コンパイルが遅いtsxランタイムに切り替わったかどうかも、コンソールで確認できます。
パート4:Discord内での最初の設定#
ボットはオンラインになりました。役に立つか、邪魔になるかは、3つの設定で決まります。
-
Step 21
必要なモジュールをオンにする#
44個のモジュールのうち、最初からオンになっているのは9個です。モデレーション、レベリング、AFK、投票、経済、ゲーム、プレゼント企画、リマインダー、プレフィックスコマンドです。それ以外は、意図的にオフで始まります。
設定する前に運用中のサーバーでAutoModを有効にすると、昨日まで問題なかった行動を罰してしまうことになります。フィルターは1つずつオンにしてください。
-
Step 22
スタッフロールとログチャンネルを設定する#
他のどの設定よりも先に行ってください。ログチャンネルがないと、モデレーションの操作に目に見える記録が残らず、最初のトラブルに答えられなくなります。
自動でも手動でも、すべての操作は連番のケースとして記録されますが、ログチャンネルがあることで、その場で見えるようになります。
-
Step 23
インストールを確認する#
/info pingと/helpを実行してください。ボットが応答してコマンドの一覧が表示されれば、トークン、インテント、コマンド登録はすべて正常に動いています。
スラッシュコマンドが表示されない場合は、招待時にapplications.commandsスコープを外したか、DISCORD_CLIENT_IDが空または間違っています。Discordが新しく登録したコマンドを表示するまでに、数分かかることがあります。
パート5:セキュリティを固める#
ここでの5分間が、第三者にボットを使われるかどうかを分けます。
-
Step 24
Public Botをオフにする#
Developer Portalで自分のアプリケーションを開き、BotでPUBLIC BOTをオフにします。
オンのままだと、クライアントIDを知っている人なら誰でも、ボットを自分のサーバーに追加できます。これを防ぐ本当の方法は、このスイッチだけです。
-
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はカンマで区切ります。
-
Step 26
トークンはパスワードと同じように扱う#
誰にも送らず、.envをGitHubにアップロードしないでください(.gitignoreに含まれています)。漏れた場合は、Developer PortalでReset Tokenを押し、新しいトークンを貼り付けてください。
パート6:.envリファレンス#
すべての変数について、役割と必要かどうかを説明します。
-
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に切り替えても、古いデータは自動では移動しません。
パート7:ダッシュボードへの初回サインイン#
6つの手順があり、3つ目でつまずく人が多いです。
-
Step 28
変数を設定する#
DASHBOARD_ENABLED=true、DISCORD_CLIENT_ID、DISCORD_CLIENT_SECRET、NEXTAUTH_SECRETを設定します。
-
Step 29
リダイレクトURLを追加する#
Developer PortalのOAuth2、General、Redirectsに、サインインに使うすべてのアドレスを追加します。ドメインもIP:ポートも両方です。
リダイレクトURL http://YOUR-IP:PORT/api/auth/callback/discord https://your-domain.tld/api/auth/callback/discord -
Step 30
再起動してサインインする#
ボットを再起動し、http://YOUR-IP:PORTを開きます(ポートはDASHBOARD_PORTです。Pterodactylではサーバーに割り当てられたポートです)。Sign in with Discordを押してアクセスを承認し、サーバーを選びます。
認証処理のエラーが出た場合は、DISCORD_CLIENT_IDとDISCORD_CLIENT_SECRETを確認するか、そのサイトのクッキーを削除してください。
パート8:ダッシュボードでできること#
何を探せばよいか分かるように、簡単にご案内します。
-
Step 31
機能#
以下はすべて、1回のログインでサーバーごとに使えます。
- サーバー概要、Server Health Score、メッセージ・参加・退出の分析
- オン・オフを切り替えられる44個のモジュール:モデレーション、AutoMod、アンチヌーク、アンチレイド、レベル、経済、チケット、ウェルカム、リアクションロール、プレゼント企画など
- タブ形式の設定と、モジュールを選んだチャンネルだけに限定する機能
- 埋め込みビルダーと、保存したメッセージのライブラリ
- 3つのモードでのバックアップと復元:完全、サーバーのみ、ボット設定のみ
- プラグイン:ZIPからのインストール、有効化、無効化、設定
- Role Manager:選んだロールにダッシュボードでのサーバー管理を許可できます。ただしプラグインは管理できません
- ボットのバージョン表示と、新しいバージョンが出たときの通知
- 9言語に対応し、すべてのタブに更新ボタンとキャッシュ削除ボタンがあります
-
Step 32
ページ#
表示される順に、5つの画面があります。
- Gate:任意のパスワード画面。DASHBOARD_PASSWORDで有効になります
- Login:Discordでサインインします
- Server picker:あなたが管理していて、ボットが参加しているサーバーが一覧で表示されます
- Server home:オンライン状態、ping、稼働時間、メモリ、CPUを含むボットの状態、サーバーの統計、更新があるときの通知
- Settings:タブ付きの1ページ。タブは次の項目で紹介します
-
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
-
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など、追加するだけで使えるプラグイン。それぞれサーバーごとに設定できます
パート9:アップデート#
ランチャーが変更を検出するので、アップデートは短時間で済みます。
-
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によるダッシュボードのサインイン モジュールレジストリ プレフィックスブリッジ
VorqulBOT
ボットの機能を、モジュールごとに紹介します。
AutoMod
15種類のフィルターと、不用意にオンにした場合に起こること。
よくある質問への回答
料金、動作要件、制限を1か所にまとめています。
Reviewed