Python 3.12+ ruff CodeFactor pre-commit.ci status license discord docs
English | 简体中文
g0v0-server is an osu!(lazer) server written in Python that supports the latest osu!(lazer) client and provides additional features (such as Relax/Autopilot Mod statistics and custom ruleset support).
g0v0-server is implemented based on osu! API v2 and is largely compatible with both osu! API v1 and v2. This means you can easily integrate existing osu! applications with g0v0-server.
Additionally, g0v0-server provides a set of g0v0! APIs to enable operations beyond the osu! API.
g0v0-server is not just a score server. It implements most of the features of the osu! website (such as chat, user settings, etc.).
We provide a demo server at https://lazer-api.g0v0.top (frontend at https://lazer.g0v0.top). You can experience g0v0-server's features through our demo server.
- Supports the latest osu!(lazer) client
- Supports Relax/Autopilot Mod statistics
- Supports custom rulesets
- Supports plugins, allowing developers to add new features to the server
- Supports Docker deployment
| Ruleset | ID | ShortName | PP Algorithm (rosu) | PP Algorithm (performance-server) |
|---|---|---|---|---|
| osu! | 0 |
osu |
✅ | ✅ |
| osu!taiko | 1 |
taiko |
✅ | ✅ |
| osu!catch | 2 |
fruits |
✅ | ✅ |
| osu!mania | 3 |
mania |
✅ | ✅ |
| osu! (RX) | 4 |
osurx |
✅ | ✅ |
| osu! (AP) | 5 |
osuap |
✅ | ✅ |
| osu!taiko (RX) | 6 |
taikorx |
✅ | ✅ |
| osu!catch (RX) | 7 |
fruitsrx |
✅ | ✅ |
| Sentakki | 10 |
Sentakki |
❌ | ❌ |
| tau | 11 |
tau |
❌ | ✅ |
| Rush! | 12 |
rush |
❌ | ❌ |
| hishigata | 13 |
hishigata |
❌ | ❌ |
| soyokaze! | 14 |
soyokaze |
❌ | ✅ |
Visit custom-rulesets to download custom rulesets modified for g0v0-server.
Visit https://docs.g0v0.top/ for more information.
g0v0-server supports plugins, allowing developers to add new features to the server. See Managing Plugins to install plugins, and see the Plugin Development Guide to develop plugins.
Use openssl rand -hex 32 to generate the JWT secret key to ensure server security and proper operation of the spectator server.
Use openssl rand -hex 40 to generate the frontend secret key.
If running in a public network environment, please block external requests to the /_lio path.
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only).
Any derivative work, modification, or deployment MUST clearly and prominently attribute the original authors:
GooGuTeam - https://github.com/GooGuTeam/g0v0-server
The project is currently in a state of rapid iteration. Issues and Pull Requests are welcome!
See Contributing Guide for more information.
Thanks to all the contributors to this project! (emoji key)
This project follows the all-contributors specification. Contributions of any kind are welcome!
- Discord: https://discord.gg/AhzJXXWYfF
- QQ Group:
1059561526