Modules are native xBNC features, built into the program, that are turned on and configured per network: in the panel (Modules), with the API or from IRC with /msg *status. Changes apply at once, without reconnecting. Every setting is validated (types, ranges, lengths, no control characters). Passwords and keys are stored encrypted and the panel never shows them again: to change them, type them again.
/msg *status modules list and state
/msg *status enable keepnick turn on (disable to turn off)
/msg *status get away show settings
/msg *status set away delay 60 change a setting
/msg *status addline watch patterns *xbnc* add a line to a list
/msg *status dellines watch patterns empty a list
/msg *status availmods every module and plugin, with what it does
Setting types: yes/no (in *status, true, on or 1 for yes and false, off or 0 for no), number (with a minimum and maximum), text, list (one entry per line), choice (one of the values given) and secret (stored encrypted).
Connection and account
Services login
servicesnew in 1.0
Logs you in to X (Undernet), NickServ, Q or AuthServ when connecting and hides your IP before joining channels.
On Undernet it uses Login on Connect: the account goes in the server password and your real IP is never shown. If the network already has a server password, it logs in with /msg X login after connecting. Channels wait until the network confirms the login. With “Hide my IP”, no channel is ever joined before the network hides your IP, even if that takes longer than the wait (/msg *status joinnow joins them anyway). The password is stored encrypted and never shown again.
Setting
Type
Default
Detail
Service
service
choice
auto
Options: auto Automatic, by network, x X (Undernet), nickserv NickServ (Libera, Rizon, EvilNet…), q Q (QuakeNet), authserv AuthServ (GameSurge, AfterNet).
Account
account
text
empty
Your account name on the service. With NickServ it can be empty if it is your nick.
Password
password
secret
empty
Hide my IP (mode +x)
hide_host
yes/no
yes
On X, Q and AuthServ. Other networks do it themselves.
Log in while connecting (Login on Connect)
login_on_connect
yes/no
yes
Undernet only: the real IP is never shown.
Wait before joining channels (seconds)
wait
number (0–120)
15
Until the network confirms the login. 0: do not wait. With “Hide my IP” the channels always wait for the hidden IP.
Get my nick back if it is taken
recover_nick
yes/no
yes
With NickServ: asks for the nick (REGAIN or GHOST) after logging in.
Example
Connecting to irc.example.org:6667 with Login on Connect…
*** Your host is now y2k.users.example.org
* y2k has joined #xbnc
From IRC: /msg *status enable services and /msg *status get services
Invite and unban
invitenew in 1.0
If you cannot join a channel (+i, +k, +l or a ban), asks X or ChanServ to invite or unban you and joins again.
It tries at most three times every ten minutes per channel. You need access in the channel for the service to listen.
Setting
Type
Default
Detail
Channel service
service
choice
auto
Options: auto Automatic, by network, x X (Undernet), chanserv ChanServ, q Q (QuakeNet).
Ask to remove my ban
unban
yes/no
yes
Join when invited to one of my channels
join_invites
yes/no
yes
Example
#xbnc: cannot join channel (+i)
*statusAsking X to let you into #xbnc (+i).
* y2k has joined #xbnc
From IRC: /msg *status enable invite and /msg *status get invite
Client certificate (CertFP)
cert
Identifies you on the network with a certificate instead of a password. Enables SASL EXTERNAL.
Generate a certificate, add its fingerprint to your network account and reconnect. On Libera.Chat: connect identified and type /msg NickServ CERT ADD. Only works with TLS.
Setting
Type
Default
Detail
Use SASL EXTERNAL if the network offers it
sasl_external
yes/no
yes
Example
y2k/msg NickServ CERT ADD
NickServAdded fingerprint 3f9a…c21e to your fingerprint list.
From IRC: /msg *status enable cert and /msg *status get cert
Keep nick
keepnickon by default
If your nick is taken when connecting, xBNC takes it back as soon as it is free.
Checks every 30 seconds whether your nick is free and takes it back as soon as whoever holds it disconnects. If you change nick by hand from your client, it pauses until the next connection.
Example
*statusYour nick y2k is taken; connected as y2k_. I will take it back as soon as it is free.
* y2k_ is now known as y2k
From IRC: /msg *status enable keepnick and /msg *status get keepnick
Channels
Sticky channels
stickychan
Channels you cannot leave by mistake: xBNC blocks /part and rejoins if you leave.
Setting
Type
Default
Detail
Channels
channels
list
empty
One per line.
Example
#xbnc
#xbnc-dev
If you type /part #xbnc, xBNC does not leave the channel.
From IRC: /msg *status enable stickychan and /msg *status get stickychan
Rejoin after a kick
kickrejoin
Rejoins the channel if you are kicked. Stops trying if you are kicked more than 3 times in a minute.
Setting
Type
Default
Detail
Wait before rejoining (seconds)
delay
number (0–600)
10
Example
* bob has kicked you from #xbnc (test)
* y2k has joined #xbnc
From IRC: /msg *status enable kickrejoin and /msg *status get kickrejoin
Automatic op and voice
autoop
Gives op, halfop or voice to the people you choose when they join your channels (if you have op).
Setting
Type
Default
Detail
Wait before giving the mode (seconds)
delay
number (0–30)
3
People
entries
list
empty
One per line: mode (o, h or v), mask and, optionally, comma-separated channels (or *) and a key. With a key, xBNC sends a challenge and only gives the mode if the other person answers with the same key from their own xBNC.
Example
o *!*@home.example.org #xbnc
v friend!*@* *
o bob!*@* #xbnc shared-key
From IRC: /msg *status enable autoop and /msg *status get autoop
Get op back when left alone
autocyclenew in 1.0
If you are left alone in a channel without op, leaves and joins again to get it. Never in +i or keyed channels.
Setting
Type
Default
Detail
Only in these channels
channels
list
empty
One per line. Empty: in all of them.
Example
* bob has left #xbnc
*statusYou are alone in #xbnc without op: leaving and joining again.
* y2k has joined #xbnc (with op)
From IRC: /msg *status enable autocycle and /msg *status get autocycle
Detached channels
detachnew in 1.0
Channels that keep recording everything but do not appear in your client. They come back if someone mentions you.
From your client: /quote DETACH #channel to detach and /join #channel to see it again. The latest messages are shown when it comes back.
Setting
Type
Default
Detail
Channels
channels
list
empty
One per line. * works (for example #*-bots).
Show the channel if someone mentions my nick
on_mention
yes/no
yes
Show the channel if one of these nicks writes
nicks
list
empty
One per line.
Example
/quote DETACH #xbnc detaches the channel (it keeps recording)
/quote ATTACH #xbnc or /join #xbnc: shows it again
If someone writes your nick in #xbnc, the channel comes back with the latest messages.
From IRC: /msg *status enable detach and /msg *status get detach
Hide flooding channels
flooddetachnew in 1.0
If a channel suddenly fills with messages, it is hidden for a while so your client does not freeze. It keeps recording.
Setting
Type
Default
Detail
Messages
messages
number (3–1000)
25
How many messages…
…in how many seconds
seconds
number (1–600)
10
Quiet seconds before showing it again
calm
number (10–3600)
60
Example
Messages: 25
…in how many seconds: 10
Quiet seconds before showing it again: 60
From IRC: /msg *status enable flooddetach and /msg *status get flooddetach
Messages
Automatic away
awayon by default
Marks you away when you close all your clients and, when you come back, sums up what you missed.
Setting
Type
Default
Detail
Away message
message
text
empty
Empty: “Away” in your language.
Wait before marking you away (seconds)
delay
number (0–3600)
60
When I come back, tell me about private messages and mentions received
summary
yes/no
yes
Nick while you are away
nick
text
empty
Empty: unchanged. {nick} is your nick, for example {nick}
Example
Away message: Back soon
Nick while away: {nick}|away
When you return, *status sums up: “While you were away: 3 private messages (bob, carol) and 2 mentions in #xbnc”.
From IRC: /msg *status enable away and /msg *status get away
Watch words
watchon by default
Copies messages containing what you care about to the *watch conversation, even if you were not connected.
Setting
Type
Default
Detail
Also tell me when someone mentions my nick
mentions
yes/no
no
Patterns
patterns
list
empty
One per line. * matches any text: *deploy* finds “the deploy failed”. You can add a channel or nick after it to narrow it down.
Example
*deploy*
*xbnc* #xbnc
*urgent* bob
Matches arrive in the *watch conversation.
From IRC: /msg *status enable watch and /msg *status get watch
Aliases
aliason by default
Your own commands: you type /ghost bob and xBNC sends /msg NickServ GHOST bob.
Setting
Type
Default
Detail
Aliases
aliases
list
empty
One per line: name and command. $1, $2… are the arguments, $1- all of them from the first, and $nick your nick.
Example
ghost /msg NickServ GHOST $1
op /mode $1 +o $nick
greet /msg $1 hi, $1, how are you?
In your client: /ghost y2k (or /quote ghost y2k if your client does not send it)
From IRC: /msg *status enable alias and /msg *status get alias
Ignore
ignorenew in 1.0
Messages from people you ignore never reach any client or the history. On Undernet it uses SILENCE so they are not even sent.
On IRC: /msg *ignore add nick, /msg *ignore del nick and /msg *ignore list.
Setting
Type
Default
Detail
Ignore these
masks
list
empty
One per line: a nick or a nick!user@host mask (* works).
Use SILENCE when the network allows it
silence
yes/no
yes
Example
/msg *ignore add pest
/msg *ignore add *!*@spam.example
/msg *ignore list
/msg *ignore del pest
From IRC: /msg *status enable ignore and /msg *status get ignore
Remove colours
stripcontrolsnew in 1.0
Removes colours, bold, underline and blinking from messages, also in the history.
Setting
Type
Default
Detail
Only in these channels
channels
list
empty
One per line. Empty: in all of them.
Example
Only in these channels:
#xbnc
Before: \x0304,01red\x03 \x02bold\x02 After: red bold
From IRC: /msg *status enable stripcontrols and /msg *status get stripcontrols
Character encoding
charsetnew in 1.0
Accents show correctly even when a channel uses Latin-1, and you can write in Latin-1 where needed.
xBNC always understands Latin-1 messages that are not UTF-8. This module picks the exact table and the channels or private chats where your messages are sent in that encoding (for people with very old clients).
Setting
Type
Default
Detail
Legacy encoding
legacy
choice
windows-1252
Options: windows-1252 Windows-1252 (the most common), iso-8859-15 ISO-8859-15 (with €), iso-8859-1 ISO-8859-1 (Latin-1).
Send in that encoding to
send_legacy
list
empty
Channels or nicks, one per line. * for all. Empty: always UTF-8.
Example
Legacy encoding: Windows-1252
Send in that encoding to:
#xbnc
grandpa
From IRC: /msg *status enable charset and /msg *status get charset
Message encryption (FiSH)
cryptnew in 1.0
Encrypts your messages in channels and private chats with shared keys, compatible with FiSH for mIRC, HexChat and irssi.
On IRC: /msg *crypt setkey #channel key, /msg *crypt keyx nick to agree a key in private and +p before a message to send it unencrypted. Keys are stored encrypted. FiSH protects from the network's servers; it is not a substitute for end-to-end encryption.
Setting
Type
Default
Detail
Keys
keys
secret list
empty
One per line: channel or nick and key (cbc: first for CBC mode). They are stored encrypted: write all of them again to change them.
Mark for decrypted messages
prefix
text
empty
For example [encrypted] . Empty: no mark.
Accept key exchanges (DH1080)
key_exchange
yes/no
yes
When someone proposes a key in private.
Example
/msg *crypt setkey #xbnc cbc:a-long-key
/msg *crypt keyx bob agree on a key in private (DH1080)
/msg *crypt list
/msg *crypt delkey #xbnc
+p hello sends this message unencrypted
From IRC: /msg *status enable crypt and /msg *status get crypt
Scheduled tasks
schedulenew in 1.0
Commands at a fixed time or every so often, in your time zone.
Pick the time zone in Your account. Tasks only run while the network is connected.
Setting
Type
Default
Detail
Tasks
tasks
list
empty
One per line: time and command (08:00 /away Working), days and time (mon-fri 18:00 /msg #channel bye) or interval (every 30m /msg #channel still here). Days: mon tue wed thu fri sat sun, weekdays, weekend.
Example
mon-fri 08:00 /away Working
mon-fri 15:00 /away
weekend 10:30 /msg #xbnc Good morning!
every 2h /msg #xbnc-dev still here
From IRC: /msg *status enable schedule and /msg *status get schedule
CTCP replies
ctcpon by default
Always answers VERSION (by default with the xBNC version and its web site), answers PING and TIME when no client is connected and stops CTCP floods.
Setting
Type
Default
Detail
CTCP requests allowed every 10 seconds
flood_limit
number (1–100)
5
VERSION reply
version
text
xBNC v{version} - https://xbnc.org
{version} is replaced by the xBNC version. Empty: the default text.
CTCPs to ignore
block
list
empty
One per line, for example TIME or FINGER.
Example
CTCP requests allowed every 10 seconds: 5
Reply to VERSION: mIRC v7.77
CTCP to ignore:
FINGER
TIME
From IRC: /msg *status enable ctcp and /msg *status get ctcp
Hide the MOTD
block_motd
Does not show the server's message of the day to your clients.
Example
No settings. When on, your clients do not receive the server's message of the day.
From IRC: /msg *status enable block_motd and /msg *status get block_motd
History and DCC
Events in the history
eventson by default
Keeps joins, parts, kicks, nick changes, topics and modes next to the messages.
Modern clients get them as real events; the rest as messages from *events when the history is played back.
Setting
Type
Default
Detail
Keep joins, parts and quits
joins
yes/no
yes
In big channels they make a lot of noise.
Keep kicks, nick changes, topics and modes
other
yes/no
yes
Example
With “Store kicks, nick changes, topics and modes” on, when the history is played back
you also see: “bob changed the topic to: Meeting at 20:00”.
From IRC: /msg *status enable events and /msg *status get events
Log files
log
Writes every conversation to daily text files, in the classic IRC log format.
The files stay on the server, in the logs folder next to the database (for example /var/lib/xbnc/logs/user/network/#channel/2026-11-08.log). Times are in your time zone (Your account).
Setting
Type
Default
Detail
Delete files older than (days)
retention_days
number (0–3650)
0
0 keeps them forever.
Include events (joins, parts, kicks…)
events
yes/no
yes
Example
/var/lib/xbnc/logs/y2k/example/#xbnc/2026-11-11.log
[18:30:12] <bob> hello everyone
[18:30:20] * carol has joined
From IRC: /msg *status enable log and /msg *status get log
Replies to whoever asked
route_replieson by default
Replies to WHOIS, WHO, LIST, NAMES or ban lists go only to the device that asked, not to all of them.
Example
If you run /whois bob from your phone, the answer reaches only the phone,
not the laptop that is also connected.
From IRC: /msg *status enable route_replies and /msg *status get route_replies
DCC through xBNC
dcc
DCC file transfers and chats go through xBNC: the other person does not see your IP and they work even behind a router.
xBNC opens a port for each transfer and joins the two connections; nothing is stored on disk. On a server with a public IP it works with no setup; behind NAT, set the public IP in [dcc] public_ip in xbnc.toml and open the [dcc] ports in the firewall.
Setting
Type
Default
Detail
Largest transfer (MB)
max_size_mb
number (0–1000000)
4096
0 = no limit.
Seconds to accept a transfer
wait
number (30–900)
180
Allow transfers from private addresses
private_addresses
yes/no
no
When off, xBNC does not connect to internal networks (10.x, 192.168.x…) even if someone on IRC asks.
Example
# xbnc.toml, only if the server is behind a router (NAT):
[dcc]
public_ip = "203.0.113.10"
ports = "50000-50100"
From IRC: /msg *status enable dcc and /msg *status get dcc
Plugins add features for the whole channel. They run in sandboxed WebAssembly: they cannot read files or see other networks, they have CPU and memory limits, and they only do what their permissions allow, which are shown before installing them. Those that go out to the internet can only connect to approved sites.
The 18 official plugins come installed: xBNC installs the missing ones on the first start and after each update, and updates those with an old version (or the same version with a fix). They stay off on every network. One that a superadministrator uninstalls on purpose does not come back until the next version of xBNC (or until it is installed again from Plugins → Catalogue).
A superadministrator can install others from the remote catalogue or by uploading a .wasm file, and approves the websites of the plugins that go out to the internet (“Sites it may connect to”). The sites of the official ones (link titles, weather and news) come approved, and any of them can be blocked there.
When the official signed catalogue is active, xBNC checks it once a day and updates the installed plugins that have a newer version there (their settings stay). The index signature (Ed25519) and each file's SHA-256 are checked before anything is installed.
Each user turns them on in their networks from Modules, in the Plugins section, and adjusts their settings.
They answer in your xBNC language (or the one of their “Language” setting) and also work with your own messages. The official plugins speak English and Spanish; in another language they answer in English.
Permission
What it allows
send
Send messages and notices.
raw
IRC commands such as KICK, MODE or INVITE. Never QUIT, PASS, USER, NICK, CAP, AUTHENTICATE, OPER, SERVER or SQUIT.
timer
Receive an event every minute (or every 5–60 seconds if the plugin asks for it).
presence
See joins, parts, kicks, nick changes and the user list of the channels.
http
Request https pages, only from the domains it declares (up to 10) and that the superadministrator approves.
Trivia
trivia 1.0.0new in 1.0
A quiz game for your channels, with hints, points and a ranking.
How to use it
In a channel: !trivia to start, !trivia stop, !trivia top (also as !trivial). Answer by writing in the channel. /msg *trivia add Question? | answer adds your own questions; list and del N manage them.
Example
carol!trivia
y2kTrivia starts! 10 questions; answer by writing in the channel.
y2kQuestion 1/10: What is the capital of Japan?
bobtokyo
y2kCorrect, bob! It was “Tokyo”. You have 1 point.
Setting
Default
Detail
Command
trigger
!trivia
Questions per game
rounds
10
Seconds to answer
seconds
40
A hint appears halfway.
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, timer. Help from IRC: /msg *trivia help
Welcome
greet 1.0.0new in 1.0
Greets people who join your channels, with a different message the first time and personal greetings.
How to use it
Automatic. /msg *greet test #channel nick shows what would be said. {nick} and {channel} are replaced in the messages.
Example
* carol has joined #xbnc
y2kWelcome to #xbnc, carol! It's your first time here.
Setting
Default
Detail
First time
first
Welcome to {channel}, {nick}! It's your first time here.
For people who have never been in the channel. {nick} and {channel} are replaced.
When they come back
message
Hi {nick}, welcome back to {channel}.
Empty: returning people are not greeted.
Personal greetings
personal
empty
One per line: nick and message. Replaces the usual one for that person.
Greet privately (notice)
notice
no
Off: the greeting is written in the channel.
Minutes before greeting the same person again
cooldown
30
Never greet
ignore
empty
Nicks, one per line (bots, services).
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, joins and parts. Help from IRC: /msg *greet help
Link titles
urltitle 1.0.0new in 1.0
Shows the title of YouTube, Vimeo, SoundCloud, Dailymotion and Spotify links, Wikipedia articles and GitHub repositories pasted in your channels.
How to use it
Automatic. An administrator can block any of these sites in the panel (Plugins → «Sites it may connect to»).
Example
boblook at this https://www.youtube.com/watch?v=…
y2kYouTube: How to set up an IRC bouncer in 5 minutes
Setting
Default
Detail
Seconds between titles in a channel
cooldown
5
Also for your own links
own
yes
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, web access to approved sites. Help from IRC: /msg *urltitle help
Definitions
factoids 1.0.0new in 1.0
The channel's memory: short answers to frequent questions that you and your editors keep up to date.
How to use it
In a channel: !def word (or ?word), !def word = text, !def -word, !defs. Here: /msg *factoids word.
Example
y2k!def rules = Be respectful and do not flood.
carol?rules
y2krules: Be respectful and do not flood.
Setting
Default
Detail
Command
trigger
!def
Answer ?word too
question_mark
yes
Who else can change definitions
editors
empty
Nicks, one per line. You always can.
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages. Help from IRC: /msg *factoids help
Weather
weather 1.0.0new in 1.0
The weather now and today's forecast for any city, from Open-Meteo (free, no key).
How to use it
In a channel: !weather London (also !tiempo or !clima). Here: /msg *weather Paris.
Example
bob!weather London
y2kLondon (United Kingdom): 14 °C, clear sky, wind 9 km/h, humidity 60 %. Today between 9 and 16 °C.
Setting
Default
Detail
Command
trigger
!weather
Default city
city
empty
Used when no city is written.
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, web access to approved sites. Help from IRC: /msg *weather help
News
news 1.0.0new in 1.0
Posts new entries from RSS and Atom feeds (news sites, blogs, YouTube channels, GitHub releases) in your channels.
How to use it
Set the feeds in the panel: one per line, "#channel https://...". /msg *news list, /msg *news check.
Example
y2k[Hacker News] Show HN: an IRC bouncer written in Rust — https://…
Setting
Default
Detail
Feeds
feeds
empty
One per line: channel and address, for example #xbnc https://hnrss.org/frontpage. Only these sites: YouTube, GitHub, Reddit, Hacker News (hnrss.org), BBC, El País, RTVE, WordPress, Blogspot and Substack.
Minutes between checks
interval
15
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, timer, web access to approved sites. Help from IRC: /msg *news help
Karma
karma 1.0.0new in 1.0
Points between people: nick++ and nick--, with a ranking.
How to use it
In a channel: nick++, nick--, !karma nick, !karma top. Here: /msg *karma nick.
Example
bobcarol++
y2kcarol has 1 karma.
carol!karma top
Setting
Default
Detail
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages. Help from IRC: /msg *karma help
Quotes
quotes 1.0.0new in 1.0
Memorable lines of the channel: save them, find them and pull a random one.
How to use it
In a channel: !quote, !quote 12, !quote search word, !quote add text, !quote del 12 (also as !cita).
Example
bob!quote add today is a great day
y2kQuote 1 saved.
carol!quote 1
y2k#1: today is a great day
Setting
Default
Detail
Command
trigger
!quote
Anybody can add quotes
anyone_adds
yes
Off: only you and the editors.
Editors
editors
empty
Nicks who can add and delete quotes, one per line.
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages. Help from IRC: /msg *quotes help
Forbidden words
badwords 1.0.0new in 1.0
Warns, kicks and finally bans people who write forbidden words in your channels (you need op).
How to use it
Set the words in the panel. /msg *badwords test text tells whether a text would be caught.
Example
carolyou are a dummy
y2kcarol: that word is not allowed here. Next time, kick.
Setting
Default
Detail
Forbidden words
words
empty
One per line. Case and accents do not matter; a * at the end matches the start of a word.
Ban length (minutes)
ban_minutes
10
0: the ban stays.
Kick reason
reason
empty
Warn privately (notice)
warn_private
no
Never act on
exempt
empty
Nicks, one per line.
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, IRC commands (kick, ban), timer. Help from IRC: /msg *badwords help
Games
games 1.0.0new in 1.0
Hangman, magic 8 ball and rock-paper-scissors for your channels.
How to use it
In a channel: !8ball question, !rps rock, !hangman and !g letter (or the whole word) to play.
Example
bob!rps rock
y2krock against scissors: you win, bob!
bob!8ball will it work?
y2kThe 8 ball says: “Ask again later”.
Setting
Default
Detail
Only in these channels
channels
empty
One per line. Empty: in every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages. Help from IRC: /msg *games help
Dice
dice 1.1.0
Rolls dice in channels and private messages: !dado, !dado 2d6, !dado d20.
How to use it
In a channel or private message: !dado (one six-sided die), !dado 2d6, !dado d20. Also !roll and !dice.
/msg *dice 3d8 rolls for you alone.
Example
bob!roll 2d6
y2kbob rolls 2 6-sided dice: 3 and 5 (total 8).
Setting
Default
Detail
Extra command
trigger
!roll
!dado, !dados, !roll and !dice always work.
Most dice per roll
max_dice
10
Answer in private messages
in_queries
yes
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages. Help from IRC: /msg *dice help
Polls
poll 1.1.0
!poll Question? | option | option, then !vote N. Closes on its own and announces the winner.
How to use it
In a channel: !poll Pizza or sushi? | pizza | sushi (up to 10 options) — vote with !vote 1 — !poll shows the count — !poll end closes it (who started it, or you). It closes on its own after the minutes in the settings.
Example
carol!poll Coffee or tea? | coffee | tea
bob!vote 2
*pollVote recorded in #xbnc: 2) tea. You can change it by voting again.
Setting
Default
Detail
Command
trigger
!poll
Vote command
vote_trigger
!vote
Minutes until it closes
minutes
60
Other people can start polls
public
yes
Off: only you start them; everyone can vote.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, timer. Help from IRC: /msg *poll help
Reminders
remind 1.1.0
Reminds you (or anyone in the channel) after a while or at a time: !remind 10m take the pizza out, !remind 18:30 meeting.
How to use it
In a channel: !remind 10m take the pizza out — !remind 2 hours call Bob — !remind 1h30m … — !remind 18:30 meeting — !remind list — !remind clear. Also !recuerda.
/msg *remind 10m … reminds you privately. Reminders are checked every minute.
Example
bob!remind in 10 minutes take the pizza out
y2kbob: OK, I will remind you in 10 minutes.
y2kbob: take the pizza out
Setting
Default
Detail
Extra command
trigger
!remind
!remind and !recuerda always work.
Other people can set reminders
public
yes
Off: only your own and /msg *remind.
Pending reminders per person
max_per_nick
10
Time zone for times like 18:30
timezone
Europe/Madrid
Europe/Madrid, Europe/London, UTC or a difference such as +1.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, timer. Help from IRC: /msg *remind help
Tell
tell 1.1.0
!tell nick message: delivers it in the channel when that person speaks or joins.
How to use it
In a channel: !tell bob the build is fixed — bob gets it in the channel as soon as he writes something or joins. Works for you and for anyone in the channel.
Example
y2k!tell carol the build is fixed
y2ky2k: OK, I will tell carol as soon as she speaks or joins the channel.
* carol has joined #xbnc
y2kcarol: y2k left you a message 5 minutes ago: the build is fixed
Setting
Default
Detail
Command
trigger
!tell
Deliver when they join
on_join
yes
Off: only when they write something.
Messages waiting per person
max_per_nick
5
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, joins and parts. Help from IRC: /msg *tell help
Autoresponder
autoresponder 1.1.0
Answers on its own when someone writes a keyword, and (optionally) private messages while you are away.
How to use it
Write the rules in the settings, one per line: keyword = answer. {nick} is who wrote and {channel} the channel. The rule * = text answers any private message.
/msg *autoresponder shows the rules; /msg *autoresponder test <text> tries them.
Example
bobhi, anyone?
y2kHi bob! I am not here right now, leave me your message.
Setting
Default
Detail
Rules
rules
empty
One per line: keyword = answer. Example: hola = Hello {nick}! — * = answer to any private message.
Seconds before the same rule answers again
cooldown
60
Also answer private messages
in_queries
yes
Only when no client is connected
only_when_away
no
So it answers for you while you are away.
Only in these channels
channels
empty
One per line. Empty: every channel.
Language of the messages
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages. Help from IRC: /msg *autoresponder help
Channel stats
chanstats 1.1.0
!stats: messages in the channel and who talks most. !stats nick: one person's count.
How to use it
In a channel: !stats shows the messages and who talks most — !stats bob shows one person. /msg *chanstats #channel shows it to you privately. Counts are saved every minute.
Example
bob!stats
y2k#xbnc: 1204 messages since 3 Nov 2026. Most active: carol 312, bob 280, y2k 199.
Setting
Default
Detail
Command
trigger
!stats
People in the ranking
top
5
Answer other people
public
yes
Off: only your own !stats.
Only these channels
channels
empty
One per line. Empty: every channel.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, timer. Help from IRC: /msg *chanstats help
Seen
seen 2.1.0
!seen nick: when someone was last seen and what they were doing, or which channels they are in right now.
How to use it
In a channel: !seen bob — when bob was last seen and whether he is here now. /msg *seen bob, or /msg *seen stats.
Example
bob!seen carol
y2kcarol was last seen 2 hours ago, in #xbnc saying “off to dinner”.
Setting
Default
Detail
Command
trigger
!seen
What people write before the nick.
Answer other people in channels
public
yes
Off: only answers you (your own !seen and /msg *seen).
Seconds between answers in a channel
cooldown
5
Show what they last said
show_text
yes
Off: only says where and when.
Answer only in these channels
channels
empty
One per line. Empty: in every channel. Activity is recorded in all of them.
Language of the answers
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: send messages, joins and parts. Help from IRC: /msg *seen help
Anti-flood
antiflood 1.1.0
Warns, kicks or bans people who flood or repeat lines in your channels (you must be a channel operator).
How to use it
Works by itself in the channels you list in the settings (you must be a channel operator there). /msg *antiflood shows its settings.
Example
spama
spama
spama
* spam was kicked from #xbnc by y2k (flood)
Setting
Default
Detail
Channels to protect
channels
empty
One per line. It does nothing until you list some.
Most lines allowed
lines
5
In this many seconds
seconds
4
Same line repeated
repeats
3
Times in a row; 0 turns it off.
What to do
action
kick
warn (warn first, kick the second time), kick or ban.
Ban length in minutes
ban_minutes
10
0: the ban is not lifted.
Kick reason
reason
empty
Never act on these nicks
exempt
empty
One per line.
Language of the messages
lang
empty
Empty: your language in xBNC. Or es / en.
Permissions: IRC commands (kick, ban), send messages, timer. Help from IRC: /msg *antiflood help