3.3 KiB
Advanced Configuration for PyLink Relay
PyLink Relay provides a few advanced configuration options not documented in the example configuration, either because they have limited use, or are too complicated to be described briefly.
This guide assumes that you are relatively familiar with the
way YAML syntax works (lists, named arrays/dicts, etc.). For
the purposes of this document, configuration options will be referred to
in the format a:b:c, which represents the “c”
configuration key in a “b” block, all within an
“a” block.
Custom Clientbot Styles
Custom Clientbot styles can be applied for any of Clientbot’s
supported events, by defining keys in the format
relay:clientbot_styles:EVENTNAME. A list of supported
events can be found at
https://github.com/GLolol/PyLink/blob/1.1-alpha1/plugins/relay_clientbot.py#L12-L24.
- Note: the PM and PNOTICE events represent
private messages and private notices respectively, when they’re relayed
to users behind a Clientbot link. - Note 2: as of 1.1.x, all public
channel events are sent to channels as PRIVMSG, while PM
and PNOTICE are relayed privately as NOTICE.
These options take template strings as documented here: https://docs.python.org/3/library/string.html#template-strings. Supported substitution values differ by event, but usually include the hook values for each, plus the following:
- For all events:
$netname: origin network name$sender: nick of sender$sender_identhost: ident@host string of sender$colored_sender: color hashed version of$sender$colored_netname: color hashed version of$netname
- For KICK, and other events that have a
$targetfield corresponding to a user:$target_nick: nick of target (as opposed to$target, which is an UID)
- For events that have a
$channelfield attached (e.g. JOIN, PART) or have a channel in$target(PRIVMSG, etc.):$local_channel: the LOCAL channel name (of the clientbot network)$channel: the real channel on the sender’s network$mode_prefix: the highest prefix mode of the sender, if they are a user. This is normally either empty or one of (common prefix modes)~&!@%+.
- For SJOIN, SQUIT:
$nicks: a comma-joined list of nicks that were bursted$colored_nicks: a comma-joined list of each bursted nick, color hashed
To disable relaying for any specific event, set the template string
to an empty string ('').
Misc. options
relay:clientbot_startup_delay: Defines the amount of seconds Clientbot should wait after startup, before relaying any non-PRIVMSG events. This is used to prevent excess floods when the bot connects. Defaults to 5 seconds.servers:NETNAME:relay_force_slashes: This network specific option forces Relay to use/in nickname separators. You should only use this option on TS6 or P10 variants that are less strict with nickname validation, as it will cause protocol violations on most IRCds. UnrealIRCd and InspIRCd users do not need to set this either, as/in nicks is automatically enabled.servers:NETNAME:relay_endburst_delay: InspIRCd networks only: sets the endburst delay for relay subservers. If relay server bursts are causing +j (join flood) protection to trigger, raising this value can work around the issue.