README.md

Community-supported Xtheme Modules

This directory contains modules that are not included in the main modules
folders for one reason or another. Either their code is a bit ugly, their
functionality is frowned upon, they only work with a limited number of IRCd's
or similar cases.

Building other modules not included in this distribution

Just drop the file in here, and it will be built/installed.

Alternatively just to build a single module, use the $SRCS
make variable to build and install modules.

Adding additional modules here

Any modules you want to add can be considered for inclusion here by sending us
a pull request on GitHub.

Incomplete list of modules

cs_babbler.c

Repeats what others users in a channel say back to a specific
user. Useful for users that claim they have entire channels on
ignore.

cs_badwords.c

Takes actions against users (KICK, BAN, KICKBAN or QUIET) for
using badwords in channel, specified on a per-channel basis
with the BADWORDS command. Be aware it will check every message
sent to channels that BLOCKBADWORDS is set on so it can be a bit
CPU-heavy.

cs_kickdots.c

Kicks users from a channel when kickdots metadata is set on
that channel and users send a line containing only "...".
Deprecated by cs_badwords (/cs badwords #channel add ... kick).

cs_ping.c

Responds to users that ping ChanServ with "Pong!".

cs_regmode.c

Sets the pointless DALNet-style +/-r mode when a channel
is registered or dropped. NOT RECOMMENDED TO USE.

cs_regnotice.c

Sends a user a notice with some information specified in a
regnotice {} block inside the chanserv {} block of your
xtheme.conf when the user registers a channel.

cs_updown.c

Either gives or removes all your channel status modes at once.

cs_userinfo.c

Display a message when a user joins a channel. You must be able
to edit the channel access list to add or remove a userinfo entry.

gen_echoserver.c

A small sample echoserver using the connection_t framework (deprecated).
NOT RECOMMENDED TO USE.

gen_httpd.c

A small sample httpd for serving files. It is highly recommended to use
misc/httpd.c instead.

gen_listenerdemo.c

Demonstrates how to use listeners using the connection_t framework (deprecated).
NOT RECOMMENDED TO USE.

gen_vhostonreg.c

Assigns a $account.hidehostsuffix vhost to all users upon
account registration. $account will be replaced by the users'
accountname and hidehostsuffix is that config option from the
serverinfo {} block of your xtheme.conf.

graphtastical.c

Graphs user->channel relationships. Not recommended to use if
there are privacy concerns.

gs_roulette.c

A nice GameServ game of Russian Roulette.

ircd_catserv.c

Little module showing a CatServ Services client, pretty much all modular
services since forever implement this as an example, so we do too.

ircd_announceserv.c

A services bot which allows users to request network
announcements that will then (when approved by a soper)
be sent to all users on the network. This is seperate
from InfoServ so that users can easily ignore users'
announcements but won't miss any important announcements
from network staff.

ircd_loveserv.c

A services bot for sending love-related items to other users.
NOT COMPILED BY DEFAULT.