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
[edit]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
[edit]- 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
[edit]- Lists of admins (AL)
- Lists of bots (BOTS)
- Article watchlists (CVP)
Commands
[edit]Only voiced users (aka +) can use these commands, with the exception of control commands which are restricted to operators only (aka @).
Special parameters
[edit]The duration is measured in number of hours, between 1 and 9999 (at most 4 digits). 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 2160 hours by default (90 days). A common value is x=9000 which corresponds to approximately 1 year (9000 hours is 375 days, or 1.02 years), and is close to the maximum definitive duration of 9999 (416 days). To keep an entry longer, use 0 instead.
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
[edit]| 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
[edit]| 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
|
| 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
|
| 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.
|
| 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.
|
| 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.
|
| 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
[edit]| 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
|
| 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
|