/vote/ Voting for the botBeam me up!

• Benefits of Voting
  • A thank you message when you do stuff
  • Setting nicknames for ~osu and osu-related commands
  • There’s more but I don’t remember it all…
• How to vote:
  • Run ~hasVoted
  • Vote at discordbots.org/bot/463221705628975104

Nickname

/osu/ osu! related commands, including beatmap searchBeam me up!

• ~osuset - sets your username
  • Usage: osuset [options] [username]
    • Options (optional)
      • [-n|--nickname] [nickname] sets your nickname/alias (you have to be voted to use this)
      • [-r|--ripple] sets your Ripple username
• ~osu - prints profile statistics and information
  • Possible commands: ~osu | ~mania | ~taiko | ~ctb
  • Posssible usages:
    • ~osu [Options] returns the profile for the username you set
    • ~osu [Options] [@mention] returns the profile for the player you mentioned
    • ~osu [Options] [username] returns the profile for that username
      • Options (optional)
        • --ripple queries your Ripple profile
        • [-d|--details] returns extra information
• ~osutop prints profile statistics and information
  • Possible commands:
    • ~osutop | ~maniatop | ~taikotop | ~ctbtop
    • ~osutop returns the top (3) plays
    • ~osutop [username|@mention] returns the top (3) plays for that user
    • ~osutop [Options] [username|@mention] returns the top n plays for that user (n from 1 to 10)
      • Options (optional)
        • [-s|--shift] [1..20] - sets the page (1 would show your most recent (default), 2 would show your second page, …)
  • Example:
    • ~osutop -s 2 would show your 5th to 10th top play
• ~recent | ~r prints the most recent plays and its statistics
  • Usage: ~recent [options] [username|@mention] or ~recent [options]
    • Options (optional)
      • --ripple queries your Ripple profile
      • [-m|--mode] [std|mania|taiko|ctb] changes mode (default std)
      • [-s|--shift] [1..10] sets the page
      • --angle calculates Xexxar’s proposed changes
  • Example:
    • ~r -s 5 prints your 5th most recent play
    • ~recent cookiezi prints cookiezi™’s most recent play
• ~score finds your top play and print it
  • Usage: ~score [beatmap link] [Options]
    • Options (optional)
      • [username|@mention] - the user you want to query
      • [-l|--list] [1..10] lists n entries instead of default 1
      • [-s|--shift] [1..n] shifts to the nth entry
      • --angle calculates Xexxar’s proposed changes
• ~compare fetches bot messages and sort them in a list to easily compare scores.
  • Only works with outputs with 1 score only, such as ~recent or ~score (1 entry/score)
• ~pp calculates pp for a beatmap
  • Usage: ~pp [link to beatmap/beatmapset] [OPTIONS]
    • Options (optional)
      • +[HD|HR|...] - include mods into the formula
      • [1..100]% - include accuracy into the formula
      • [1..n]x - include combo into the formula
      • --angle calculates Xexxar’s proposed changes
• ~mapsearch: Show help for looking up maps
  • Usage: ~mapsearch title MAPTITLE | [Options]
    • Options (marked with !/ are arguments in which at least one is needed)
      • !/ title - search with map title
      • !/ artist - search with map artist
      • !/ mapper - search with map mapper
      • !/ diffname - search with map difficulty name
      • exact - show only exact matches
      • standard - show only osu!standard maps
      • mania - show only osu!mania maps
      • taiko - show only osu!taiko maps
      • ctb - show only osu!ctb maps
      • ranked - show only ranked maps
      • qualified - show only qualified maps
      • loved - show only loved maps
  • Example: ~mapsearch title Jitter Doll | mapper -Laura- | ranked

~osu

~osutop

/kitsu/ Kitsu related commands, for looking up anime and mangaBeam me up!

