chuni penguin

Discord bot for CHUNITHM International version.

I have a hosted instance that you can invite here, though uptime is sometimes flaky.

Notice

I will not be actively developing the bot anymore. There's not much left I think the bot actually needs, and my motivation has been slowly waning to implement them. I'll still fix any reported bugs and review any PRs.

Features

• Player data
• Recent scores (including detailed judgements)
• Best scores
  • b30 and recent 10
  • by song
• Comparing scores
• Song information
  • sdvx.in integration
• Search tracks by internal level
• Calculate play rating
• Slash command support
• Minigames (song quiz)

Setup instructions

0. Install Rye
1. Copy bot.example.ini to bot.ini and fill in values based on the comments.
2. Run rye sync to install dependencies.
3. Run python -m dbutils create to create the database. You may need to activate the virtualenv first if you had a previous Python installation not managed by rye.
4. Run python -m dbutils update chunirec to populate the song database. For this to work, credentials.chunirec_token must be set in bot.ini. A pre-populated database is also provided here, for your convenience.
5. python bot.py

Credits

Thanks to these projects for making this bot possible and less miserable to make:

• Chunirec DB from chunirec
• arcade-songs from Raku Zeta
• CHUNITHM song alias list from lomotos10
• Tukkun for breaking my bot in unthinkable ways (aside from being a contributor), as well as taking the time to add all the song aliases.

Thanks to all the contributors who took part.

Donation

chuni-penguin is entirely free (as in both free beer and free speech), but you can monetarily support its development by donating through Ko-fi or directly if you live in Vietnam:

• Bank: Vietcombank
• Account: beerpsi

Thank you to everyone who donated:

• Tukkun