AuthWithQq
🌍 English Description
AuthWithQq is an all-in-one QQ authentication plugin designed for Paper servers. It requires players to bind their QQ accounts before playing, significantly enhancing server security and community engagement.
✨ Features
- 🔐 Secure Binding: Supports verification codes, one-click web binding, multi-account limits per QQ, and mandatory group membership checks.
- 🌐 Web Services: Built-in HTTP service providing player profiles and an admin dashboard with customizable ports.
- 🤖 OneBot v11: Reverse WebSocket integration allows users to bind, unbind, and query accounts directly via QQ groups or private messages.
- 👤 Guest Mode: Restricts movement, interaction, and teleportation for unverified players. Supports custom allowed commands and potion effects.
- 👤 Bot/Dummy Support: Allows legitimate players to bind multiple bots (dummies) with name prefix validation.
- 🌍 Multi-language: Native support for English, Simplified Chinese, and Traditional Chinese.
📥 Requirements
- Java: JDK 21+
- Server: Paper 1.20.x, 1.20.5+, or 1.21.x
🚀 Installation
- Download the latest
AuthWithQq-xxx.jar from Releases.
- Place the JAR file into your server's
plugins/ folder.
- Restart the server. The plugin will automatically generate the
plugins/AuthWithQq/ configuration and language files.
🏮 中文说明
AuthWithQq 是一款面向 Paper 服务端的一体化 QQ 认证插件。玩家需绑定 QQ 后才能正常游戏，有效提升服务器安全性与玩家社交联络。
✨ 功能概览
- 🔐 安全绑定：支持验证码绑定、网页一键绑定；支持一 QQ 多账号限制及强制入群校验。
- 🌐 网页服务：内置 HTTP 服务，提供玩家资料页与管理后台，支持自定义端口。
- 🤖 OneBot v11：反向 WebSocket 接入，支持在 QQ 群/私聊中执行绑定、解绑、查询等指令。
- 👤 游客模式：未绑定玩家将被限制移动、交互、跨世界传送，可自定义允许的命令与药水效果。
- 🤖 假人支持：允许真实玩家绑定多个假人（Bot），支持名称前缀校验。
- 🌍 多语言：原生支持简体中文、繁体中文及英文。
📥 环境要求
| 组件 |
最低要求 |
推荐版本 |
| Java |
JDK 21+ |
JDK 21 |
| 服务端 |
Paper 1.20+ |
1.20.5+ / 1.21.x |
🚀 安装步骤
- 从 Releases 下载最新的
AuthWithQq-xxx.jar。
- 将 JAR 文件放入服务器的
plugins/ 目录。
- 重启服务器，插件会自动生成配置文件及语言文件。
📜 Commands / 命令手册
| Command / 命令 |
Description (EN) |
说明 (CN) |
/bind |
Get verification code / Bind bots |
获取验证码 / 绑定假人 |
/auth reload |
Reload configuration |
重载插件配置 |
/auth bind <Player> <QQ> |
Force manual binding |
强制手动绑定 |
/auth unbind <Player> |
Unbind a player |
解除绑定关系 |
Made with ❤️ by Cc_Cece
