/owo

owo!

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

owo - An osu! Discord bot

This is owo, an instance of Red, an open source Discord bot created by Twentysix and modified by Stevy for the specific purpose of Osu!.

Key Features include:

  • User profiles
  • Top/Recent plays
  • Score tracking
  • Map detection and pp calculation
  • Screenshot detection
  • Standard map recommendations

You can add the bot using this link or join the owo server here.

If you would like to run your own instance of owo because tracking is getting too slow or some other reason, please follow the instructions provided by Twentysix and others on how to install a Redbot for your system. Then, getting this to work should make more sense. If you're having issues with leveler.py and/or osu.py, be sure you read up on my cog repo on how to install those two cogs. Have fun! If you have questions/need help, ask in the owo! Official server.

Command List:

Command Description
osu [username1] [username2]... (option) Shows osu! Standard profile; options: -ripple/-official -d
taiko [username1] [username2]... (option) Shows taiko profile; options: -ripple/-official -d
ctb [username1] [username2]... (option) Shows ctb profile; options: -ripple/-official -d
mania [username1] [username2]... (option) Shows mania profile; options: -ripple/-official -d
osutop [username] (options) Shows top 5 osu! Standard plays for a certain player; options: -p [top play number = 1-100] -ripple/-official -r -g
taikotop [username] (options) Shows top 5 taiko plays for a certain player; options: -p [top play number = 1-100] -ripple/-official -r -g
ctbtop [username] (options) Shows top 5 ctb plays for a certain player; options: -p [top play number = 1-100] -ripple/-official -r -g
maniatop [username] (options) Shows top 5 mania plays for a certain player; options: -p [top play number = 1-100] -ripple/-official -r -g
recent [username] (options) Gets the recent play of player according to their default gamemode; options: `[gamemode = osu
--- ---
osuset Shows General Commands for Setting Information in the Module
osuset api [official/ripple] Set the default api to use for the server for the commands above
osuset default [0/1/2/3] Set a users default gamemode to use for recent command
osuset displaytop [#] Set # of best plays being displayed in top command
osuset key osu [key] Set osu api key Must do this first for anything to work! You can get one here: https://osu.ppy.sh/p/api
osuset key puush [key] Set puush api key. You can get a key here: https://puush.me/
osuset tracking [enable/disable] Disable/Enable tracking on server
osuset user [username] Links username to discord account
--- ---
osutrack Shows General Commands for Player Tracking
overview Shows stats of player tracking
osutrack add [username1] [username2]... (options) Adds a player to tracking (can edit/don't have to remove first); options: -m [gamemode = 0123] -t [track number = 1-100] -r [recent modes = 0123]*
osutrack clear Removes all players from tracking in the server
osutrack list Lists all people tracked in server + modes/# of plays
osutrack remove [username1] [username2]... Removes a player from tracking
--- ---
recommend (options) Standard map recommendations; options: any/nomod/(mod combo) pp target
--- ---
options Shows Server Toggles (Mostly for passive detection)
options beatmap Toggles beatmap url detection
options beatmapgraph Toggles beatmap graph
options screenshot Toggles screenshot detection
options ssgraph Toggles screenshot detection graph
* Work in progress (see branch for recent tracking)