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

See also

• Countervandalism Network/Bots
• Source code
• Issue tracker