UsagiBot

---

UsagiBot is a Twitch & Bancho IRC bot for handling song requests in Osu!

📘 Instruction

---

This version of the bot is targeting Java 21. Please have Java 21 or higher installed. This program only works with Windows.

1. Download the latest version of UsagiBot
2. Extract UsagiBot.jar to its own folder
3. Open notepad and create a start.bat script. You can copy and paste the code from below.

java -jar Usagibot.jar
pause

4. Run the newly created script once. It will create a configuration file for you. Fill out those fields and run the bot again.
   • Head over to the configuration wiki to learn how to configure the bot properly.
5. Everything should hopefully be working properly.

✏️ Twitch Usage

---

Here's a list of avaliable Commands

Requesting songs

Anyone can request a song to be added. To do this just simply post the beatmapset link inside the chat.
As an example, https://osu.ppy.sh/beatmapsets/53176#osu/162237.
If you would like to tell the streamer to play certain mods, use +<mods>.
As an example, https://osu.ppy.sh/beatmapsets/53176#osu/162237 +HDHR.

✅ Supported Memory Readers

---

• gosumemory by l3lackShark
• rosu-memory by 486c
• tosu by KotRikD
• StreamCompanion by Piotrekol

❗ Requirements

---

• Twitch OAuth2 Token - It is recommended to create a new account for this.
• Osu API Token - Scroll down to the bottom to obtain your tokens. More information inside the wiki.

If there are any issues please let me know either in the issue tracker or DM me on Discord at Scoin0#0002.