List of IRC bot commands

TripBot Commands

All commands prefaced with ~

There's also a web interface at http://nourishedcloud.com:1337/

User commands

• Reports
  • ~report [#channel] [username] [reason for reporting]
    • Report a user in a channel for a reason. This command can either be run publicly in a channel or anonymously in a PM to the bot. The result of using this command will be that all of the users which are currently marked as operators in the reporting channel will receive a PM telling them a user has been reported, by whom, in which channel and why. If there is an administrative channel for the reporting channel (e.g. ##channel), the report will be posted there as well.

• Quotes
  • ~qadd [category] = [quote]
    • Add a new quote to the database.
  • ~q [category]
    • Display a random quote from a given category.
  • ~rq
    • Show a random quote from the database.
  • ~title [category]
    • Use this command to get a URL to the indicated quote category
  • ~qsearch [category] = [needle]
    • Search a category for quotes including the given text.
  • ~qcount [category]
    • Show the number of quotes stored in the given category, or if called without a category it will show the total number of quotes in the database.

• Entertainment
  • ~ri
    • Generate a random imgur image and post a link to it in the channel.
  • ~flashy [color] [message]
    • Give a link to a page hosted by the flashy module which produces big flashing text in the given colour.
  • ~ud [headword]
    • Returns the first Urban Dictionary definition for the headword provided.
    • Note: If tripbot does not find a quote when you use ~category it will search UD.
  • ~xkcd
    • Returns a link to the xkcd comic specified, or the latest one if a comic is not given. Use '*' to return a link to a random comic.
  • ~lincent[user]
    • generates output similar to this: n8wacht is responsible for 0.16% (1,129) messages in #drugs since Sat, 16th March 2013~
  • ~loudest
    • displays a list of users who have chatted the most
  • ~last[user]
    • when was a user last seen?

• Utility
  • ~usage [command]
    • Show usage information for a given command.
  • ~help [command|module]
    • Link module help for a module given either the module name or the name of a command belonging to a module.
  • ~js [code]
    • For regular users, there is the ~js command, which is completely sandboxed, but can still be used for calculation and the like.
  • Spelling Corrections
    • Allows you to run regex replaces on both your own and others messages. One may run a regex on their own last message like so:
    • > user: I like turtles
    • > user: s/turtles/pizza/
    • One may run a regex on another user's last message simple by highlighting the nick before the pattern:
    • > batman: I like TURTLES
    • > user: batman: s/turtles/pizza/i
  • ~ignore [module]
    • Ignore a given module. If the user does not specify a module, or provides an invalid one a list of modules which are available to ignore will be given.
    • Modules you can ignore are: spotify, github, js, link, quotes, report, spelling, poll, regex, youare, kick.
    • Example: Say ~ignore spelling to not have tripbot correct your spelling for you.
  • ~unignore [module]
    • Unignore a previously ignored module. If the user does not specify a module, or provides an invalid choice a list of modules which are currently ignored will be given.

• Polls
  • ~newpoll [pollname] options=[each,poll,option] [Poll Description]
    • Creates a new poll with the given name, options and descriptions. From this point people will be able to use the ~vote command to cast their vote in the poll.
  • ~addoption [pollname] [newoption]
    • Using this command you can add a given option to a poll you are the creator of.
  • ~rmoption [pollname] [optiontoremove]
    • Using this command you can remove a given option from a poll you are the creator of.
  • ~vote [pollname] [option]
    • Cast your vote for the given option in the given poll. If you have already cast your vote in the given poll, your vote will be changed to the new option you have provided.
  • ~pdesc [pollname]
    • Show the full description for a given poll name along with its available voting options.

Moderators

• Kick and banning (should be used in this order)
  • ~notify [#channel] [message]
    • Notify staff of a channel of a message. This can be run in either PM or in the channel. If notifyVoice is set, voiced users will also receive notifications.
  • ~warn USER
    • This will add a warning to the user and show a link to all warnings of that user in #tripsit.me
    • No ~unwarn command yet so add warnings carefully
  • ~ckick [#channel] [username] [reason]
    • Kick a user from a channel.
  • ~kickcount [username]
    • Show the number of times a given user has been kicked and has kicked other people.
  • ~kickstats
    • Show a list of top kickers and kickees.
  • ~cban [#channel] [username] [reason]
    • Ban a user from a channel.
  • ~nban {optional: Duration in Hours} [username] [reason]
    • Ban a user from the network
    • Only used by mods and admins
    • Make sure other staff members agree with your actions
  • ~nunban [username] [reason]
    • Unban a user from the network.

• User management
  • ~alias [user]
    • If an alias is provided, this command will return the primary user for which this is an alias for. If a primary user is provided, it will return a confirmation of this fact and a count of how many aliases belong to the user.
  • ~setaliasparent [newparent]
    • Set a nick which is currently serving as an alias to the primary user, while setting what was previously the primary user as an alias of the new primary user. Requires moderator level access by default.
  • ~mergeusers [primaryuser] [secondaryuser]
    • This command merges two nicks which are recorded as primary users into one user. The secondary user and all of their aliases will be merged under primaryuser. Requires moderator level access by default.
  • ~ban [user] [command]
    • Ban a user from using a command. Command may be replaced with '*,' which will ban a user from use of all commands. Users banned from all commands will still be subject to module listeners.
  • ~unban [user] [command]
    • Unban a user from using a given command. If a user was previously banned using the '*' wildcard, they may also be unbanned from such by replacing command with an asterisk here as well.

• Utilities
  • ~say [#channel] [message]
    • Have DBot post the given message in the given channel (uses the server from which you are sending the message). You may replace channel with '@' to have him post the message in the current channel. Channel may also be replaced with a nick on the server.

• Quote Management
  • ~rmlast [category]
    • Remove the last quote added to a given category.
  • ~rmstatus
    • Show how many quotes are currently in the removal cache, and whether they will be randomly removed.
  • ~rm [category] = [quote]
    • Remove a given quote from the given category.
  • List of quotes to be deleted: http://nourishedcloud.com:1337/quoteremovals
  • ~rmconfirm
    • Confirm that the quotes currently in the removal cache are okay to be removed, and permanently delete them.
  • ~rmdeny
    • Re-instate the quotes that are currently in the removal cache back into the main quote database.

• Tripbot Management
  • join [#channel]
    • Join the given channel.
  • part [#channel]
    • Leave the given channel.
  • opme [#channel]
    • Gives the caller ops in a given channel if possible. If called without a channel, it will attempt to give the caller ops in the current channel.

Admin Commands (Reality only)

• greload
  • Perform a git pull, and then execute the 'reload' command. Saves a lot of time updating!
• reload
  • Reload all of the modules currently in use by DBot. By using this, all module functionality should be reloadable and replaceable without having to restart the bot or interrupt the connection to the server.
• load [module]
  • Load a new module. This works by adding a module name to the roster and then triggering a reload of all modules, at which point the new module is actually loaded by the standard DBot process.
• unload [module]
  • Unload a currently loaded module. This removes the module, and then triggers a reload of all modules.
• ~setconfig
  • Set a config key
• ~showconfig
  • Show a config key

Bot Commands

• %status
  • Shows status of www.tripsit.fm
• %listeners
  • Shows number of listeners are tuned in to www.tripsit.fm
• !voice [user]
  • Gives voice to a user
• !devoice
  • Removes voice
• !op [user]
  • Gives op to a user
• !deop
  • Removes op
• !voteban [user] [yes/no]
  • vote to ban a user for a little while. triggers a ban as soon as there's 2 or more votes.
  • voting no decreases the vote count,yes increases it
  • only available to ops and voices
• !seen [nickname]
  • when was a user last seen? (also try ~seen [nickname])
• !weather [city]
  • shows weather forecast for that area
• !isup [domain]
  • checks whether a website works, and shows latency
• !shorturl [url]
  • creates a short(er) URL for that URL
• !ping
  • if you get a reply, you're still connected to IRC
• !image [whatever]
  • finds you an image of whatever
• !calc [arithmetical problem]
  • calculator - eg "2+2" makes the bot say "4"
• !bitcoin [exchange]
  • shows bitcoin exchange rates. Defaults to mtgoxUSD. List of supported exchages
• !btcbal [btc address]
  • shows balance for a bitcoin addresscountdowns
• !setcountdown [unix timestamp]
  • set countdown (set to 0 to disable)
  • op or voice !countdownshows time until countdown
• !str2time [text]
  • calculate unix timestamp for the text, it could be anything like "2pm CST" or "+5 hours" or "december 25, 2013". mostly used for setting a countdown
• !until [unix timestamp]
  • calculate time to unix timestamp, can be useful for testing a countdown.search
• !google [query]
  • searches google
• !erowid [query]
  • searches erowid
• !youtube [query]
  • searches youtube

Chanserv

• /msg chanserv help
  • Shows all chanserv commands
• /msg chanserv REGISTER #channel
  • Registers a channel with chanserv
• /msg chanserv invite
  • invites you to a channel
• /msg chanserv OP
  • gives channel ops to a user
• /msg chanserv recover
  • regains control of your channel
• /msg chanserv set
  • sets various control flags
• /msg chanserv unban
  • removes ban on a chnnel
• /msg chanserv help flags
  • Shows flag usages
• /msg chanserv flags #room [nick] [+flag or -flag]
  • adds or subtracts a flag from a user

Flags

• +v - Enables use of the voice/devoice commands.
• +V - Enables automatic voice.
• +o - Enables use of the op/deop commands.
• +O - Enables automatic op.
• +s - Enables use of the set command.
• +i - Enables use of the invite and getkey commands.
• +r - Enables use of the kick, kickban, ban and unban commands.
• +R - Enables use of the recover and clear commands.
• +f - Enables modification of channel access lists.
• +t - Enables use of the topic and topicappend commands.
• +A - Enables viewing of channel access lists.
• +S - Marks the user as a successor.
• +F - Grants full founder access.
• +b - Enables automatic kickban.
• +e - Exempts from +b and enables unbanning self.

Nickserv

• /msg nickserv register [password] [[email protected]]
  • Registers your nick

• /msg nickserv identify [nick] [password]
  • identifies your nick
• /msg chanserv FLAGS #channel
  • shows flags of a particular channel
• /msg nickserv ghost
  • Reclaims use of a nick AFTER you identify
• /msg nickserv release [nick] [password]
  • releases a services enforcer, useful when you can't reclaim your nick. May have to do it 3 times
• /msg nickserv group
  • adds a nickname to your account
• /msg nickserv info
  • displays info on registration
• /msg nickserv listchans
  • lists channels you have access to
• /msg nickserv set
  • sets various control flags
• /msg nickserv ungroup
  • removes a nick from your account