カスタムコマンド | Noxyrドキュメント

カスタムコマンドとは

カスタムコマンドは、Noxyrにすでにあるコマンドに新しい名前を付けたものです。$store で $shop を実行したり、$done で $ticket close を実行したり、$gnitro で賞品を Discord Nitro に設定した $giveaway create を実行したりできます。メンバーは、サーバーのプレフィックスを付けた新しい名前をメッセージとして入力し、ボットが本来のコマンドを実行します。

新しい動作が追加されることはありません。本来のコマンドが、それ自身の権限、モジュールの切り替え、クールダウンで実行されるため、カスタム名によって、本来は持っていない権限が与えられることはありません。元の名前も、新しい名前と並行して使えます。

作成する

ダッシュボードを開き、サーバーを選んで、Control から Custom Commands に進みます。
「New custom command」を押すか、「Templates」を開いてテンプレートをクリックすると、完成済みのものを追加できます。
Trigger の欄に新しい名前を入力します(例: store)。
Command の欄で実行するコマンドを選びます。そのコマンドに複数の操作がある場合は、操作も選びます(ticket には close、claim、rename などがあります)。
任意: Value を設定してオプションをプリセットします(例: prize を Discord Nitro に設定する)。
編集を止めてから約1秒後に、変更は自動で保存されます。保存ボタンの横のステータスに、保存されたかどうかが表示されます。

カスタムコマンドはプレフィックスコマンドです。 / メニューではなく、$store のようなメッセージとして動作します。Discordでは、ボットは自身のスラッシュコマンドを登録できますが、サーバーごとに登録することはできません。

Graph と Simple list

このページには、同じリストを表示する2つの方法があります。Graph では、各カスタムコマンドが Trigger と Command の接続として表示され、Value がオプションに接続されます。点を別の点にドラッグして接続し、線をクリックして切断し、ボックスをタイトルでドラッグして移動できます。Tidy を押すと、すべてが整列します。

Simple list は、名前、コマンドの選択、プリセット値を並んだ行で表示します。どちらを使ってもかまいません。表示を切り替えても何も変わりません。

左側のパネルには、すべてのカスタムコマンドが「旧名 → 新名」の形式で表示されます。それぞれにオン/オフのスイッチがあるので、削除せずに名前を一時停止できます。削除ボタンもあります。

テンプレート

テンプレートをクリックすると、完成済みのカスタムコマンドを1クリックで追加できます。すでに使っている名前のテンプレートはグレーアウトされます。

音楽: $p(再生)、$np(再生中)、$s(スキップ)、$q(キュー)、$dc(退出)、$vol(音量)、$repeat(キューをループ)、$bass(ベースブーストフィルター)、$247(24時間再生)
チケット: $done(チケットを閉じる)、$claim(チケットを担当)、$faqs(チケットのFAQ一覧)
ストア: $store(ショップ)、$vouch(レビュー投稿)
コミュニティ: $gnitro(プレゼント作成、賞品は Discord Nitro)、$apply(応募)、$lb(ランキング)
モデレーション: $purge(メッセージ削除)

プリセット値と入力するオプション

プリセットは、カスタムコマンドを実行するたびに自動で入力されます。名前の後にメンバーが入力した内容は、そのあとに追加されます。そのため、賞品がすでに設定されている場合でも $gnitro 1h 1 は動作します。メンバーが同じオプションを名前で指定した場合(prize:「Gift card」)は、メンバーの入力がプリセットより優先されます。

値: 最大200文字。二重引用符と改行は使えません。
選択肢: ループモードやフィルターのように固定のリストがあるオプションは、そのリストにある値だけを受け付けます。
数値: 整数と数値のオプションは数字だけを受け付けます。はい/いいえのオプションは、yes、no、on、off、true、false を受け付けます。
ファイル: ファイルのオプションはプリセットできません。

名前のルール

使える文字: 英字、数字、- と _ が使え、最大32文字です。入力中にスペースはハイフンに変換され、名前は小文字になります。
既存のコマンド名: カスタムコマンドに、Noxyrの既存のコマンド名は使えません。既存のコマンド名が常に優先されます。
一意性: 各名前はサーバーごとに1回だけ使えます。
上限: サーバーごとに最大100個のカスタムコマンドです。

保存を妨げる問題は、エディターの上にまとめて表示されます。問題をクリックすると、修正が必要な欄に移動します。

プレフィックスの変更

左パネルの下にある Prefix の欄で、サーバー全体のプレフィックスを変更できます。対象は、カスタムコマンドと、すべての通常のコマンドです。最大5文字まで、スペースなしで入力してください(例: !、?、.、n!)。Save を押します。空欄にすると初期値の $ になります。ページ上のすべての名前は、すぐに新しいプレフィックスに更新されます。

同じ設定は、セットアップページと、Discordの /prefix set でも行えます。

カスタムボット

サーバーでNoxyrのカスタムボットが動いている場合、そのボットも同じプレフィックスで同じカスタムコマンドに応答します。2回設定する必要はありません。