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)
咕谷酱 💻 |
MingxuanGame 💻 |
陈晋瑭 💻 |
4ayo 🤔 |
kyiuu1 🤔 |
复予 💻 |
Shikkesora 🐛 |
This project follows the all-contributors specification. Contributions of any kind are welcome!
- Discord: https://discord.gg/AhzJXXWYfF
- QQ Group:
1059561526