本文へ移動
Dialova

IRCドキュメント · 中級

IRCボットの仕組みと設計

IRCボットは、クライアントと同じようにネットワークへ接続するプログラムです。イベントを読み、コマンドに応答し、ゲームなどでチャンネルの会話を盛り上げられます。安定して動かすには、プロトコル、権限、送信の頻度を適切に扱うことが重要です。

Dialova運営チーム · 確認日

ボットの基本的な流れ #

  1. TLSで接続し、証明書を検証します。
  2. CAPで機能を交渉し、必要な場合はアカウントを認証します。
  3. IRCの利用者情報を送り、登録完了を待ちます。
  4. 許可されたチャンネルに参加し、メッセージ、エラー、イベントを処理します。
  5. PINGに応答し、送信を制限し、段階的な再接続を準備します。
登録と参加権限の確認を終えた接続での一例
S: PING :jeton-123
C: PONG :jeton-123
S: :Alice!alice@cloak.example PRIVMSG #atelier :!bonjour
C: PRIVMSG #atelier :Aliceさん、こんにちは!

この例はやり取りの流れを示すもので、実行できる完全なプログラムではありません。一度の受信で必ず一行が届くと仮定するよりも、保守されているIRCライブラリーで通信と構文を扱う方法が役立ちます。

プロトコル・判断・送信を分ける #

構成要素役割
通信と解析TLS、バイト、CRLF、分割されたメッセージ、保持量の制限。
IRCの状態登録、拡張機能、チャンネル、アカウント、状態の変化。
ボットの処理要求を認識し、条件を確認し、実行したい操作を決めます。
送信キュー頻度と順序を管理し、再接続で同じ送信を繰り返さないようにします。

ニックネームだけを信用しない #

参加者は名前を変えたり、コマンドらしい文章をまねたりできます。重要な操作では、利用できる場合はサーバー提供の識別情報を使い、操作ごとの権限も確認してください。ゲームボットに発言させるだけのために、オペレーター権限を与えるべきではありません。

受信した本文は信頼できない入力です。シェル、文字列連結で作る問い合わせ、コード実行機能にそのまま渡してはいけません。認証情報は非公開の設定に保存し、リポジトリやボットの返答に含めないでください。

連投と応答ループを避ける #

制限はネットワークが定めます。どこでも安全な共通の送信間隔はありません。エラーを処理し、適切なら送信をまとめ、利用者ごと・チャンネルごとに操作を制限してください。再接続を即時に繰り返すのではなく、待ち時間を段階的に設けます。

NOTICEに自動応答したり、履歴再生中の古い利用者コマンドを実行したりしないでください。echo-messageによって自分の送信が戻る場合もあるため、新しい要求と区別する必要があります。

DialovaのBobot #

BobotはDialovaのチャンネル内ゲームなどを進行します。サイトのグラフィカルなゲームや、利用者のアカウントとは別のものです。IRCのような共通プロトコルでも、自動化されたクライアントによってコミュニティに機能を追加できます。

出典と確認

例では、明記した接続先を除き、架空のニックネームとドメインを使用しています。特定のネットワークだけにある拡張や設定は、本文で区別しています。