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

* 🌍 Multi-language: Supports verification codes, one-click web binding, multi-account limits per QQ, and mandatory group membership checks. * 🌍 Multi-language: Built-in HTTP service providing player profiles and an admin dashboard with customizable ports. * 🌍 Multi-language: Reverse WebSocket integration allows users to bind, unbind, and query accounts directly via QQ groups or private messages. * 🌍 Multi-language: Restricts movement, interaction, and teleportation for unverified players. Supports custom allowed commands and potion effects. * 🌍 Multi-language: Allows legitimate players to bind multiple bots (dummies) with name prefix validation. * 🌍 Multi-language: Native support for English, Simplified Chinese, and Traditional Chinese.

📥 Requirements

* Server: 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 服务，提供玩家资料页与管理后台，支持自定义端口。 * 🌍 多语言：反向 WebSocket 接入，支持在 QQ 群/私聊中执行绑定、解绑、查询等指令。 * 🌍 多语言：未绑定玩家将被限制移动、交互、跨世界传送，可自定义允许的命令与药水效果。 * 🌍 多语言：允许真实玩家绑定多个假人（Bot），支持名称前缀校验。 * 🌍 多语言：原生支持简体中文、繁体中文及英文。

📥 环境要求

| 组件 | 最低要求 | 推荐版本 | | :--- | :--- | :--- | | 服务端 | 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 | 解除绑定关系 |

--- <p align="right">Made with ❤️ by Cc_Cece</p>