Skip to content

Add section to faq describing bots, bouncers, and bridges #330

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
May 2, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions content/_guides/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -211,6 +211,41 @@ This is explicitly
You can find other networks which may be ok with these activities on
[netsplit.de](https://netsplit.de).

## What is meant by "bot", "bouncer", or "bridge"?

Bots, bouncers, and bridges are different types of client applications that
connect to the IRC network. Sometimes these clients match multiple of the
following definitions.

A **bot** is a utility client that provides automated responses to private
input or channel activity from others connected to the network.

Some bots can roam around the network without being piloted. Roaming bots
can be a big problem and are generally not allowed on Libera.Chat. You
*must* ask staff before deploying them.

A **bouncer** connects to the network on behalf of one or more clients. The
bouncer acts like both a server and a client; a client app would act like
it is a network, and a network's server would act like it is a client.

Both people and bots can connect through bouncers. Users of a bouncer can
roam around the network. They can join and leave channels, send private
messages to other users, and authenticate to network services.

Bouncers do not explicitly connect channels together. Each user on a bouncer
has their own puppeted client connected on the IRC network.

A **bridge** does explicitly connect a channel to another, and relays the
conversation and actions in each channel to the other one. In general, these
channels or rooms are on different networks and sometimes on different
protocols. IRC can be connected to IRC, or IRC can be connected to Discord,
Telegram, Matrix, XMPP, etc.

Bridging can either connect one client to represent multiple people, or one
client per participant. Most per-participant connections of bridges cannot
roam around the network and are confined to the channel that has been
connected. Additionally, some bridges also have the bouncer abilities available.

## Are bots allowed?

Users may run bots that connect to Libera.Chat. Please get permission from the
Expand Down
Loading