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の本文が無制限になるわけではありません。不明なタグ、不正なエスケープ、重複キーは仕様に従って処理してください。拡張をすべて拒否する解析や、上限なく情報を保持する実装を避けましょう。
出典と確認
例では、明記した接続先を除き、架空のニックネームとドメインを使用しています。特定のネットワークだけにある拡張や設定は、本文で区別しています。
- IRCv3 — メッセージタグ ↗仕様の出典 · 2026-10-29確認
- IRCv3 — server-time ↗仕様の出典 · 2026-10-29確認
- IRCv3 — account-tag ↗仕様の出典 · 2026-10-29確認
- IRCv3 — batch ↗仕様の出典 · 2026-10-29確認