本文へ移動
Dialova

IRCドキュメント · 上級

IRCv3メッセージタグの仕組み

メッセージタグは、IRCメッセージの本体より前にメタデータを追加します。時刻、アカウント、バッチとの関連などを表せます。不明なタグを画面で使わなくても、形式は正しく解析する必要があります。

Dialova運営チーム · 確認日

タグ領域を読む #

二つのタグを持つサーバーメッセージ
@time=2026-10-29T10:00:00.000Z;account=alice :Alice!u@cloak.example PRIVMSG #atelier :Bonjour

タグ領域は @ で始まり、最初のエスケープされていない空白まで続きます。各タグは ; で区切られ、キーの後に = と値が付く場合があります。順序には意味がなく、キーは大文字・小文字を区別します。この領域を取り出す前に、メッセージのパラメーターを分割しないでください。

値のデコードは一度だけ行う #

通信上の表現デコード後の値
\:セミコロン
\s空白
\\バックスラッシュ
\r復帰文字
\n改行文字

エスケープはタグの値に適用され、メッセージ全文に適用するものではありません。値はUTF-8です。この仕組みでは空の値と値なしは同じ扱いなので、画面側で意味の違いを作り出さないでください。

共通機能と個別の拡張機能 #

message-tagsは完全なタグ形式への対応を示し、クライアント専用タグやTAGMSGなどを利用可能にします。server-time、account-tag、batchもタグ形式を使いますが、それぞれの交渉とmessage-tagsの交渉を同一視してはいけません。

架空のクライアントタグの例。特定の機能が働くことは想定していません。
C: CAP REQ :message-tags
S: :irc.example CAP Alice ACK :message-tags
C: @+example.org/note=こんにちは\sここ TAGMSG #atelier

+ の付いたものはクライアントタグです。クライアントが述べた情報を、サーバーが保証する情報へ変えるものではありません。サーバーが通知するアカウントと、参加者が送る任意の文字列は区別してください。

メタデータにもサイズ制限がある #

タグのサイズ上限は、従来のメッセージ本体の上限とは別に扱います。タグがあるからといってPRIVMSGの本文が無制限になるわけではありません。不明なタグ、不正なエスケープ、重複キーは仕様に従って処理してください。拡張をすべて拒否する解析や、上限なく情報を保持する実装を避けましょう。

出典と確認

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