Drasl is an alternative API server for Minecraft that handles authentication, skins, capes, and more. You can use it to host Minecraft servers that are completely independent from Mojang's infrastructure. It's compatible with both authlib-injector and the vanilla Yggdrasil protocol, which means it supports a wide variety of Minecraft launchers, including Prism Launcher (if this pull request gets merged), HMCL, and UltimMC. It includes a minimalist web front end for registering and managing accounts.
You've always been able to host your own Minecraft server, but unless you run the server in offline mode, authentication and skins are usually still handled by Mojang's API servers. There are many reasons to host your own API server instead of using Mojang's. Your community might want to:
- Experience the benefits of offline servers without losing skins, encrypted connections, or account security
- Create additional accounts to allow users to have multiple players logged in to a server simultaneously
- Have a "camera account" spectate your character for content creation
- Program bots to automate tedious tasks like AFKing, crafting, or even building map art.
- Have skins with transparency, or high-resolution skins (this would require a modded client as well)
- Play Minecraft in a country or on a network where Mojang's servers are inaccessible
- Keep your activity private from Mojang. Mojang knows which servers you are active on, when you log on, who else is on those servers, etc. If telemetry is enabled (since 1.18, it cannot be disabled without a mod), they are also notified whenever you load a singleplayer world.
- Support players that don't have a Microsoft account
- Serve access tokens that last longer, so you don't run into "Invalid session" errors as often. These errors can be annoying with modpacks that take a long time to restart.
- Opt out of chat reporting
- Have a backup authentication system in case Mojang's servers go down
- Easy to host: a single Go binary plus a few static assets, no runtime dependencies
- Highly configurable
- Fast, minimalist, and highly-accessible web interface
- Optional: proxy requests to fallback API servers (see FallbackAPIServers)
- You can configure your Minecraft server to accept users logged in with either a Mojang account or a Drasl account.
- Optional: disable access token and public key expiry (no more "Invalid session" or "Invalid signature for profile public key")
- Optional: sign player public keys to support chat signing and
enforce-secure-profile=true(see SignPublicKeys) - Optional: allow high-resolution skins (see SkinSizeLimit)
- Optional: allow registering from existing account an another API server (i.e. Mojang's) (see RegistrationExistingPlayer)
- Useful if you want to keep your UUID
- Optional: require a skin challenge to verify ownership of the existing account (see RequireSkinVerification)
- When not using authlib-injector, skins won't appear in game, since the Minecraft client verifies that skin data is signed by Mojang and only allows skins from Mojang domains. You can use the DraslTweaks mod to bypass these checks and get skins working.
If using Nix, simply run nix build.
Otherwise, install build dependencies:
sudo apt install -y make golang nodejs npm # Debian
sudo dnf install -y make go nodejs npm # Fedora
sudo pacman -S make go nodejs npm # Arch Linux
Then build the program with:
make
Run the tests with:
go test
- Blessing Skin with the yggdrasil-api plugin
- Ely.by
Why GPL and not AGPL? Isn't this a web application?
Drasl is intended to be self-hosted, customized, and hacked on. If it were licensed under the GNU Affero GPL, any user who tweaks their instance even slightly would be required to publish the changes, or else they would be violating the AGPL. While I'm a strong believer in copyleft, I don't want to place such a burden on the users in this particular case.