Wiki / Core Features / カスタムコマンド

カスタムコマンド

更新者 Maxime_48 · 3時間前 · 閲覧数:107

言語: English Français Deutsch Español Português (Brasil) Italiano Nederlands Polski Türkçe Русский 日本語 한국어 中文

カスタムコマンドを使うと、サーバー独自のスラッシュコマンドを作れます。メンバーが/yourcommandを実行すると、botはあなたが定義したメッセージや埋め込みで返信します。コーディングは不要です。すべてWebダッシュボードから管理できます。

テキスト返信と埋め込み返信の2つのコマンド、そのクールダウンとロールの制限を表示したカスタムコマンドのページ


⚡ 仕組み

  1. サーバーでカスタムコマンド機能を有効にします。
  2. 専用のカスタムコマンドページを開きます。
  3. 新しいコマンドをクリックし、名前を決めて、返信を書きます。
  4. 保存します。コマンドはサーバーに自動で登録されます。

メンバーは、ほんの少し待てば使えます。コマンドを追加、編集、削除するたびに、YAWBDBがサーバーのコマンドを自動で再登録します。

/rulesより!rulesのほうがよいですか? 機能 → テキストコマンドでテキストのプレフィックスを設定すると、このページのすべてのコマンドが、シンプルモードでもグラフモードでも、それに反応するようになります。詳細と、プレフィックスでは届かないものの一覧は、テキストコマンドとプレフィックスをご覧ください。


✍️ コマンドを作る

各コマンドには、次の項目があります。

  • コマンド名 - メンバーがスラッシュの後に入力するもの(/rules、/socialsなど)。英小文字、数字、-、_のみ、最大32文字です。
  • 説明 - Discordでコマンドを見るときに表示される短いテキスト。
  • コマンドタイプ - シンプル返信(テキストまたは埋め込み。ほとんどの用途に対応)か、高度(グラフ)(ビジュアルのノードエディター。下を参照)。
  • 応答タイプ - シンプルなコマンドの場合:通常のテキストメッセージか、リッチな埋め込み。

テキスト返信

botに送らせたいメッセージを書くだけです。簡単な答え、リンク、サーバーの情報に最適です。

埋め込み返信

次の項目で、整ったカードを作れます。

  • タイトルと説明
  • 色(16進数。例: #5865F2)
  • 画像とサムネイル(URL)
  • フッターのテキスト

埋め込みには、タイトルか説明の少なくとも一方が必要です。


🧩 高度モード:コマンドグラフ

コマンドを**高度(グラフ)**に切り替えると、レベリングの報酬グラフと同じビジュアルのノードエディターで、その動作を設計できます。固定の返信の代わりに、ノードをつなげていきます。

  • トリガー - すべてのグラフは、コマンド使用トリガーから始まります。メンバーがコマンドを実行するたびに発動します。
  • 条件 - ロールを持っている/持っていない、サーバーブースター、時間帯、曜日、サーバーとアカウントの経過日数、レベルの範囲、XPの範囲、連続記録、プレスティージ。
  • ロジック - AND/OR/NOTゲート、ランダム分岐、遅延、クールダウン、シーケンス。
  • アクション - 返信(返信されるメッセージ。必須)、ロールの付与/削除/入れ替え、XPの付与、DMの送信、チャンネルへの投稿、チャンネルのロック/ロック解除、称号の付与、一時的なXP倍率。

返信アクション

コマンドグラフには、少なくとも1つの返信アクションが必要です。これがメンバーに表示されるメッセージです。返信では、動的な変数が使えます。{username}、{level}、{xp}、{streak}、{prestige}、{server}です。ある実行で、条件によってすべての返信が除外された場合、botは単にコマンドを✓で受け付けます。

{prestige}は、プレスティージ保持条件と相性がよいです。プレスティージのランクで返信を分岐させ、そのランクをメッセージで伝えます。

異なる分岐に、複数の返信アクションを追加できます。たとえば、ブースター向けの別の答えや、複数の返信からのランダムな選択などです。

✨ アシスタントに作ってもらう

グラフアシスタントは、説明からコマンドグラフの下書きを作り、確認用に提案できます。

ℹ️ ここでカードにできることを確認する

すべてのカードに**(i)**ボタンがあり、そのカードが何を読み取るか、どの項目だと何も起きなくなるか、そして使える変数を確認できます。コマンドグラフでは特に開く価値があります。コマンドが持つ情報は、レベリングのイベントより少ないからです。

パネルは使えないものに取り消し線を引くので、発動しないグラフであとから気づくのではなく、ひと目でわかります。コマンドは、メンバーのレベル、XP、連続記録、プレスティージ、ロール、アカウントの経過日数、サーバーでの在籍期間を知っていますが、それらの値が以前どうだったかは知らず、XPイベントやWordleの文脈もありません。そのため、XPしきい値のような、変化を軸にしたカードは、ここでは比較する対象がありません。

パネルの詳しい説明は、報酬グラフをご覧ください。

アイデア

  • /daily - クールダウンノード(24時間)から、XPの付与と返信(「Here's your daily bonus!」)につなげます。クールダウン中は報酬の分岐がスキップされ、botは✓で受け付けるだけになります。
  • /color - ロールの条件を確認し、複数のカラーロールからランダムに1つを付与して、返信で知らせます。
  • /vip - ブースター専用の分岐で、チャンネルのロックを解除し、非公開で返信します。

グラフエディターにはデスクトップの画面が必要です。モバイルでは、読み取り専用の概要が表示されます。


⚙️ オプション

オプション 内容
ロールで制限 選んだロールのいずれかを持つメンバーだけが、そのコマンドを使えます。空欄にすると、全員が使えます。
クールダウン(秒) 使用の最小間隔(秒)。メンバーごとです。0はクールダウンなしを意味します。
応答を実行したメンバーのみに表示 返信は、コマンドを実行した人にだけ非公開(エフェメラル)で表示されます。
有効 コマンドを削除せずにオンまたはオフにします。

🚫 予約された名前

カスタムコマンドには、botの組み込みコマンドがすでに使っている名前(rank、leaderboard、report、ticket、wordle、voiceなど)は使えません。名前が使われている場合は、ダッシュボードが知らせてくれます。

また、各コマンド名は、サーバー内で一意である必要があります。


📦 上限

構成によっては、サーバーごとのカスタムコマンドの数に上限がある場合があります。上限があるときは、ページに現在の数が上限と並べて表示されます。Discord自体にも、サーバーごとのコマンドの総数の上限があり、botの組み込みコマンドと共有されます。


👍 おすすめの設定

  1. 機能を有効にして、カスタムコマンドのページを開きます。
  2. まずは、/rulesや/infoのようなシンプルなテキストコマンドを作ります。
  3. /socialsのような、よりリッチなものには、埋め込みコマンドを追加します。
  4. スタッフ専用のコマンドには、ロールで制限を使います。
  5. 連打されそうなコマンドには、小さなクールダウンを追加します。

💡 ベストプラクティス

  • メンバーが推測できるよう、名前は短く、予想しやすいものにしましょう。
  • 依頼した本人だけが見ればよい答えには、エフェメラルの返信を使いましょう。
  • 楽しいコマンドや、うるさくなりがちなコマンドには、クールダウンを追加しましょう。
  • たまにしか使わないコマンドは、削除せずに無効にしましょう。