A leaderboard for Hack Club osu! players
Find a file
2024-10-29 19:56:51 -07:00
.gitignore initial commit 2024-06-30 10:18:57 +01:00
bun.lockb Update dependency @slack/bolt to v4 2024-10-29 19:56:51 -07:00
index.ts i used a timeout not an interval 😭 2024-09-03 16:55:50 +01:00
LICENSE Add MIT license 2024-09-23 20:31:23 +00:00
package.json Update dependency @slack/bolt to v4 2024-10-29 19:56:51 -07:00
README.md Update README.md 2024-08-29 23:28:44 +00:00
renovate.json configure renovate (#1) 2024-07-07 02:38:16 +00:00
tsconfig.json initial commit 2024-06-30 10:18:57 +01:00

osu! leaderboard

osu! leaderboard is a project I worked on for Hack Club's Arcade.
It allows for users to link their osu! account to their Slack accounts and view leaderboards for each ruleset (showing linked users), as well as search beatmaps and create invites to multiplayer matches all from Slack.

This currently runs in the Hack Club Slack in the #osu channel.

Commands

/osu-link: Starts the linking process.

/osu-leaderboard: Shows the leaderboard of all osu! users who are linked. This can be changed to show different rulesets via a dropdown.

/osu-profile <user>: Search for an osu! user or a Slack user and view (if any) the link between their accounts.

/osu-search: Opens a modal that allows you to filter for a beatmap.

/osu-multiplayer-invite: If you have linked your account, you can run this command to create a message to allow people to join an osu!lazer multiplayer room you create.

Setup

(Please note; a lot of this is hardcoded! You may need to change a few references in the code to whereever you're hosting the bot.)

  1. Clone the repo:
$ git clone https://git.haroon.hackclub.app/haroon/osu-leaderboard.git
  1. Create a .env file with the following format:
SLACK_BOT_TOKEN=<your slack bot token (xoxb)>
SLACK_SIGNING_SECRET=<your slack signing secret>
CLIENT_SECRET=<your osu! oauth app's client secret>
  1. Change the following hard-coded values (sorry!)
    a. lines 9-13: edit for your postgres installation

    b. line 76, 118, 152, 172: edit for your client ID and redirect URI

    c. line 262: edit to a linked user's slack ID (preferably yours)

    d. line 330, 443, 488, 598: edit the slack URL to your workspace's URL

    e. line 786, 787, 794, 800: edit to the URL where you're hosting the bot.

  2. Install packages, using your package manager of choice.

  3. Run index.ts using npx tsx ., not bun .! (Bolt likes to be funny when you're using Bun.)

  4. Voila!