自動魚拓機能(/gyotaku_auto)

指定した文字列が含まれる投稿を検知すると、その投稿へスクリーンショット風の画像で返信します。DiscordコマンドとWebコントロールパネルで同じ設定を管理できます。

使い方

操作 コマンド
登録・更新 /gyotaku_auto action:登録・更新 keyword:名言 channel:#雑談
設定一覧 /gyotaku_auto action:一覧
一時停止 /gyotaku_auto action:登録・更新 rule_id:<設定ID> enabled:False
再開 /gyotaku_auto action:登録・更新 rule_id:<設定ID> enabled:True
削除 /gyotaku_auto action:削除 rule_id:<設定ID>

Webでは「メッセージ」→「自動魚拓」→「設定を追加」を開き、対象チャンネルと検知する文字列を入力して保存します。登録済みの行を押すと編集・一時停止・削除ができます。

引数

引数 必須 内容
action 必須 登録・更新、一覧、削除
keyword 新規登録時 検知する文字列。1〜100文字
channel 任意 通常のテキストチャンネル。新規登録時は省略すると実行チャンネル
rule_id 削除時 一覧に表示される設定ID。更新時にも指定可能
enabled 任意 Falseで一時停止、Trueで有効。省略時はTrue

設定IDを指定した更新では、文字列・チャンネルを省略すると現在の設定を使います。IDなしで同じチャンネル・文字列を登録した場合は更新扱いです。

応答・返り値

  • 設定操作の結果と一覧は実行者本人だけに表示します。
  • 検知した投稿の画像は、その投稿と同じチャンネルへ返信します。
  • 1投稿が複数の設定に一致しても、返信画像は1枚です。

必要条件・権限

  • コマンド・Webの設定操作には、サーバー所有者または「管理者」権限が必要です。
  • Botに対象チャンネルの閲覧・メッセージ送信・ファイル添付・メッセージ履歴の閲覧権限が必要です。

制限・仕様

  • 部分一致で検知します。英字の大文字・小文字、全角・半角は区別します。正規表現ではありません。
  • 検知文字列の前後の空白は取り除いて登録します。
  • 1サーバー50設定までです。スレッド・DMは対象外です。
  • 登録後に送信された新しい投稿が対象です。編集や過去の投稿には反応しません。
  • Bot・Webhookの投稿には反応しません。
  • 1サーバーにつき1分間に5件までです。画像生成中に届いた追加の対象投稿や、制限を超えた投稿は省略します。
  • 添付画像自体は埋め込まずファイル名を表示します。本文は先頭約1,800文字までです。

使用例

/gyotaku_auto action:登録・更新 keyword:名言 channel:#雑談

この設定では「これは名言だね」という新しい投稿へ魚拓画像を返信します。

エラー・注意点

  • 画像生成・送信に失敗した投稿は自動で再試行しません。
  • 動かない場合は、設定が有効か、対象チャンネル・文字列・Botの権限を確認してください。
  • 一時停止した設定は残ります。不要な設定は削除してください。

コメント

タイトルとURLをコピーしました