A Discord bot for osu!

Overview

osu profile

This is the mostly-complete repo for the owo Discord osu! bot which you can invite here. As you look through this repo, please keep in mind that all of this code is written for me and not for anyone else, so the only consideration for code structure is that it's convenient and works for me. Here's a quick FAQ section for you programmers or anyone who's considering trying to get this to work on your end. For a full list of commands, visit the website here.

Overview of Features

Firstly, if you're annoyed by the implicitly triggered "owo"-type commands, I'm with you - do >funadmin prefixless to disable them.

Secondly, if you haven't already, link your osu! account by doing >osuset user "your username"; if you have a space in your name, use quotes. The official server can provide verification for your account if you have your discord information on your osu! profile (settings section). If you wish to link your account to a private server, append the suffix -(server name) e.g. (>osuset user "your username" -ripple); things like rx are not needed in the server name when setting user. Do >botinfo to view supported private servers.

Table of Contents

Profile Commands

Firstly, to view some basic profile information, there are four commands: >osu >taiko >ctb >mania. If no parameters are provided, they will display the information of the account you linked, otherwise, it will use your input as a username and find that user's info. Examples: >osu Stevy, >taiko syaron105, >ctb AutoLs, >mania Jakads.

osu profile taiko profile ctb profile mania profile

If you append -d to any one of those, you will get a detailed profile. If you append -s, you will get some calculated statistics for the user using their top plays. Examples: >osu -d "Stevy", >osu -s "chocomint".

detailed profile stats profile

Return to Table of Contents

Top Play Commands

Next, there are the top commands: >osutop >taikotop >ctbtop >maniatop. Input convention follows the "core" commands from above. This will display your top 5 plays for that gamemode. Example: >osutop "chocomint".

osutop

