カスタムコマンド
返信、メッセージ送信、ロール付与、ニックネーム変更を行うサーバー独自のスラッシュコマンド。
主な機能
サーバー独自のスラッシュコマンド
コミュニティに合わせた名前、説明、動作でDiscordのサーバー用アプリコマンドを作成できます。
順番に実行するアクション
各コマンドで1〜4個のアクションを実行します。返信、チャンネルへの送信、ロールの付与・解除、ニックネームの接頭辞・接尾辞の変更に対応します。
条件とクールダウン
レベル、通貨残高、在籍期間で利用を制限し、メンバー単位またはサーバー全体のクールダウンを設定できます。ロールや権限によるアクセスはDiscordのスラッシュコマンド権限で設定します。
ダッシュボードで管理
管理者が設定から作成・編集・削除すると、Noxが対応するDiscordのサーバーコマンドを作成・更新・削除します。
可能な範囲でアクションを実行
重複した操作を防止します。後のアクションが失敗しても、先に実行されたDiscord上の変更は残り、エラーページに失敗を記録します。
おすすめの用途
繰り返し使う回答、参考リンク、参加案内、スタッフ向けのショートカット。
1つの簡単なコマンドで複数のDiscord操作を行う軽量な自動化。
ボットを自作したり、その実行環境を用意したりせずに独自のスラッシュコマンドを使いたいコミュニティ。
仕組み
コマンドを作成
管理者は小文字とアンダースコアを使ったコマンド名と説明を入力し、アクションを実行する順に並べます。各コマンドには返信アクションが少なくとも1つ必要です。
Discordコマンドを作成
保存するとDiscordのサーバー用アプリコマンドを作成または更新し、メンバーの実行時に使う設定を保存します。
メンバーが実行
Discordから実行の通知を受け取ると、組み込みコマンド、カスタムコマンド、フォームの順に、該当するコマンドを確認します。
アクションを順番に実行
Noxは返信・追加返信、設定したチャンネルへの送信、ロールやニックネームの変更をDiscordの権限に従って実行します。
設定チェックリスト
小文字とアンダースコアを使い、3〜32文字のコマンド名を決めます。
10〜100文字でコマンドの説明を書きます。
1〜4個のアクションを追加し、少なくとも1つを返信にします。
返信と送信のアクションにメッセージ内容があることを確認します。
必要に応じてレベル・通貨・在籍期間の条件とクールダウンを追加し、Discordのコマンド権限で表示対象を設定します。
アクションに必要なチャンネル権限、「ロールを管理」、「ニックネームを管理」を付与します。
アクション、パラメーター、利用条件
使用すると、設定順にアクションを実行します。
| アクション | 動作 |
|---|---|
| 返信 | コマンドを実行したメンバーに返信 |
| ランダム返信 | 複数のメッセージからランダムに選んで返信 |
| メッセージ送信 | 指定チャンネルに投稿 |
| ロールの付与・解除 | メンバーにロールを付与、または解除 |
| 期限付きロール | 指定した分数だけロールを付与し、その後解除 |
| ニックネームの接頭辞・接尾辞・リセット | ニックネームの先頭・末尾への追加、またはリセット |
| 通貨の差し引き | メンバーの残高から指定額を差し引く |
コマンドは1〜4個のアクションを実行し、少なくとも1つの返信が必要です。返信アクションを置けるのは最大1回です。返信ごとに、メンバー本人だけに表示するか、チャンネルの全員に表示するかを選べます。
ランダム返信と期限付きロールにはPremiumが必要です。Premiumのないサーバーでも、これらを使うコマンドを下書きとして保存できますが、有効にはできません。Premiumが終了すると、これらを使う有効なコマンドは下書きに戻ります。付与済みのロールは予定どおり解除されます。
パラメーターは実行時に入力を受け取り、その値をアクション内で再利用できます。
| パラメーターの種類 | 受け取る内容 |
|---|---|
| テキスト | 自由入力のテキスト |
| ユーザー | メンバーの選択 |
| チャンネル | チャンネルの選択 |
| ロール | ロールの選択 |
1コマンドにつき最大25個です。必須パラメーターは任意パラメーターより前に並べます。
利用条件で実行できる人を制限し、クールダウンで実行頻度を制限します。
| 条件（最小または最大） | 確認するメンバーの情報 |
|---|---|
| レベル | 現在のレベル |
| 通貨 | 通貨残高 |
| 在籍期間 | サーバー参加からの経過時間 |
条件は最大5個です。クールダウンは無効から最大30日までで、メンバー単位またはサーバー全体に適用します。コマンドの表示対象はDiscordのコマンド権限で設定します。
注意事項
同じサーバーのフォームやほかのアプリコマンドと同じ名前は使えません。重複しないコマンド名を付けてください。
実行は可能な範囲で進められます。後のロール、ニックネーム、送信アクションが失敗しても、先のアクションは取り消されません。
カスタムコマンドはスラッシュコマンドから実行します。対話型モーダルの表示、DMの受信、Webhookとしての動作はできません。
削除すると、Discordのコマンド、保存済み設定、返信・送信アクションに紐付くメッセージ画像も削除されます。
各サーバーが独自の名前を定義するため、動的なカスタムコマンドはこのページの固定コマンド一覧には表示されません。
トラブルシューティング
Discordにコマンドが表示されない
名前の重複や作成エラーを確認してください。新しく作成したサーバーコマンドがDiscordに表示されるまで時間がかかる場合もあります。
ロールの操作が失敗した
Noxに「ロールを管理」があり、最上位ロールが付与・解除するロールより上にあるか確認してください。それ以前のアクションは完了している場合があります。
ニックネームの操作が失敗した
Noxに「ニックネームを管理」があり、最上位ロールが対象メンバーの最上位ロールより上にあるか確認してください。Discordはボットによるサーバー所有者のニックネーム変更を許可しないため、所有者に対する変更は必ず失敗します。
古いコマンドが残っている
サーバーのコマンドリソース画面で、Discordに登録されたコマンドとNoxのカスタムコマンドの対応を確認してください。対応する設定がないコマンドは、必要に応じて削除します。
権限
この機能に Nox が必要とする Discord 権限と、それぞれの用途です。
これらの機能をサーバーに追加
NoxをDiscordに追加し、ダッシュボードでサーバーを設定しましょう。追加を許可する前に、必要な権限を確認してください。