
client key login
authenticate to servers using cryptography instead of Mojang account
Screenshots


About this Mod
client key login
i don't have the energy to keep this mod updated all the time, but if you want it ported to a specific minecraft version, please contact me and i'll try my best to do that for you :3
this is unstable and potentially broken! so it might break in unexpected ways! if you find a problem, please send me full details of the error so i can fix it
uses public key cryptography to authenticate to servers instead of going via Mojang's account service (yggdrasil)
features
- customise your profile extensively with the identity manager (see gallery)
- create new identities (like accounts) in seconds and switch between them even faster
- use custom skins and capes, hosted on any website (for example you can put an image URL directly linking to NameMC or similar sites)
- continue to use protocol encryption when Mojang is offline
- protection from profile stealing: your UUID is derived from your keypair, which means your player data on the server is linked to the secret on your computer, and the only way to access your player data is to have that secret (or be the server admin)
- "identity theft": clone skin and cape textures from an existing Mojang account
- you can still join vanilla servers with the mod installed - it will just use your regular account instead of a client-key identity
known incompatibilities
- LuckPerms (and possibly other permission mods): expects the UUID associated with a given username to never change, so it may work but will probably break if you use the same name as a previous login under a different identity, or if you use the same name as your Mojang account after previously logging in with that
- any proxies that don't understand the custom protocol (i.e. BungeeCord, Velocity, Waterfall, …)
notes
- by some mysterious stroke of luck, this mod is compatible with Floodgate (from Geyser)! so you can use Bedrock accounts and custom identities and Mojang accounts all at the same time if you really want to
- if you delete an identity with some associated player data, that data is not gone but is no longer accessible and you will have to ask the server admin to transfer it to your new identity (admins: this is as simple as renaming the
.datfile underworld/playerdatato the new UUID) - if you join a server with a regular Mojang account, but then change to using a client key identity, you will not have the same player data and might need to transfer it as above
- does not remove any attempts to contact Mojang, so you should still be able to join vanilla servers (as long as you're logged in to Minecraft)
check the project readme for more information on server-side configuration, and technical details
Available Versions
How to Install client key login on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "client key login". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.21, 1.20.6 (+4 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
client key login server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is client key login compatible with fabric?
client key login officially supports fabric for Minecraft 1.21.1, 1.21, 1.20.6. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with client key login – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if client key login consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install client key login with just one click on your server.