This page is intended for developers. If you're looking information on for how to link servers you should refer to the spanningtree module (v4 docs, v3 docs) page instead.

METADATA

Changes the specified channel, user, or network metadata entry to the specified value.

Connection Phases

This message can be used in the following connection phases:

Connection Phase Usable?
Connecting outbound
Authenticating outbound
Authenticating inbound
Fully connected ✔️

Syntax

[:<sid>] METADATA <channel> <ts> <key> [<value>]

[:<sid>] METADATA <uid> <key> [<value>]

[:<sid>] METADATA {@} <uid> <channel> <ts> <membid> <key> [<value>]

[:<sid>] METADATA {*} <key> [<value>]

Parameter Description
<channel> The channel which the metadata applies to.
<membid> The membership identifier which the metadata applies to.
<ts> The time at which the channel was created.
<uid> The user which the metadata applies to.
<key> The name of the metadata entry.
<value> The value of the metadata entry.

Some possible values for the key field are:

Name Type Description
accountid User The account identifier of the target user.
accountname User The account name of the target user.
accountnicks User A space-delimited list of nicknames associated with the target user's account.
auspex Channel Enables services servers receiving messages for the target channel even when it has no users in it.
ctitle User The custom WHOIS title of the target user.
filter Server A filter entry which is set on the originating server.
gateway-realhost User The hostname of the WebIRC gateway the target user connected via.
gateway-realip User The IP address of the WebIRC gateway the target user connected via.
mlock Channel The modes which are locked on the target channel and can not be changed.
modules Server A module state change on the originating server.
operquit User The quit message to show to server operators when the tatget user quits.
swhois User The custom WHOIS message of the target user.
topiclock Channel Marks the target channel as having an immutable topic.
webirc-gateway User The name of the WebIRC gateway that the target user connected via.

Example Usage

Changes the mlock channel metadata for #chan to channel modes n (noextmsg) and t (topiclock):

:36D METADATA #chan 1234567890 mlock :+nt

Changes the cap user metadata for user 36DAAAAAA:

:36D METADATA 36DAAAAAA caps :multi-prefix userhost-in-names capversion=3.2

[1206+] Changes the wibble membership metadata for user 36DAAAAAA on #chan:

:36D METADATA @ 36DAAAAAA #chan 1234567890 123 wibble :Wobble

Changes the wibble network metadata:

:36D METADATA * wibble :Wibble Wobble

History

1206

Support for membership metadata was added.