chuni penguin

Discord bot for CHUNITHM International version.

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

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)

and more...

Setup instructions

You can clone from either the develop branch or the trunk branch. Only the trunk branch is guaranteed to work at all commits.

0. Install uv
1. Copy bot.example.ini to bot.ini and fill in values based on the comments.
2. Run uv sync to install dependencies.
3. Run uv run python -m dbutils create to create the database.
4. Run uv 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. uv run launcher.py

Contributions

Pull requests are welcome. Please make them to the develop branch. Most bugfixes will be cherry-picked back to the trunk branch after I merge it.

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.

Thanks to all the people who have sponsored my work through Ko-fi and through direct donations:

• Tukkun
• @tadanahh