OpenQQAuth
by Nmou_Zh
OpenQQAuth lets a Minecraft server tie player accounts to QQ, with login methods that cover Java and Bedrock players on a Velocity proxy.
What it does
Players log in through a graphical gate of dialog screens, virtual chest menus or a virtual anvil for password input, depending on the client version. The mod runs on a Velocity proxy and keeps players isolated behind that gate until their identity is verified, after which they reach the backend Paper server. A QQ account ownership credential is mandatory, and three login methods are supported: offline password login, premium fast login with an encrypted handshake and hasJoined verification, and Bedrock login through Microsoft account identity with Floodgate.
Token entry works on both loaders: once a QQ group bot sends a credential, the player pastes it into the Connect with Token screen and gets passwordless entry for 30 days. That token can be revoked at any time. Bot-based offline accounts cannot bind. OpenQQAuth is not open source and is released under a custom license. Its files cover 1.12 – 26.2, with 1.0.0 as the latest Fabric and NeoForge file.
Key features
QQ-bound accounts
Each account is bound to a QQ identity, and passwordless login works after the binding is made.
Admin command set
Commands bind, ban, exec, check, transfer, reload and reconnect are logged to CommandAuditLog before and after execution.
Proxy-side configuration
Settings are read from a single file and loaded through Configurate, so the proxy holds the whole setup.
Java and Bedrock inheritance
A Java account's data can be inherited, and Bedrock players can sign in with a Microsoft account.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Who it’s for: Server owners running a Velocity proxy in front of Paper backends who want QQ-based account ownership and mixed Java and Bedrock logins.
How it compares
MixAuth is server-side only, open source under the GNU Lesser General Public License v3.0 only and built for NeoForge 1.21.1 – 26.3. Simple Discord Auth is server-side only, released under All rights reserved and not open source, with files for Fabric 1.21.1 – 1.21.11. SafeAuth is client-side only, released under the MIT License and not open source, with files for Fabric, Forge, NeoForge and Quilt across 1.16.5 – 26.2.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| OpenQQAuth | Fabric and NeoForge | 1.12 – 26.2 | Not published | 2026-08-14 |
| MixAuth | NeoForge | 1.21.1 – 26.3 | Server-side only | 2026-09-28 |
| Simple Discord Auth | Fabric | 1.21.1 – 1.21.11 | Server-side only | 2026-01-31 |
| SafeAuth | Fabric, Forge, NeoForge and Quilt | 1.16.5 – 26.2 | Client-side only | 2026-07-27 |
Questions
Does OpenQQAuth need Velocity?
Which loaders does OpenQQAuth support?
How do players log in without a password?
In the catalog
OpenQQAuth is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 13,894 mods support Minecraft 26.2.
More from Nmou_Zh
Similar mods
What the author says
QQ-driven login & account authentication system for Minecraft — an open-source MQE alternative and beyond. It also adds a login token system: after installing the Fabric / NeoForge dual-platform mod, players can click "Connect with Token" in the multiplayer screen and enter a credential privately sent by the QQ group…
Official listing
- Modrinth page
- modrinth.com/mod/openqqauth
- Owner
- Nmou_Zh
- Published
- 2026-08-09
- Updated on Modrinth
- 2026-08-14
- Facts verified
- 2026-10-15
