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
Halcyon is a Matrix bot library created with the intention of being easy to install and use. Inspired by discord.py

Halcyon is a Matrix bot library with the goal of being easy to install and use. The library takes inspiration from discord.py and the Slack li

Wes Ring 19 Jan 06, 2023
Skautský discord bot

Jáchym 🤖 Open-source skautský discord bot postavený na discord.py O čem? • Funkce • TODO • Poděkování ❓ O čem? Jáchym vznikl jako projekt do odborky

10 May 12, 2022
dex.guru python sdk

dexguru-sdk.py dexguru-sdk.py allows you to access dex.guru public methods from your async python scripts. Installation To install latest version, jus

DexGuru 17 Dec 06, 2022
Technical Test - Python Programmer Grupo Nexxera

Technical Test Nexxera Group Teste Técnico - Grupo de Programadores Python Nexxera 📍 Prepare-se para usar a API Nossa API de transações de contas dig

Raul dos Santos Moraes 1 Mar 16, 2022
Balanced API library in python.

Balanced Online Marketplace Payments v1.x requires Balanced API 1.1. Use v0.x for Balanced API 1.0. Installation pip install balanced Usage View Bala

Balanced 70 Oct 04, 2022
SEP Finder Bot

SEP Finder Bot This is a Telegram bot that will help you find the correct SEP and Baseband files to use for your device with futurerestore. Usage A ho

6 Dec 03, 2022
Bancos de Dados Relacionais (SQL) na AWS com Amazon RDS

Bancos de Dados Relacionais (SQL) na AWS com Amazon RDS Repositório para o Live Coding DIO do dia 24/11/2021 Serviços utilizados Amazon RDS AWS Lambda

Cassiano Ricardo de Oliveira Peres 4 Jul 30, 2022
scrapes medias, likes, followers, tags and all metadata. Inspired by instagram-php-scraper,bot

instagram_scraper This is a minimalistic Instagram scraper written in Python. It can fetch media, accounts, videos, comments etc. `Comment` and `Like`

sirjoe 2.5k Nov 16, 2022
Hydrathallies'in istegi uzerine yapildi :)

Telegram-Doviz-Bot Telegram Döviz Botu, Pyrogram ile yapıldı. Deploy Deploy on Heroku Deploy on local git clone https://github.com/lambda-stock/Telegr

2 Dec 08, 2021
Example of Telegram local API and aiogram 3.x

Telegram Local Full example of Telegram local application. Contains Telegram Bot API Local Telegram Bot API server based on aiogram Bot API Server ima

Oleg A. 9 Sep 16, 2022
A fun hangman style game to guess random movie names with a short summary about the movie.

hang-movie-man Hangman but for movies 😉 This is a fun hangman style game to guess random movie names from the local database and show some summary ab

Ankit Josh 10 Sep 07, 2022
This is a tool to help people to make a bot for labelling images for machine learning projects.

labeller_images_python_telegramBOT This is a bot to help collect data for any machine learning project. It was developed using the python-telegram-bot

Diego Silveira 2 Nov 13, 2021
ETL python utilizando API do Spotify

Processo de ETL com Python e Airflow usando API do Spotify Sobre Projeto de ETL(Extract, Transform e Load) utilizando Python com API do Spotify e Airf

Leonardo 10 Mar 16, 2022
A management system designed for the employees of MIRAS (Art Gallery). It is used to sell/cancel tickets, book/cancel events and keeps track of all upcoming events.

Art-Galleria-Management-System Its a management system designed for the employees of MIRAS (Art Gallery). Backend : Python Frontend : Django Database

Areesha Tahir 8 Nov 30, 2022
Graviti-python-sdk - Graviti Data Platform Python SDK

Graviti Python SDK Graviti Python SDK is a python library to access Graviti Data

Graviti 13 Dec 15, 2022
Short Program using Transavia's API to notify via email an user waiting for a flight at special dates and with the best price

Flight-Notifier Short Program using Transavia's API to notify via email an user waiting for a flight at special dates and with the best price Algorith

Wassim 2 Apr 10, 2022
Fetching tweets and integrating it with Kafka and PySpark

KafkaPySpark Zookeeper bin/zookeeper-server-start.sh config/zookeeper.properties Kafka Server bin/kafka-server-start.sh config/server.properties Kafka

Priyansh 2 Dec 29, 2021
Prime Mega is a modular bot running on python3 with autobots theme and have a lot features.

PRIME MEGA Prime Mega is a modular bot running on python3 with autobots theme and have a lot features. Easiest Way To Deploy On Heroku This Bot is Cre

『TØNIC』 乂 ₭ILLΣR 45 Dec 15, 2022
An advanced Filter Bot with nearly unlimitted filters!

Unlimited Filter Bot ㅤㅤㅤㅤㅤㅤㅤ ㅤㅤㅤㅤㅤㅤㅤ An advanced Filter Bot with nearly unlimitted filters! Features Nearly unlimited filters Supports all type of fil

TroJanzHEX 445 Jan 03, 2023
Hasan Can Kaya - Konusanlar Ticket Notifier

Hasan Can Kaya - Konusanlar Ticket Notifier This script sends a notification to any telegram chat/group/channel when added a new available ticket to b

omer citak 3 Jan 31, 2022