The top command supports various types of sorting and filtering functions. By appending tags, you can sort by accuracy (-acc), max combo (-c), rank achieved (-rk), and score (-sc). You can filter by using tags like index (-i #) and mod (-m (mods)). Additionally, there is a no-choke option (-nc) that will calculate hypothetical no-choke plays for your entire top 100 - sorting and filters can be applied here as well. There is also a supporter feature (-im) that allows you to generate a score image of one of your plays. If you'd like to support, do >support or visit the patreon page. Examples: >osutop chocomint -nc, >osutop chocomint -im -i 3

no choke score image

For more information, use the >help command on the respective top command (e.g. >help osutop) in Discord or visit the website for examples.

Return to Table of Contents

Map Recommendations

The bot can give recommendations for any mode based on a user's top 15 plays and mods in the respective mode (e.g. >recommend or >r). If you think a recommendation is too easy, use the -f or farm parameter; the higher the number, the more farmy. If you don't like the mods it gives, you can specify by just writing the mod afterwards, like HDDT. If you want a specific ar, use the -ar tag. You can also use ranges, like 4-5. However, it should be noted that for non-std recommendations, only the -pp and -f options work. For more information, visit the website. Example: >r -f 10 -ar 10-10.4 HDDT -pp 300-350 (Farm rating = 10 (easy to farm), AR = 10-10.4, mods = HDDT, target pp = 300-350).

rec image

Return to Table of Contents

Tracking

To track a user or users, type the command >track add (username) (username2) .... The default mode and number tracked is 0 (std) and 50. To specify the # of top plays to be notified about, append -t # to the command. To specify the modes to be tracked, append -m (modes) to your command; 0=std, 1=taiko, 2=ctb, 3=mania. e.g. >track add -m 23 -t 75 Stevy would track the top 75 plays for Stevy on that channel for modes 2 and 3. You can also track certain countries and the number of players by appending -c and a two-character country code or global, and specify the number of top players using -p #. The number of top plays and the modes are, again, defined by -t and -m, respectively. Please keep in mind that servers have a default track limit of 200 players, but tracking a country's top 30 players for 3 different gamemodes will only add 30 to your list! If you made a mistake in adding a user, simply use the add command again.

If you want to completely overwrite with new options, use -o. If you want to remove that user or users from tracking, use >track remove (username) (username2) .... If you want to clear all people on the server, do >track remove -a. If you want to clear a single channel, do track remove -ch in that channel. For more info, use >help track add or visit the website.

Return to Table of Contents

Map Feed

The bot can track newly qualified, ranked, and loved maps for all gamemodes. To enable, pick a channel and do >mapfeed. By default, the bot will display all new maps that are either qualified, ranked, or loved and in all gamemodes. To filter what maps gets displayed, you can introduce filters such as excluded mappers (-xmpr) or least stars (-ls) to only get beatmap sets containing at least one map with a star value greater than what was specified. To view your settings, do >mapfeed -info. To remove a channel from the map feed, do >mapfeed -rm. For more information, visit the website. An example of a newly ranked map is shown below.

map feed image

Return to Table of Contents

Implicit Commands

There are a few passive triggers for owo, mostly to do with osu links and screenshots. There is a 5 second cooldown per server when any of these are triggered. The way to disable all of these server-wide is >osuadmin implicit. To toggle, do the command again. Below are ways to selectively enable/disable different links.

Beatmap Links

If a beatmap linked from the official site is posted, owo will post that map's information, pp information, along with some download links. If it is a single beatmap, a graph (only accurate for std) will be displayed. If it's a beatmap set, the top 3 difficulties will be displayed. If you wanted to see how certain mods will effect the map's pp values, you can simply append +(mods) to the end of the link. This is very similar to the >map command. Examples: https://osu.ppy.sh/beatmapsets/93523#osu/252238, https://osu.ppy.sh/beatmapsets/93523#osu/252238 +HDHR

beatmap image beatmap_mod image

Return to Table of Contents

User Links

The bot also detects user links and displays them in the same format as the basic profile commands. Example: https://osu.ppy.sh/users/5053158.

user link image

Screenshots

The bot is able to detect maps from screenshots (to varying degrees of accuracy...). If a top or recent play is detected, then it will provide some information of that play, otherwise, it will only be the map information. The screenshot must be from the official server or directly from the game (no modified filenames). Normally, screenshot files should follow the format screenshot#.png.

screenshot image

Toggling Implicit/Passive Settings

To toggle settings for link and screenshot detection, use the >osuadmin command and sub-commands. Toggling the implicit setting will enable/disable all link/screenshot detection (e.g. >osuadmin implicit). Sub-commands like beatmapurl will disable beatmap url detection. Other options are listed in the osuadmin stem command. To get an overview of your settings (not just for osu!), do >overview. Example: >overview.

overview image

Getting More Info w/ >help

As mentioned previously, if you want to explore more stuff about the bot, use the >help or >h command. If you are dealing with a nested command, you can do something like >h track add. You can also visit the website which includes many examples. Example: >h track add.

help image

Return to Table of Contents

Coding FAQ

Why are cogs mostly in a huge file and not separated?

Writing in a single file is extremely convenient for me to apply hotfixes and reload the module. Hotfixing and reloading are far-preferred over restarting because the bot takes about 15 minutes to log in all shards due to Discord API rate limit restrictions. After fiddling around with importlib for several days, I haven't been successful in reloading files that aren't the one the cog is located in. If you have gotten this to work in Python/discord.py, then I'd love to know about it.

What is with all this spaghetti code?

Like you, my intensions aren't to write code that is unreadable. But when things get as complex as they do with new feature requests coming in every week, you just give into the mess while trying to implement things as fast as possible. So as I said up top, this code is for no one and is not meant to be read. To me, if it works, it works.

Why are there so many unspecified try-catches?

At some point, you just get tired of seeing errors in your console from bad user inputs. Doing this is akin to this meme.

Will you ever upload the databases you use?

No, there is too much back-end going on and helping everyone get the database working will be a hassle.

I have osu API questions, can you help?

Yeah, of course! I'm open to any questions if people need help with the osu! API or programming questions in general. Although, after reading this code, I'm not so sure you'd want it! But if you still do, feel free to chat in the Discord server.

Return to Table of Contents

Owner
Stevy
I'm a Stevy person.
Stevy
It is automated instagram follower bot.

Instagram-Follower-Bot It is automated instagram follower bot. In This project I've used Selenium and Python. Work-Flow When I run my code. It's gonna

Falak Shair 3 Sep 28, 2022
Telegram bot to clip youtube videos

youtube-clipper-bot Telegram bot to clip youtube videos How to deploy? Create a file called config.env BOT_TOKEN: Provide your bot token generated by

Shivam Jha 11 Dec 10, 2022
Userbot untuk memutar video dan lagu di vcg/os

Userbot untuk memutar video dan lagu di vcg/os

FJ_GAMING 2 Nov 13, 2021
a Music bot for discord

Bot this is a discord bot made by AnHalfGuy.py#6031(ID: 747864072879603743) and HastagStopAnimalAbuse#5617(ID :349916852308279306) This Bot Is For Mus

A Discord Bot Development 1 Oct 29, 2021
Example of a discord bot in Python

discordbot.py Example of a discord bot in Python Requirements Python 3.8 or higher Discord Bot Setting Up Clone this repo or download the files Rename

Debert Jamie 1 Oct 23, 2021
GitHub Actions Docker training

GitHub-Actions-Docker-training Training exercise repository for GitHub Actions using a docker base. This repository should be cloned and used for trai

GitHub School 1 Jan 21, 2022
Discord Voice Channel Automatic Online

Discord-Selfbot-voice Features: Discord Voice Channel Automatic Online FAQ Q: How can I obtain my token? A: 1. How to obtain your token in android 2.

Pranav Ajay 3 Oct 31, 2022
Automatically deploy freqtrade to a remote Docker host and auto update strategies.

Freqtrade Automatically deploy freqtrade to a remote Docker host and auto update strategies. I've been using it to automatically deploy to vultr, but

p-zombie 109 Jan 07, 2023
A Python wrapper around the Soundcloud API

soundcloud-python A friendly wrapper around the Soundcloud API. Installation To install soundcloud-python, simply: pip install soundcloud Or if you'r

SoundCloud 83 Dec 12, 2022
Easy way to use Telegram bot to hide your identity.

telegram-support-bot Easy way to use Telegram bot to hide your identity. Useful for support, anonymous channel management. Free clone of Livegram Bot.

Daniil Okhlopkov 197 Dec 23, 2022
Python-based Snapchat score booster using pyautogui module

Snapchat Snapscore Botter Python-based Snapchat score booster using pyautogui module. Click here to report bugs. Usage Download ZIP here and extract t

477 Dec 31, 2022
The wrapper you need for the osu!api v2

oppy (op.py) oppy is the wrapper for use on the osu! v2 API. Version 1.0.0 Installation To install please use pip to install oppy pip install op.py To

Wayde 2 May 01, 2022
Zipper-s-Father - A simple telegram bot that takes a list of files sent by the user and returns them zipped

ZIP files telegram bot A simple telegram bot that takes a list of files sent by

Dr.Caduceus 1 Jan 29, 2022
This is a Innexia Group Manager Bot with many features

⚡ Innexia ⚡ A Powerful, Smart And Simple Group Manager ... Written with AioGram , Pyrogram and Telethon... Available on Telegram as @Innexia ❤️ Suppor

TeamDeeCode 84 Jun 04, 2022
Discord bot that generates boba drinks. Submission for sunhacks 2021

boba-bot Team Poggies' submission for Sunhacks 2021. Find our project page on Devpost, and a video demonstration can be found on YouTube. Commands $he

Joshua Tenorio 3 Nov 02, 2022
Aplicação dos metodos de classificação em 3 diferentes banco de dados. Usando...

Machine Learning - Métodos de classificação Base de Dados utilizadas: Dados de crédito Dados do Census Métodos de classificação aplicados: Naive Bayes

1 Jan 18, 2022
This is an implementation example of a bot that periodically sends predictions to the alphasea-agent.

alphasea-example-model alphasea-example-modelは、 alphasea-agent に対して毎ラウンド、予測を投稿するプログラムです。 Numeraiのexample modelに相当します。 準備 alphasea-example-modelの動作には、

AlphaSea 11 Jul 28, 2022
Fast discord token checker with high cpm

Discord-Token-checker Fast discord token checker with high cpm preivew Download git clone https://github.com/TusTusDev/Discord-Token-checker pip insta

Tustus 1 Oct 15, 2021
通过GitHub的actions 自动采集节点 生成订阅信息

VmessActions 通过GitHub的actions 自动采集节点 自动生成订阅信息 订阅内容自动更新再仓库的 clash.yml 和 v2ray.txt 中 然后PC端/手机端根据自己的软件支持的格式,订阅对应的链接即可

skywolf627 372 Jan 04, 2023
Webservice that notifies users on Slack when a change in GitLab concern them.

Gitlab Slack Notifier Webservice that notifies users on Slack when a change in GitLab concern them. Setup Slack Create a Slack app, go to "OAuth & Per

Heuritech 2 Nov 04, 2021