User:Void-bot/Help

A full list of commands that Void-bot will listen to on IRC and the conditions needed for them to work. All commands can be used by Void whenever he so chooses to use them.

General commands

 * These commands can be used by anyone in any channel
 * $help - provides a link to this page
 * $part - makes the bot leave the current channel (this is logged, so don't think about abusing it)
 * $part <#channel> - makes the bot leave the current channel if it is equal to the channel provided (this will make more sense later) (this too is logged)

Op requirement

 * These commands require that the user is opped in the channel that the command is used in
 * $voice list - (requires that the current channel is being maintained by Void-bot) makes Void-bot display the current list of users who should have voice
 * $voice add - (requires that the current channel is being maintained by Void-bot) adds to the voice list. will be voiced once they join the channel
 * $voice remove - (requires that the current channel is being maintained by Void-bot) removes the nick from the voice list if it was on the list
 * $maintain-off - (requires that the current channel is being maintained by Void-bot) Void-bot will no longer maintain the current channel

Voice requirement

 * These commands require that the user is voiced in the channel that the command is used in
 * $log - writes into a file on Void's computer (Why would you use this? (Hold on, this will make sense later too))

Channel specific commands

 * These commands must be used in a specific channel to have an effect. They may have additional requirements

#miraheze-cvt

 * $log - requires voice; writes into a file on Void's computer and a page on cvtwiki

##voidwalker

 * The development channel where weird things can and will happen.
 * $kill - requires op; disconnects Void-bot from the IRC network
 * $nick - requires voice; changes the nick of Void|bot
 * $join <#channel> - requires voice; makes Void-bot join the specified channel
 * $part <#channel> - requires voice; makes Void-bot part from the specified channel
 * $log - requires voice; writes into a file on Void's computer and a page on a wiki
 * $status - Void-bot will respond by telling you if you are an op, have voice, or nothing
 * $maintain <#channel> - requires op makes Void-bot join #channel and maintain the voiced users
 * $maintain-off - requires op Void-bot will no longer maintain the channel it is currently maintaining

Maintain feature
Void-bot can be used to easily maintain a list of voiced users in a channel without needing to set +V flags for users with ChanServ. This feature needs to be enabled by an opped user in ##voidwalker. This feature can only be enabled on one channel at a time due to current limitations. Once the command is passed in the form of $maintain #channel, Void-bot will join #channel and fetch the current voiced users and add them to a list. You can add users to the voice list by using $voice add, or by giving the nick voice. Be aware that when using $voice add, Void-bot will not voice the user until they join the channel, even if they are present when they are added to the list. Users can only be removed from the list through the use of $voice remove. Void-bot will not remove users from this list if their voice is removed. Whenever a user joins the maintained channel, it checks their nick against the list, and if they need voice, it grants them voice by using the command MSG CHANSERV VOICE . This means that Void-bot must have +v with ChanServ (since Void-bot logs in with Void's credentials, this can be used in any channel where Voidwalker is on the access list). This may be subject to change later, but it's easier to do this for now.