xBNC Wiki — The Next Generation of IRC Bouncers Wiki v1.0.0

Wiki Features

Features

The 24 native modules and the 18 official plugins, with every setting and an example of each.

Modules

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.

SettingTypeDefaultDetail
Service
service
choiceautoOptions: auto Automatic, by network, x X (Undernet), nickserv NickServ (Libera, Rizon, EvilNet…), q Q (QuakeNet), authserv AuthServ (GameSurge, AfterNet).
Account
account
textemptyYour account name on the service. With NickServ it can be empty if it is your nick.
Password
password
secretempty
Hide my IP (mode +x)
hide_host
yes/noyesOn X, Q and AuthServ. Other networks do it themselves.
Log in while connecting (Login on Connect)
login_on_connect
yes/noyesUndernet only: the real IP is never shown.
Wait before joining channels (seconds)
wait
number (0–120)15Until 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/noyesWith 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.

SettingTypeDefaultDetail
Channel service
service
choiceautoOptions: auto Automatic, by network, x X (Undernet), chanserv ChanServ, q Q (QuakeNet).
Ask to remove my ban
unban
yes/noyes
Join when invited to one of my channels
join_invites
yes/noyes
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.

SettingTypeDefaultDetail
Use SASL EXTERNAL if the network offers it
sasl_external
yes/noyes
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.

SettingTypeDefaultDetail
Channels
channels
listemptyOne 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.

SettingTypeDefaultDetail
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).

SettingTypeDefaultDetail
Wait before giving the mode (seconds)
delay
number (0–30)3
People
entries
listemptyOne 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.

SettingTypeDefaultDetail
Only in these channels
channels
listemptyOne 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.

SettingTypeDefaultDetail
Channels
channels
listemptyOne per line. * works (for example #*-bots).
Show the channel if someone mentions my nick
on_mention
yes/noyes
Show the channel if one of these nicks writes
nicks
listemptyOne 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.

SettingTypeDefaultDetail
Messages
messages
number (3–1000)25How 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.

SettingTypeDefaultDetail
Away message
message
textemptyEmpty: “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/noyes
Nick while you are away
nick
textemptyEmpty: 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.

SettingTypeDefaultDetail
Also tell me when someone mentions my nick
mentions
yes/nono
Patterns
patterns
listemptyOne 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.

SettingTypeDefaultDetail
Aliases
aliases
listemptyOne 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.

SettingTypeDefaultDetail
Ignore these
masks
listemptyOne per line: a nick or a nick!user@host mask (* works).
Use SILENCE when the network allows it
silence
yes/noyes
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.

SettingTypeDefaultDetail
Only in these channels
channels
listemptyOne 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).

SettingTypeDefaultDetail
Legacy encoding
legacy
choicewindows-1252Options: 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
listemptyChannels 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.

SettingTypeDefaultDetail
Keys
keys
secret listemptyOne 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
textemptyFor example [encrypted] . Empty: no mark.
Accept key exchanges (DH1080)
key_exchange
yes/noyesWhen 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.

SettingTypeDefaultDetail
Tasks
tasks
listemptyOne 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.

SettingTypeDefaultDetail
CTCP requests allowed every 10 seconds
flood_limit
number (1–100)5
VERSION reply
version
textxBNC v{version} - https://xbnc.org{version} is replaced by the xBNC version. Empty: the default text.
CTCPs to ignore
block
listemptyOne 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.

SettingTypeDefaultDetail
Keep joins, parts and quits
joins
yes/noyesIn big channels they make a lot of noise.
Keep kicks, nick changes, topics and modes
other
yes/noyes
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).

SettingTypeDefaultDetail
Delete files older than (days)
retention_days
number (0–3650)00 keeps them forever.
Include events (joins, parts, kicks…)
events
yes/noyes
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.

SettingTypeDefaultDetail
Largest transfer (MB)
max_size_mb
number (0–1000000)40960 = no limit.
Seconds to accept a transfer
wait
number (30–900)180
Allow transfers from private addresses
private_addresses
yes/nonoWhen 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

Always on

Core features that need no turning on.

FeatureWhere it is configured
Commands on connectIn each network's configuration.
Remember channelsAlways on: your /join and /part are remembered.
SASL and NickServIn each network's configuration.
Brute-force blockingIn Settings and Security.
NotesIn Your account or with /msg *notes.
Last seenIn Users and with /msg *status seen.
Per-device historyAlways on, with search on every network.
Web and IRC administrationThis panel and /msg *status.

Plugins

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.

  1. 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).
  2. 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.
  3. 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.
  4. Each user turns them on in their networks from Modules, in the Plugins section, and adjusts their settings.
  5. 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.