• ~kitsu: Find anime and manga from Kitsu.io
  • Usage: ~kitsu [OPTIONS] [keywords] finds anime
    • Options (optional, falls back to anime)
      • anime - finds anime, default behavior
      • manga - finds manga
      • search [anime|manga] - list search entries instead of information
  • Example: ~kitsu Arifureta

Screenshot

/np/ Now playing, for showing off or just easier sharingBeam me up!

Idea from the np command in osu!

• Usage: ~np
• Supported integrations (as of Aug 2): osu!, Spotify

osu!

Spotify

/arch/ Arch Linux related commands, for looking up AUR or Repository packagesBeam me up!

• ~aur finds packages on the Arch Linux User Repository
  • Usage: ~aur [OPTIONS] [keywords]
    • Options (optional)
      • [-e|--exact] - exact match only
• ~packages finds packages on the Arch Linux Repository
  • Usage: ~packages [OPTIONS] [keywords]
    • Options (optional)
      • [-e|--exact] - exact match only

Screenshot

/sourcequery/ Sourcequery, queries most Source serversBeam me up!

• Usage: ~sourcequery [IP:port]
• If you’re voted, a player list should show up

Screenshot

Voted

/spotify/ Spotify, for when you want to look up songsBeam me up!

• Usage: ~spotify
  • First case: ~spotify [track|artist|album] [keyword]
  • Second case: ~spotify [trackid] [keyword]
    • Track ID can be get from the tail of a track URL:
      • https://open.spotify.com/track/3YRCqOhFifThpSRFJ1VWFM
        • Track URL because it has https://open.spotify.com/track/
        • Its ID is 3YRCqOhFifThpSRFJ1VWFM
• Example: ~spotify track November Rain

~spotify track November Rain

~spotify trackid 3YRCqOhFifThpSRFJ1VWFM

/saucenao/ Saucenao, to reverse lookup images in serverBeam me up!

• Usage: ~saucenao [link, optional]
  • Note: if no link is supplied, ~saucenao must be the content of a file uploaded in Discord
  • The rate limit is 1 command per minute, with a global limit of 30 commands per 30 seconds. Blame Saucenao for this.

Screenshots

/twitch/ To query Twitch streamersBeam me up!

• Usage: ~twitch [username]
• Example: ~twitch thepoon02

Screenshot

/time/ TimeBeam me up!

• Querying
  • Usage: ~time [city]
  • Example: ~time Los Angeles
• Setting default time for current user
  • Usage: ~time [-s|--set] [Linux Timezone]
    • Linux Timezone can be found by running ~time [city]
    • Time set will soon be used throughout the bot, such as in printed dates, etc.
  • Example: ~time -s America/Los_Angeles

Screenshot

/calc/ CalculatorBeam me up!

• Usage: ~calc [equation]
  • Note: ~calc accepts bc -l or the standard math library.
• Example: ~calc 4*a(1) # calculates Pi

Screenshot

/wttr/ wttr.in, a simple weather report siteBeam me up!

Work in Progress, might change in the future

• ~wttr [OPTIONS] [city] finds current weather
  • Options (optional)
    • -c reports the temperature in Celcius
    • -f reports the temperature in Fahrenheit

/lyrics/ Genius, for when you need to look up lyricsBeam me up!

Or maybe sing Despacito, who knows?

• ~lyrics
  • ~lyrics [keywords] searches Genius for IDs
  • ~lyrics id [id] queries Genius for Lyrics from ID

Step 1 - ~lyrics Black Rover

Step 2 - ~lyrics id 3800133

/c99/ Misc queries (WIP)Beam me up!

• Currency conversion
  • Usage: [amount, integer] [from] [to]

/miscellaneous/ Toggle and Random Choice GeneratorBeam me up!

• ~toggle [feature] shows a list of toggleable features
  • despacito toggles a response for des and cito
  • hentai toggles n/ehentai link parsing (default: true)
  • osulink toggles osu! beatmap link parsing (default: true)
• ~choose [choices] chooses randomly for you
  • Delimiter is the word or
  • praise rngesus