Connect to the Server from the osu!(lazer) Client

The osu!(lazer) client does not natively support connecting to a server via command line (-devserver) like osu!(stable). Therefore, to connect to your server, you need to use a custom osu!(lazer) client modified by us—osu! GU, or use LazerAuthlibInjection to inject the connection configuration into the client.

Using osu! GU

This method is recommended for all users who can run osu!(lazer) on their platform.

Steps

1. Download osu! GU

   Download the latest version from GitHub Releases.

2. Configure the Server URL

   In the osu!(lazer) settings, find the "Online" section, locate the "Custom API Server URL" setting, and enter your server address in the input field (e.g., lazer-api.g0v0.top).

   

3. Restart the Client

   After entering the URL, exit osu!(lazer) and restart it for the changes to take effect.

Using LazerAuthlibInjection

LazerAuthlibInjection is a ruleset that adds custom server support to the official osu!(lazer) client.

Warning

Although we have not found any bans caused by using this ruleset, we recommend that you do not connect the osu!(lazer) client with LazerAuthlibInjection installed to the official servers!

This project is not affiliated with or endorsed by the official osu! team. Use at your own risk. Do not report any issues regarding this ruleset to the official osu! team.

Supported Platforms

• Linux (amd64, arm64)
• Windows (amd64, arm64)
• macOS (Intel, Apple Silicon)

Installation Steps

1. Open the osu! Data Directory

   In the settings panel, click Open osu! folder to open the osu! data directory.

   Default locations:

   • Windows: %AppData%\osu!
   • Linux: ~/.local/share/osu
   • macOS: ~/Library/Application Support/osu

2. Install LazerAuthlibInjection

   Download the latest version from the Releases page, and copy osu.Game.Rulesets.AuthlibInjection.dll to the rulesets directory.

3. Configure LazerAuthlibInjection

   In the settings panel, click Rulesets, then configure:

   • API Url: Your custom server API URL (e.g., https://lazer-api.g0v0.top)
   • Website Url: Your custom server website URL (e.g., https://lazer.g0v0.top)

   Then click Save Changes to save the settings.

   

4. Restart the Client

   Restart osu!(lazer) for the configuration to take effect.

Command Line Arguments

You can also pass settings via command line arguments:

Argument	Description
--api-url / -devserver	API URL
--website-url	Website URL
--client-id	Client ID
--client-secret	Client Secret
--spectator-url	Spectator service URL
--multiplayer-url	Multiplayer service URL
--metadata-url	Metadata service URL
--bss-url	Beatmap submission service URL
--disable-sentry-logger	Disable sending Sentry logs to the official osu! servers
--non-g0v0-server	Disable g0v0-server specific features (Relax, custom ruleset scores)

Example:

osu!.exe --api-url=lazer-api.g0v0.top --website-url=lazer.g0v0.top --disable-sentry-logger