PermissionWhat it allows
sendSend messages and notices.
rawIRC commands such as KICK, MODE or INVITE. Never QUIT, PASS, USER, NICK, CAP, AUTHENTICATE, OPER, SERVER or SQUIT.
timerReceive an event every minute (or every 5–60 seconds if the plugin asks for it).
presenceSee joins, parts, kicks, nick changes and the user list of the channels.
httpRequest 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.
SettingDefaultDetail
Command
trigger
!trivia
Questions per game
rounds
10
Seconds to answer
seconds
40A hint appears halfway.
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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.
SettingDefaultDetail
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
emptyOne per line: nick and message. Replaces the usual one for that person.
Greet privately (notice)
notice
noOff: the greeting is written in the channel.
Minutes before greeting the same person again
cooldown
30
Never greet
ignore
emptyNicks, one per line (bots, services).
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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
SettingDefaultDetail
Seconds between titles in a channel
cooldown
5
Also for your own links
own
yes
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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.
SettingDefaultDetail
Command
trigger
!def
Answer ?word too
question_mark
yes
Who else can change definitions
editors
emptyNicks, one per line. You always can.
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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.
SettingDefaultDetail
Command
trigger
!weather
Default city
city
emptyUsed when no city is written.
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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://…
SettingDefaultDetail
Feeds
feeds
emptyOne 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
emptyEmpty: 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
SettingDefaultDetail
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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
SettingDefaultDetail
Command
trigger
!quote
Anybody can add quotes
anyone_adds
yesOff: only you and the editors.
Editors
editors
emptyNicks who can add and delete quotes, one per line.
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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.
SettingDefaultDetail
Forbidden words
words
emptyOne per line. Case and accents do not matter; a * at the end matches the start of a word.
Ban length (minutes)
ban_minutes
100: the ban stays.
Kick reason
reason
empty
Warn privately (notice)
warn_private
no
Never act on
exempt
emptyNicks, one per line.
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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”.
SettingDefaultDetail
Only in these channels
channels
emptyOne per line. Empty: in every channel.
Language of the answers
lang
emptyEmpty: 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).
SettingDefaultDetail
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
emptyEmpty: 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.
SettingDefaultDetail
Command
trigger
!poll
Vote command
vote_trigger
!vote
Minutes until it closes
minutes
60
Other people can start polls
public
yesOff: only you start them; everyone can vote.
Language of the answers
lang
emptyEmpty: 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
SettingDefaultDetail
Extra command
trigger
!remind!remind and !recuerda always work.
Other people can set reminders
public
yesOff: only your own and /msg *remind.
Pending reminders per person
max_per_nick
10
Time zone for times like 18:30
timezone
Europe/MadridEurope/Madrid, Europe/London, UTC or a difference such as +1.
Language of the answers
lang
emptyEmpty: 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
SettingDefaultDetail
Command
trigger
!tell
Deliver when they join
on_join
yesOff: only when they write something.
Messages waiting per person
max_per_nick
5
Language of the answers
lang
emptyEmpty: 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.
SettingDefaultDetail
Rules
rules
emptyOne 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
noSo it answers for you while you are away.
Only in these channels
channels
emptyOne per line. Empty: every channel.
Language of the messages
lang
emptyEmpty: 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.
SettingDefaultDetail
Command
trigger
!stats
People in the ranking
top
5
Answer other people
public
yesOff: only your own !stats.
Only these channels
channels
emptyOne per line. Empty: every channel.
Language of the answers
lang
emptyEmpty: 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”.
SettingDefaultDetail
Command
trigger
!seenWhat people write before the nick.
Answer other people in channels
public
yesOff: only answers you (your own !seen and /msg *seen).
Seconds between answers in a channel
cooldown
5
Show what they last said
show_text
yesOff: only says where and when.
Answer only in these channels
channels
emptyOne per line. Empty: in every channel. Activity is recorded in all of them.
Language of the answers
lang
emptyEmpty: 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)
SettingDefaultDetail
Channels to protect
channels
emptyOne per line. It does nothing until you list some.
Most lines allowed
lines
5
In this many seconds
seconds
4
Same line repeated
repeats
3Times in a row; 0 turns it off.
What to do
action
kickwarn (warn first, kick the second time), kick or ban.
Ban length in minutes
ban_minutes
100: the ban is not lifted.
Kick reason
reason
empty
Never act on these nicks
exempt
emptyOne per line.
Language of the messages
lang
emptyEmpty: your language in xBNC. Or es / en.

Permissions: IRC commands (kick, ban), send messages, timer. Help from IRC: /msg *antiflood help