CVNBot

CVNBot (previously known as SWMTBot) is the main IRC bot software used by the Countervandalism Network to interpret recent changes streams and provide a feed on IRC for patrollers to work from.

Lists

All global lists are automatically synchronised across the bots in the network (through the broadcast channel). Local lists are stored in the local database only. There is a global article watchlist for all wikis, and one for each one; you can add/delete/show items on the global list by leaving out the "p=" parameter (see the command lists below for more information).

Global lists

Bad new usernames (BNU)
Bad new article titles (BNA)
Bad edit summaries (BES)
User whitelist (WL)
User blacklist (BL)
User greylist (GL)
Global article watchlist (CVP)

Local per-wiki lists

Lists of admins (AL)
Lists of bots (BOTS)
Article watchlists (CVP)

Commands

Only voiced users (aka +) can use these commands, with the exception of control commands which are restricted to operators only (aka @).

Special parameters

The duration is measured in number of hours. x=24 will make the entry active for 24 hours (1 day). In all list commands a duration value of 0 is used to indicate that the entry should be active indefinitely (until it is changed or removed). Otherwise the entry will expire (removed from the database) after the set duration.

The default duration is 0 for all lists, except for blacklist where the entries expire after a duration of 744 hours by default (31 days). A common value is x=9000 which corresponds to approximately 1 year (9000 hours is 375 days, is 1.02 years).

For regex parameters, if you do not know what regex means, don't use regex commands. It could potentially cause of a lot of problems in the network by using it wrong, because commands that use regex can easily trigger an automatic greylisting of thousands of accounts and IP addresses at once and thus flood patroller's channels.

Info commands

Command	Description	Example
status	When the last message was received from the source.	`SampleBot status`
config	Version of the bot and the currently loaded configuration (2 lines).	`SampleBot configSampleBot settingsSampleBot version`
bleep wikiname	Finds out which bot monitors a particular project. You can issue this command to any networked bot to receive the same results.	`SampleBot bleep en.wikipedia`
count	Finds out how many wikis each bot monitors, and each bot's version. You can issue this command to any networked bot to receive the same results.	`SampleBot count`
list	Returns a list of all currently monitored wikis.	`SampleBot list`
help	Link to this documentation page.	`SampleBot help`

List commands

Command	Description	Example
bl action username [x=duration] [r=reason]	Add (`add`), delete (`del`), or show (`show`) an item on the global blacklist. Set x=0 to make indefinite.	`SampleBot bl add 80.10.20.123` `SampleBot bl del MrVandal` `SampleBot bl add MrVandal r=Vandal on nl.wikipedia`
gl del username	Delete an item from the (global) greylist.	`SampleBot gl del MrVandal`
wl action username [x=duration] [r=reason]	Add, delete, or show an item on the global whitelist.	Same as `bl`
al action username p=wikiname [x=duration] [r=reason]	Add, delete, or show an item on the admin list for a particular wiki.	`SampleBot al add MrGood p=en.wikipedia`
bots action username p=wikiname [x=duration] [r=reason]	Add, delete, or show an item on the bot list for a particular wiki.	Same as `al`
cvp add/del/show pagetitle [p=wikiname] [x=duration] [r=reason]	Add, delete, or check a page on the watchlist. Use without `p=` for the global watchlist over all wikis. The default duration is `x=0`, for indefinite.	`SampleBot cvp add Main Page` `SampleBot cvp add Main Page x=24` `SampleBot cvp add Main Page p=en.wikipedia` `SampleBot cvp add Main Page p=en.wikipedia x=24` `SampleBot cvp show Main Page` `SampleBot cvp show Main Page p=en.wikipedia` `SampleBot cvp del Main Page` `SampleBot cvp del Main Page p=en.wikipedia`
bnu add/del/show regex [x=duration] [r=reason]	Add, delete, or check a "Bad New Username" pattern (regex). These are always global. The default duration is `x=0`, for indefinite.	`SampleBot bnu add Sh.t r=Watch account creation like Shat, or Shot.` `SampleBot bnu add Sh.?t r=Watch account creation like Sht, Shat, or Shot.` `SampleBot bnu add Sh.*t r=Watch account creation like Sht, Shalalit, or Shower Kit.` `SampleBot bnu show Sh.it` `SampleBot bnu del Sh.it`
bna add/del/show regex [x=duration] [r=reason]	Add, delete, or check a "Bad New Article" pattern (regex). These are always global. The default duration is `x=0`, for indefinite.	`SampleBot bna add Sh.t r=Watch page creation like Shat, or Shot.` `SampleBot bna add Sh.?t r=Watch page creation like Sht, Shat, or Shot.` `SampleBot bna add Sh.*t r=Watch page creation like Sht, Shalalit, or Shower Kit.` `SampleBot bna show Sh.it` `SampleBot bna del Sh.it`
bes add/del/show regex [x=duration] [r=reason]	Add, delete, or check a "Bad Edit Summary" pattern (regex). These are always global. The default duration is `x=0`, for indefinite.	`SampleBot bes add Sh.t r=Watch edits with summary like Shat, or Shot.` `SampleBot bes add Sh.?t r=Watch edits with summary like Sht, Shat, or Shot.` `SampleBot bes add Sh.*t r=Watch edits with summary like Sht, Shalalit, or Shower Kit.` `SampleBot bes show Sh.it` `SampleBot bes del Sh.it`
intel username	Shows the item on the list (listname, adder, duration and reason) if it's listed somewhere.	SampleBot intel ZooFari (ZooFari is on commons.wikimedia admin list, added by SampleBot until the end of time ("Auto-download from wiki")) SampleBot intel Krinkle (Krinkle is on global whitelist, added by ZooFari until the end of time ("trusted"))

Control commands

Command	Description	Example
quit	Quits the bot	`SampleBot quit`
restart	Restarts the bot	`SampleBot restart`
load wikiname [interwiki]	Add a wiki to the monitor.	`SampleBot load en.wikipedia` `SampleBot load meta.wikimedia m:` `SampleBot load nl.wikimedia nl:chapter:` `SampleBot load sv.wikiquote q:sv:`
drop wikiname	Stop monitoring a wiki.	`SampleBot drop en.wikipedia`
purge wikiname	Removes all user list information in the database pertaining to this wiki.	`SampleBot purge en.wikipedia`
msgs	Rebuilds message cache from the `Console.msgs` file. Only necessary when the file has changed. This automatically hapends on restart, so only use it if the messages file has changed while the bot is running without, and want the bot to start using the new version without restarting it.	`SampleBot msgs`
reload wikiname	Rebuilds wiki cache from the wiki over HTTP. Use this if any of the log entry message templates have changed (either by MediaWiki software update or due to a local override by the wiki administrators).	`SampleBot reload en.wikipedia`
batchreload	Performs the `reload` command for all currently monitored wikis. Fairly resource-intensive and thoroughly not recommended.	`SampleBot batchreload`
getadmins wikiname	Downloads a list of admins from the specified project and automatically adds it to the CVNBot database.	`SampleBot getadmins en.wikipedia`
getbots wikiname	Downloads a list of flagged bots from the specified project and automatically adds it to the CVNBot database.	`SampleBot getbots en.wikipedia`
batchgetusers	Performs `getadmins` and `getbots` for all currently monitored wikis.	`SampleBot batchgetusers`