Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/stageguard/osumapsuggester

A OneBot bot that can provide osu!std players some appropriate beatmap (WIP)
https://github.com/stageguard/osumapsuggester

bot java kotlin osu osugame

Last synced: 19 days ago
JSON representation

A OneBot bot that can provide osu!std players some appropriate beatmap (WIP)

Host: GitHub
URL: https://github.com/stageguard/osumapsuggester
Owner: StageGuard
License: agpl-3.0
Created: 2021-07-16T17:10:54.000Z (over 3 years ago)
Default Branch: main
Last Pushed: 2024-07-01T15:50:36.000Z (5 months ago)
Last Synced: 2024-10-14T13:58:24.720Z (about 1 month ago)
Topics: bot, java, kotlin, osu, osugame
Language: Kotlin
Homepage:
Size: 10.3 MB
Stars: 30
Watchers: 2
Forks: 3
Open Issues: 8
Metadata Files:
- Readme: README-en.md
- License: LICENSE

Awesome Lists containing this project

README

# OsuMapSuggester

A [mirai-console](https://github.com/mamoe/mirai-console) plugin that can provide **osu!std** players some appropriate beatmap. (WIP)

[![CI](https://github.com/StageGuard/OsuMapSuggester/actions/workflows/build.yml/badge.svg)](https://github.com/StageGuard/OsuMapSuggester/actions/workflows/build.yml) [![CodeFactor](https://www.codefactor.io/repository/github/stageguard/osumapsuggester/badge/main)](https://www.codefactor.io/repository/github/stageguard/osumapsuggester/overview/main)

Develop roadmap：[#1](https://github.com/StageGuard/OsuMapSuggester/issues/1)

## Features

It can analyze player's **aim**, **speed** and **accuracy** skills of his best performances and [PerformancePlus](https://syrin.me/pp+/) and other factors to infer what type of the player he is.

Then it can recommend specific beatmap for his shortcomings or other kind of beatmap.(not implemented)

Users can also define custom ruleset of beatmap type via [these properties](https://github.com/StageGuard/OsuMapSuggester/blob/main/src/main/kotlin/me/stageguard/obms/database/model/BeatmapSkill.dao.kt#L22) using JavaScript expression.

There are other features:

- [x] Analyze player's skills(main function).
- [x] Recommend specific beatmap(main function).
- [x] Show your best performance picture.
- [x] Best performance versus.
- [x] Recalculate the best performance if all full combo.
- [x] Show your skill attributes.
- [x] query your recent score
- [ ] ...

## How plugin process OAuth request and bind account

When users click OAuth link and confirm authorization. It will redirect to your callback URL with query parameters `state` and `code`.

The OsuMapSuggester plugin will open a frontend http server to process the parameters.

## Deploy

It is easy to deploy this bot.

#### Preparation:

- A **MySQL** or **MariaDB** database, create a database for this plugin.

- A server with public IP.

- Mirai console runtime environment.
Learn how to setup mirai console: https://github.com/mamoe/mirai/blob/dev/docs/UserManual.md

- osu! OAuth Application
1. Go to https://osu.ppy.sh/home/account/edit

2. Click New OAuth Application

new_oauth_app_button

3. Set Application Callback URL to http://<your server ip or domain name>:port/authCallback

4. Copy Client Id and Client Secret.

oauth

- osu! v1 api key
Request a new v1 api key: https://osu.ppy.sh/p/api/

#### Run:

1. Clone this project with submodule (`git clone --recurse-submodules`) and open with IntelliJ IDEA. Sync gradle project and run `mirai/buildPlugin` task to build the plugin binary file.

> You can also build via command line by running `chmod +x gradlew && ./gradlew buildPlugin` command if your IntelliJ IDEA is not installed. The output binary file is in `build/mirai`.

2. Copy the output in `build/mirai/OsuMapSuggester-xxx.mirai.jar` to `/plugins/` folder, and start mirai console once, you may get this error log:

```
2021-07-26 20:22:37 E/OsuMapSuggester: Failed to connect database: com.zaxxer.hikari.pool.HikariPool$PoolInitializationException: Failed to initialize pool: Access denied for user 'root'@'localhost' (using password: YES).
2021-07-26 20:22:37 E/OsuMapSuggester: Retry to connect database in 10 seconds.
```

3. Close mirai console, edit `config/OsuMapSuggester/OsuMapSuggester.Config.yml`

```yaml
qq: 1234567890 # Enable the plugin for this bot
database:
address: localhost # Your database address
port: 3306 # Database port
user: root # Database user
password: testpwd # Database password
table: osu!beatmap suggester # Database name
maximumPoolSize: 10
osuAuth:
clientId: 0 # The OAuth application client id you just created.
secret: '' # OAuth application client secret
authCallbackBaseUrl: 'http://localhost:8081' # callback base url, it is for generating OAuth link when users bind qq account, must be same with OAuth application callback base url(no "/authCallback").
v1ApiKey: '' # your v1 api key
frontend: # frontend is used to process oauth application callback
host: localhost # frontend host
port: 8081 # frontend port
```

4. Save config, rerun mirai console. If you see this log, it means everything works ok.

```
2021-07-26 20:34:27 I/OsuMapSuggester: Subscribed group and friend messages.
```

## Issues

This project is still working in progress, it is unstable and there are still many bugs.

If you suffer from fatal bug when running bot, please open an issue with `bug` to feedback.

Also, if you have any good idea, welcome to contribute to this project or open an issue with `feature` label.

## Library

- Mirai Framework: [mirai](https://github.com/mamoe/mirai/), [mirai-console](https://github.com/mamoe/mirai-console), [mirai-slf4j-bridge](https://github.com/project-mirai/mirai-slf4j-bridge)
- Database: [Ktorm](https://github.com/kotlin-orm/ktorm), [HikariCP](https://github.com/brettwooldridge/HikariCP)
- Web Server: [ktor](https://github.com/ktorio/ktor)
- Graphics: [skija](https://github.com/JetBrains/skija)
- osu! Related: [peace-performance](https://github.com/Pure-Peace/peace-performance), [pp+ algorithm](https://github.com/Syriiin/osu), [osuReplayAnalyzer](https://github.com/firedigger/osuReplayAnalyzer)
- Utilities: apache utilities(commons-io, commons-math3, commons-compress), [xz](https://tukaani.org/xz/java.html)

## LICENSE of this project and mirai

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
```

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
```