Skip to content
This repository was archived by the owner on Nov 6, 2021. It is now read-only.

Bot commands

Jump to bottom
sharedferret edited this page May 22, 2012 · 7 revisions

The bot can respond to commands said in chat or over PM in a Turntable.fm room. This list is current as of version 1.0.4.

##List of Commands

####User commands

  • commands - Displays the list of commands the bot can respond to

  • [bot shortname], pm me - The bot will send you a Private Message so you can send private requests to it

  • /dive - The bot will pull you off-stage

  • /roll - Dice roll

  • .owner - Outputs a bot owner response configurable in config.js

  • .source - Provides a link to this GitHub project

  • ping - Responds to the issuing user that they are still in the room.

  • reptar - Responds with a variant of "rawr!"

  • .hodor, hodor? - Hodor!

  • rules - Displays the room rules (defaults to Indie/Classic Alt 1 & Done room rules).

  • hugs meow - Hugs the issuing user back in chat.

  • platforms - Lists the number of users on each platform (PC/Mac/Linux/iPhone/Chrome) in the room.

  • songinfo - Displays mid-song stats (awesomes, lames, snags). Useful for iPhone users.

  • .similar - Gives three similar songs to the one playing using last.fm's database.

  • .similarartists - Gives four similar artists to the one playing using last.fm's database.

  • platforms - Returns the number of each type of computer (pc, linux, mac, chrome, iPhone) in the room.

  • .quake - Returns the three most recent earthquakes of M2.5 or greater

  • joindate - Returns the user's join date.

  • roominfo - Displays the room info in chat.

  • .fanme - The bot will fan you.

  • .unfanme - The bot will unfan you.

  • myuserid - Displays your user id.

  • onlinemods - Shows a list of moderators currently online.

####Bonus commands

  • points - Displays what is needed for the bot to awesome the song (number of awesomes, points, etc).

  • bonus, /bonus, dance, /dance - Adds a bonus point to a song (if enabled). When a song has enough bonus points, the bot will awesome.

####Room enforcement commands

  • waitdjs - Displays a list of DJs that must wait before stepping up again, and how long they must wait.

  • .remaining, songsremaining - Shows a DJ how many songs they have remaining before they must step down.

  • djinfo - Displays a list of current DJs and how many songs they have remaining before they must step down.

  • any spots opening soon?, anyone stepping down soon? - Displays the next DJ to step down, and how many songs they have remaining.

  • can i step up? - Tells a user if they can step up to DJ again.

####Waitlist commands

  • .add, .addme, +q - Adds user to waitlist/queue

  • .rem, .removeme, -q - Removes user from waitlist/queue

  • .fq - Adds a user to the start of the waitlist/queue

  • shiftq, .shiftq, shiftqueue, .removefirst - Removes the first user from the waitlist/queue (e.g. if they're gone/AFK)

  • .position - Shows your position in the waitlist/queue

  • .pq, printqueue - Prints the waitlist/queue

####Facts/Quotes

  • catfact, .catfact, catfacts - Returns a cat fact!

  • .pilgrim, ONE TWO THREE FOUR - We are Sex Bob-Omb and we're here to watch Scott Pilgrim kick your teeth in!

####Commands with parameters

  • .weather [zip] - Returns the current weather conditions at the specified zip code. This call uses the Yahoo! YQL service. Note: This service is rate-limited to 1,000 calls per hour.

  • .find [zip] [thing] - Returns the nearest location of a matching business to the zip code. This call uses the Yahoo! YQL service. Note: This service is rate-limited to 1,000 calls per hour.

  • pastnames [name] - Returns some names that the given user has gone by (as seen by the bot).

  • allpastnames [name] - Returns all names the user has gone by (PM only).

  • userinfo [name] - Returns stats on any TT user.

####User database commands

  • stats - Gives overall room statistics (number of songs played, number of awesomes/lames, averages).

  • past24hours - Displays the 3 most-awesomed DJs in the past 24 hours in the room.

  • mypast24hours - Displays your stats in the room over the past 24 hours.

  • pastweek - Displays the five most-awesomed DJs in the past week in the room.

  • mypastweek - Displays your stats in the room over the past 7 days.

  • bestplays - Returns the three song plays with the most awesomes logged by the bot.

  • bestdjs - Returns the three DJs with the most awesomes logged by the bot.

  • worstdjs - Returns the three DJs with the most lames logged by the bot.

  • mostplayed - Returns the three most-played songs logged by the bot.

  • mostsnagged - Returns the three songs with the most cumulative snags.

  • mostawesomed - Returns the three most awesomed (cumulative) songs logged by the bot.

  • mostlamed - Returns the three most lamed (cumulative) songs logged by the bot.

  • mystats - Returns the user's stats in the room (songs played, awesomes, lames, averages)

  • mymostplayed - Returns the user's three most played songs.

  • mymostawesomed - Returns the user's three most awesomed (cumulative) songs logged by the bot.

  • mymostlamed - Returns the user's three most lamed (cumulative) songs logged by the bot.

  • namechange - Guesses when a user can change their name again (accurate only if a user is in the room often)

  • myhearts - Returns the number of total snags/hearts a user has gotten in the room

  • mymostsnagged - Returns the three most snagged songs by a user

  • mostnames - Returns the three users with the most name changes

Admin Commands

These commands can only be performed by room moderators.

  • .reloadcommands - Reloads commands from the commands/ folder

  • setavatar # - Sets the bot's avatar

  • waitlist on / waitlist off - Turns the waitlist on/off.

  • .a - Tells the bot to awesome the current song.

  • .l - Tells the bot to lame the current song.

  • skipwait [user] - (Enforcement only) Removes the user from the past DJ list so they can step up again.

  • pulldj - Pulls a DJ off stage after their song.

  • pullcurrent - Pulls the current DJ off stage during their song.

  • meow, step up - The bot steps up to DJ.

  • meow, step down - The bot steps down from the decks.

  • meow, shut down - The bot shuts down, terminating the process.

  • banuser [name] - Bans the user from the room.

  • unbanuser [name] - Unbans the user from the room.

  • listbans - Shows all current bans.

Clone this wiki locally