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

1. Download the latest AuthWithQq-xxx.jar from Releases.
2. Place the JAR file into your server's plugins/ folder.
3. 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

🚀 安装步骤

1. 从 Releases 下载最新的 AuthWithQq-xxx.jar。
2. 将 JAR 文件放入服务器的 plugins/ 目录。
3. 重启服务器，插件会自动生成配置文件及语言文件。

---

📜 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