AuthWithQq

# AuthWithQq <p align="center"> <img src="https://img.shields.io/github/v/release/Cc-Cece/AuthwithQQ_plugin?include_prereleases&style=for-the-badge&color=orange&label=BETA" alt="Beta Release"> <img src="https://img.shields.io/badge/Java-21+-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white" alt="Java"> <img src="https://img.shields.io/badge/Paper-1.20%20+-FF9100?style=for-the-badge&logo=minecraft&logoColor=white" alt="Paper"> <img src="https://img.shields.io/github/license/Cc-Cece/AuthwithQQ_plugin?style=for-the-badge&color=green" alt="License"> </p> <p align="center"> <a href="https://github.com/Cc-Cece/AuthwithQQ_plugin/releases/latest"> <img src="https://img.shields.io/badge/📥_Download-blue?style=flat-square&logo=github" alt="Download"> </a> <a href="#-installation"> <img src="https://img.shields.io/badge/🚀_Setup-Config-brightgreen?style=flat-square" alt="install"> </a> <a href="https://github.com/Cc-Cece/AuthwithQQ_plugin/issues"> <img src="https://img.shields.io/badge/🐞_Feedback-Issues-red?style=flat-square" alt="Issues"> </a> </p> --- ## 🌍 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 (https://github.com/cc_cece/AuthWithQq/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. 从 (https://github.com/cc_cece/AuthWithQq/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 | 解除绑定关系 | --- <p align="right">Made with ❤️ by Cc_Cece</p>